i `SrSSKrSSKJrJrJr SSKJr SSKJrJ r J r J r SSK J r Jr SSKJr S\\\4S \4S jrS \\\4S \4S jrSS \\\4S \S \4SjjrS\ \S\S \ \4SjrS\ S \ 4SjrS\ \S \ \4SjrS\S \ \\\\\44SjrS\S \4SjrSS\S\S \4Sjjrg)z Utilities related to conversion.N)datetime timedeltatimezone)ceil)UnionTupleAnyOptional)tzparser)IBMInputValueErrorutc_dtreturnc[U[5(a[R"U5n[U[5(d [ S5eUR [RS9nUR[R"55nU$)zConvert a UTC ``datetime`` object or string to a local timezone ``datetime``. Args: utc_dt: Input UTC `datetime` or string. Returns: A ``datetime`` with the local timezone. Raises: TypeError: If the input parameter value is not valid. z)Input `utc_dt` is not string or datetime.tzinfo) isinstancestrr parser TypeErrorreplacerutc astimezoner tzlocal)rlocal_dts ]/home/james-whalen/.local/lib/python3.13/site-packages/qiskit_ibm_runtime/utils/converters.py utc_to_localrsg&#f% fh ' 'CDD ^^8<<^ 0F  .H Orcz[U[5(a[R"U5n[U[5(d [ S5eUR 5bUR 5[S5:waAUR[R"5S9nUR[R5$U$)zConvert a local ``datetime`` object or string to a UTC ``datetime``. Args: local_dt: Input local ``datetime`` or string. Returns: A ``datetime`` in UTC. Raises: TypeError: If the input parameter value is not valid. z+Input `local_dt` is not string or datetime.rr) rrr rrr utcoffsetrrr rrUTC)rs r local_to_utcr"-s(C  <<) h ) )EFF#x'9'9';y|'K##2::<#8""266** Orsuffixch[U5R5nUS:XaURSS5nU$)aConvert a local ``datetime`` object or string to a UTC string. Args: local_dt: Input local ``datetime`` or string. suffix: ``Z`` or ``+``, indicating whether the suffix should be ``Z`` or ``+00:00``. Returns: UTC datetime in ISO format. Zz+00:00)r" isoformatr)rr# utc_dt_strs rlocal_to_utc_strr(Es6h'113J }''#6 rinput_dtto_utccDUcgU(a [U5$[U5$)zConvert input timestamp timezone. Args: input_dt: Timestamp to be converted. to_utc: True if to convert to UTC, otherwise to local timezone. Returns: Converted timestamp, or ``None`` if input is ``None``. N)r"r)r)r*s r convert_tzr,Vs& H%%  !!rdatacF[U[5(a [U5$[U[5(aUVs/sHn[ U5PM sn$[U[ 5(a/UR 5VVs0sHup!U[ U5_M snn$U$s snfs snnf)zRecursively convert all ``datetime`` in the input data from local time to UTC. Note: Only lists and dictionaries are traversed. Args: data: Data to be converted. Returns: Converted data. )rrrlistutc_to_local_alldictitems)r-elemkeys rr0r0gs$!!D!! D$  37844 &488 D$  =AZZ\J\ %d++\JJ K9Js B:BcxU(dg[R"U5nUR[RS9$)zConvert a UTC string to a ``datetime`` object with UTC timezone. Args: utc_dt: Input UTC string in ISO format. Returns: A ``datetime`` with the UTC timezone, or ``None`` if the input is ``None``. Nr)r isoparserrr)r parsed_dts r str_to_utcr8|s0 'I   HLL  11rsecondsc[US-5n[US-S-5n[US-S-5nUS-nSnUS:a[[US-55nSnO [U5nXX0U4$)zConverts seconds in a datetime delta to a duration. Args: seconds: Number of seconds in time delta. Returns: A tuple containing the duration in terms of days, hours, minutes, seconds, and milliseconds. Q<ri)intr)r9dayshoursminutesmillisecs rseconds_to_durationrEs| w9% &D DB& 'E7b=B&'GlGH{tGdN+,g, ( 22r date_timec$URSS9[R"5- n[UR 55nSnUS(a0USR US5- nUSR US5- nU$US(a0USR US5- nUS R US 5- nU$US (a0US R US 5- nUS R US 5- nU$US (aUSR US 5- nU$)zCompute the estimated duration until the given datetime. Args: date_time: The input local datetime. Returns: String giving the estimated duration. Nrrz{} daysz {} hrsr?z{} hrsz {} minz{} minz {} secz{} sec)rrnowrE total_secondsformat)rF time_delta time_tupletime_strs rduration_differencerQs!""$"/(,,.@J$Z%=%=%?@JH!}I$$Z]33I$$Z]33 O AHOOJqM22I$$Z]33 O AHOOJqM22I$$Z]33 O AHOOJqM22 Orhms msg_prefixc,[R"SU5nSnU(aeUH]nUSn[USS5nUS:Xa X6S-- nM%US:Xa X6S-- nM4US :Xa X6S -- nMCUS :XaX6- nMO[US U35e U$[US U35e) aSConvert duration specified as hours minutes seconds to seconds. Args: hms: The string input duration (in hours minutes seconds). Ex: 2h 10m 20s msg_prefix: Additional message to prefix the error. Returns: Total seconds (int) in the duration. Raises: IBMInputValueError: when the given hms string is in an invalid format z (\d+[dhms])rNdr;hr<mr>sz Invalid input: )refindallr@r )rRrS parsed_timerL time_unitunitvalues rhms_to_secondsr`s**^S1KM$IR=D #2'Es{. - + & (J<7Gv)NOO% !Jris ' 22..<x}-(*53/H0uXs]3S3""(+"T"hx>P""33* 2x} 2(); 2335c3S1H+I3.88"""c"r