hǥ8SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK J r SSK J r JrJrJrJrJrJrJrJrJr SSKr\ (aSSKJr SSKJr SSKJr S r\"S S S 9r\"S 5r \"S5r!\RD"\#5r$"SS5r%"SS\%5r&"SS\%5r'"SS\'5r("SS\(5r)"SS\RT5r+"SS\\,\,45r-S%Sjr.S%Sjr/S&Sjr0"S S!5r1\1"5r2S'S"jr3"S#S$\\\!45r4g)(uU# win32timezone: Module for handling datetime.tzinfo time zones using the windows registry for time zone information. The time zone names are dependent on the registry entries defined by the operating system. This module may be tested using the doctest module. Written by Jason R. Coombs (jaraco@jaraco.com). Copyright © 2003-2012. All Rights Reserved. This module is licensed for use in Mark Hammond's pywin32 library under the same terms as the pywin32 library. To use this time zone module with the datetime module, simply pass the TimeZoneInfo object to the datetime constructor. For example, >>> import win32timezone, datetime >>> assert 'Mountain Standard Time' in win32timezone.TimeZoneInfo.get_sorted_time_zone_names() >>> MST = win32timezone.TimeZoneInfo('Mountain Standard Time') >>> now = datetime.datetime.now(MST) The now object is now a time-zone aware object, and daylight savings- aware methods may be called on it. >>> now.utcoffset() in (datetime.timedelta(-1, 61200), datetime.timedelta(-1, 64800)) True (note that the result of utcoffset call will be different based on when now was generated, unless standard time is always used) >>> now = datetime.datetime.now(win32timezone.TimeZoneInfo('Mountain Standard Time', True)) >>> now.utcoffset() datetime.timedelta(days=-1, seconds=61200) >>> aug2 = datetime.datetime(2003, 8, 2, tzinfo = MST) >>> tuple(aug2.utctimetuple()) (2003, 8, 2, 6, 0, 0, 5, 214, 0) >>> nov2 = datetime.datetime(2003, 11, 25, tzinfo = MST) >>> tuple(nov2.utctimetuple()) (2003, 11, 25, 7, 0, 0, 1, 329, 0) To convert from one timezone to another, just use the astimezone method. >>> aug2.isoformat() '2003-08-02T00:00:00-06:00' >>> aug2est = aug2.astimezone(win32timezone.TimeZoneInfo('Eastern Standard Time')) >>> aug2est.isoformat() '2003-08-02T02:00:00-04:00' calling the displayName member will return the display name as set in the registry. >>> est = win32timezone.TimeZoneInfo('Eastern Standard Time') >>> str(est.displayName) '(UTC-05:00) Eastern Time (US & Canada)' >>> gmt = win32timezone.TimeZoneInfo('GMT Standard Time', True) >>> str(gmt.displayName) '(UTC+00:00) Dublin, Edinburgh, Lisbon, London' To get the complete list of available time zone keys, >>> zones = win32timezone.TimeZoneInfo.get_all_time_zones() If you want to get them in an order that's sorted longitudinally >>> zones = win32timezone.TimeZoneInfo.get_sorted_time_zones() TimeZoneInfo now supports being pickled and comparison >>> import pickle >>> tz = win32timezone.TimeZoneInfo('China Standard Time') >>> tz == pickle.loads(pickle.dumps(tz)) True It's possible to construct a TimeZoneInfo from a TimeZoneDescription including the currently-defined zone. >>> code, info = win32timezone.TimeZoneDefinition.current() >>> tz = win32timezone.TimeZoneInfo(info, not code) >>> tz == pickle.loads(pickle.dumps(tz)) True Although it's easier to use TimeZoneInfo.local() to get the local info >>> tz == TimeZoneInfo.local() True >>> aest = win32timezone.TimeZoneInfo('AUS Eastern Standard Time') >>> est = win32timezone.TimeZoneInfo('E. Australia Standard Time') >>> dt = datetime.datetime(2006, 11, 11, 1, 0, 0, tzinfo = aest) >>> estdt = dt.astimezone(est) >>> estdt.strftime('%Y-%m-%d %H:%M:%S') '2006-11-11 00:00:00' >>> dt = datetime.datetime(2007, 1, 12, 1, 0, 0, tzinfo = aest) >>> estdt = dt.astimezone(est) >>> estdt.strftime('%Y-%m-%d %H:%M:%S') '2007-01-12 00:00:00' >>> dt = datetime.datetime(2007, 6, 13, 1, 0, 0, tzinfo = aest) >>> estdt = dt.astimezone(est) >>> estdt.strftime('%Y-%m-%d %H:%M:%S') '2007-06-13 01:00:00' Microsoft now has a patch for handling time zones in 2007 (see https://learn.microsoft.com/en-us/troubleshoot/windows-client/system-management-components/daylight-saving-time-help-support) As a result, patched systems will give an incorrect result for dates prior to the designated year except for Vista and its successors, which have dynamic time zone support. >>> nov2_pre_change = datetime.datetime(2003, 11, 2, tzinfo = MST) >>> old_response = (2003, 11, 2, 7, 0, 0, 6, 306, 0) >>> incorrect_patch_response = (2003, 11, 2, 6, 0, 0, 6, 306, 0) >>> pre_response = nov2_pre_change.utctimetuple() >>> pre_response in (old_response, incorrect_patch_response) True Furthermore, unpatched systems pre-Vista will give an incorrect result for dates after 2007. >>> nov2_post_change = datetime.datetime(2007, 11, 2, tzinfo = MST) >>> incorrect_unpatched_response = (2007, 11, 2, 7, 0, 0, 4, 306, 0) >>> new_response = (2007, 11, 2, 6, 0, 0, 4, 306, 0) >>> post_response = nov2_post_change.utctimetuple() >>> post_response in (new_response, incorrect_unpatched_response) True There is a function you can call to get some capabilities of the time zone data. >>> caps = GetTZCapabilities() >>> isinstance(caps, dict) True >>> 'MissingTZPatch' in caps True >>> 'DynamicTZSupport' in caps True >>> both_dates_correct = (pre_response == old_response and post_response == new_response) >>> old_dates_wrong = (pre_response == incorrect_patch_response) >>> new_dates_wrong = (post_response == incorrect_unpatched_response) >>> caps['DynamicTZSupport'] == both_dates_correct True >>> (not caps['DynamicTZSupport'] and caps['MissingTZPatch']) == new_dates_wrong True >>> (not caps['DynamicTZSupport'] and not caps['MissingTZPatch']) == old_dates_wrong True This test helps ensure language support for unicode characters >>> x = TIME_ZONE_INFORMATION(0, 'français') Test conversion from one time zone to another at a DST boundary =============================================================== >>> tz_hi = TimeZoneInfo('Hawaiian Standard Time') >>> tz_pac = TimeZoneInfo('Pacific Standard Time') >>> time_before = datetime.datetime(2011, 11, 5, 15, 59, 59, tzinfo=tz_hi) >>> tz_hi.utcoffset(time_before) datetime.timedelta(days=-1, seconds=50400) >>> tz_hi.dst(time_before) datetime.timedelta(0) Hawaii doesn't need dynamic TZ info >>> getattr(tz_hi, 'dynamicInfo', None) Here's a time that gave some trouble as reported in #3523104 because one minute later, the equivalent UTC time changes from DST in the U.S. >>> dt_hi = datetime.datetime(2011, 11, 5, 15, 59, 59, 0, tzinfo=tz_hi) >>> dt_hi.timetuple() time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=15, tm_min=59, tm_sec=59, tm_wday=5, tm_yday=309, tm_isdst=0) >>> dt_hi.utctimetuple() time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=1, tm_min=59, tm_sec=59, tm_wday=6, tm_yday=310, tm_isdst=0) Convert the time to pacific time. >>> dt_pac = dt_hi.astimezone(tz_pac) >>> dt_pac.timetuple() time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=18, tm_min=59, tm_sec=59, tm_wday=5, tm_yday=309, tm_isdst=1) Notice that the UTC time is almost 2am. >>> dt_pac.utctimetuple() time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=1, tm_min=59, tm_sec=59, tm_wday=6, tm_yday=310, tm_isdst=0) Now do the same tests one minute later in Hawaii. >>> time_after = datetime.datetime(2011, 11, 5, 16, 0, 0, 0, tzinfo=tz_hi) >>> tz_hi.utcoffset(time_after) datetime.timedelta(days=-1, seconds=50400) >>> tz_hi.dst(time_before) datetime.timedelta(0) >>> dt_hi = datetime.datetime(2011, 11, 5, 16, 0, 0, 0, tzinfo=tz_hi) >>> print(dt_hi.timetuple()) time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=16, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=309, tm_isdst=0) >>> print(dt_hi.utctimetuple()) time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=2, tm_min=0, tm_sec=0, tm_wday=6, tm_yday=310, tm_isdst=0) According to the docs, this is what astimezone does. >>> utc = (dt_hi - dt_hi.utcoffset()).replace(tzinfo=tz_pac) >>> utc datetime.datetime(2011, 11, 6, 2, 0, tzinfo=TimeZoneInfo('Pacific Standard Time')) >>> tz_pac.fromutc(utc) == dt_hi.astimezone(tz_pac) True >>> tz_pac.fromutc(utc) datetime.datetime(2011, 11, 5, 19, 0, tzinfo=TimeZoneInfo('Pacific Standard Time')) Make sure the converted time is correct. >>> dt_pac = dt_hi.astimezone(tz_pac) >>> dt_pac.timetuple() time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=19, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=309, tm_isdst=1) >>> dt_pac.utctimetuple() time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=2, tm_min=0, tm_sec=0, tm_wday=6, tm_yday=310, tm_isdst=0) Check some internal methods >>> tz_pac._getStandardBias(datetime.datetime(2011, 1, 1)) datetime.timedelta(seconds=28800) >>> tz_pac._getDaylightBias(datetime.datetime(2011, 1, 1)) datetime.timedelta(seconds=25200) Test the offsets >>> offset = tz_pac.utcoffset(datetime.datetime(2011, 11, 6, 2, 0)) >>> offset == datetime.timedelta(hours=-8) True >>> dst_offset = tz_pac.dst(datetime.datetime(2011, 11, 6, 2, 0) + offset) >>> dst_offset == datetime.timedelta(hours=1) True >>> (offset + dst_offset) == datetime.timedelta(hours=-7) True Test offsets that occur right at the DST changeover >>> datetime.datetime.utcfromtimestamp(1320570000).replace( ... tzinfo=TimeZoneInfo.utc()).astimezone(tz_pac) datetime.datetime(2011, 11, 6, 1, 0, tzinfo=TimeZoneInfo('Pacific Standard Time')) ) annotationsN)count) TYPE_CHECKINGAnyCallableClassVarDict GeneratorIterableMappingTypeVaroverload)_SupportsComparison)SupportsKeysAndGetItem)Selfz#Jason R. Coombs _RangeMapKTr)bound_T_VTcL\rSrSr%/rS\S'S SjrS SjrS SjrS Sjr Sr g ) _SimpleStructiz ClassVar[list[tuple[str, type]]]_fields_c2[UR5H~unupESnU[U5:aXnXB;aX$nUb[U[5(dU4nOSn[U5S:Xa[USU5(aUSnOU"U6n[ XU5 M g)Nr) enumeraterlen isinstancetuplesetattr)selfargskwinametypdef_argdef_vals jC:\Users\julio\OneDrive\Documentos\Trabajo\Ideas Frescas\venv\Lib\site-packages\win32/lib/win32timezone.py__init___SimpleStruct.__init__s' 6NA{G3t9}'z("!'511&jG7|q Z C%@%@"!*w- D (#7cJURVs/sHoSPM sn$s snf)Nr)r)r!fs r) field_names_SimpleStruct.field_names0s "mm,m!m,,,s c[US5(dgURUR:wagURHup#[X5[X5:wdM g g)NrFT)hasattrrgetattr)r!otherr%_s r)__eq___SimpleStruct.__eq__3sOuj)) ==ENN *}}GDt"ge&::%r,c.URU5(+$N)r6r!r4s r)__ne___SimpleStruct.__ne__=s;;u%%%r,rNreturnNoner>z list[str])r>boolr4objectr>rA) __name__ __module__ __qualname____firstlineno__r__annotations__r*r/r6r;__static_attributes__rr,r)rrs!13H.3)(-&r,rc H\rSrSrS\4S\4S\4S\4S\4S\4S\4S \4/rS rg ) SYSTEMTIMEiAyearmonth day_of_weekdayhourminutesecond millisecondrN)rDrErFrGintrrIrr,r)rKrKAsC  #    3 3  Hr,rKcB\rSrSrS\4S\4S\4S\4S\4S\4S\4/rS rg ) TIME_ZONE_INFORMATIONiNbias standard_namestandard_start standard_bias daylight_namedaylight_start daylight_biasrN) rDrErFrGrTstrrKrrIrr,r)rVrVNs@  # :& # # :& #Hr,rVc>\rSrSr\R S\4S\4/-rSrg)DYNAMIC_TIME_ZONE_INFORMATIONiZkey_namedynamic_daylight_time_disabledrN) rDrErFrGrVrr^rArIrr,r)r`r`Zs'$-- S )401Hr,r`c ^\rSrSr%SrSU4SjjrSU4SjjrSU4Sjjr\(a#S\ S'S\ S 'S \ S 'S\ S 'S\ S 'S \ S'S\ S'SU4Sjjr \ S5r SSjr SSjrSSjrSSjr\SSj5rSrU=r$)TimeZoneDefinitioniaz A time zone definition class based on the win32 DYNAMIC_TIME_ZONE_INFORMATION structure. Describes a bias against UTC (bias), and two dates at which a separate additional bias applies (standard_bias and daylight_bias). c>[TU]"U0UD6 g![[4a Of=fUR"U0UD6 g![a Of=fUR "U0UD6 g![a Of=f[SUR 35e)a >>> test_args = [1] * 44 Try to construct a TimeZoneDefinition from: a) [DYNAMIC_]TIME_ZONE_INFORMATION args >>> TimeZoneDefinition(*test_args).bias datetime.timedelta(seconds=60) b) another TimeZoneDefinition or [DYNAMIC_]TIME_ZONE_INFORMATION >>> TimeZoneDefinition(TimeZoneDefinition(*test_args)).bias datetime.timedelta(seconds=60) >>> TimeZoneDefinition(DYNAMIC_TIME_ZONE_INFORMATION(*test_args)).bias datetime.timedelta(seconds=60) >>> TimeZoneDefinition(TIME_ZONE_INFORMATION(*test_args)).bias datetime.timedelta(seconds=60) c) a byte structure (using _from_bytes) >>> TimeZoneDefinition(bytes(test_args)).bias datetime.timedelta(days=11696, seconds=46140) NzInvalid arguments for )superr* TypeError ValueError$_TimeZoneDefinition__init_from_other$_TimeZoneDefinition__init_from_bytes __class__)r!r"kwargsrks r)r*TimeZoneDefinition.__init__js,  G d -f - :&      " "D 3F 3       " "D 3F 3    00@ABBs-''> A  A A"" A/.A/c >Sn[R"Xa5nUSSupn [USS6n [USS6n [T U]UUU U UU U UU5 g)N3l8h8h )structunpackrKrfr*)r!bytesrXr[radaylight_disabledformat componentsrWrZr]rYr\rks r)__init_from_bytes$TimeZoneDefinition.__init_from_bytessr]]61 -7^*]#Z"%56#Z2%67           r,c>[U[5(d [S5eUR5H"n[[U]U5n[ XU5 M$ g)NzNot a TIME_ZONE_INFORMATION)rrVrgr/rf__getattribute__r )r!r4r%valuerks r)__init_from_other$TimeZoneDefinition.__init_from_othersL%!6779: :%%'D/HNE D &(r,datetime.timedeltarWr^rXrKrYrZr[r\r]cZ>[TU]U5nSU;a[R"US9nU$)NrW)minutes)rfr|datetime timedelta)r!attrr}rks r)r|#TimeZoneDefinition.__getattribute__s.(. T>&&u5E r,c>[R"S5upX"U64$)z+Windows Platform SDK GetTimeZoneInformationT)win32apiGetTimeZoneInformation)clscodetzis r)currentTimeZoneDefinition.currents$33D9 S#Yr,cp^[U4SjTR55n[R"U5 g)Nc3@># UHup[TU5v M g7fr9)r3).0ntr!s r) )TimeZoneDefinition.set..s?GD!$$s)rrrSetTimeZoneInformationr!rs` r)setTimeZoneDefinition.sets%???'',r,c$URU5$r9rkr!s r)copyTimeZoneDefinition.copys~~d##r,c8URXR5$r9) _locate_dayr\r!rLs r)locate_daylight_start(TimeZoneDefinition.locate_daylight_start&9&9::r,c8URXR5$r9)rrYrs r)locate_standard_start(TimeZoneDefinition.locate_standard_startrr,c URS-S-nURnUS- S-S-n[R"UURUURUR UR UR5nX%R5- S-nU[R"U5- nURURS-:Xa6U[R"SS9-nURURS-:XaM6U$)ao Takes a SYSTEMTIME object, such as retrieved from a TIME_ZONE_INFORMATION structure or call to GetTimeZoneInformation and interprets it based on the given year to identify the actual day. This method is necessary because the SYSTEMTIME structure refers to a day by its day of the week and week of the month (e.g. 4th saturday in March). >>> SATURDAY = 6 >>> MARCH = 3 >>> st = SYSTEMTIME(2000, MARCH, SATURDAY, 4, 0, 0, 0, 0) # according to my calendar, the 4th Saturday in March in 2009 was the 28th >>> expected_date = datetime.datetime(2009, 3, 28) >>> TimeZoneDefinition._locate_day(2009, st) == expected_date True r)weeks) rNrOrrMrPrQrRrSweekdayr)rLcutofftarget_weekday week_of_monthrOresult days_to_gos r)rTimeZoneDefinition._locate_days(!,,q0A5 q A%)""  LL  KK MM MM    %~~'771< ($$Z00 llfllQ.. h((q1 1FllfllQ.. r,rr=)rrF)r4rVr>r?)rr^r>rr>rr>datetime.datetime)rDrErFrG__doc__r*rjrirrHr| classmethodrrrrr staticmethodrrI __classcell__rs@r)rdrdas(CZ  2'  ""))""))  -$;;,,r,rdc\rSrSr%SrSrS)S*SjjrS+SjrS,SjrS-Sjr S.Sjr S-S jr S/S jr S/S jr \S0S j5r\S1S j5rS2SjrS3SjrSrSr\S1Sj5r\S4Sj5rS5Sjr\S1Sj5r\S4Sj5rS5SjrSrS6SjrS6SjrS7SjrS7Sjr\S8Sj5rSrS\S '\S8S!j5r\S9S"j5r \S#5r!\S:S$j5r"\S;S%j5r#\S, []) If evaluates to True, daylight savings time is calculated in the same way as standard time. >>> tzi = TimeZoneInfo('Pacific Standard Time') >>> march31 = datetime.datetime(2000,3,31) We know that time zone definitions haven't changed from 2007 to 2012, so regardless of whether dynamic info is available, there should be consistent results for these years. >>> subsequent_years = [march31.replace(year=year) ... for year in range(2007, 2013)] >>> offsets = set(tzi.utcoffset(year) for year in subsequent_years) >>> len(offsets) 1 Cannot create a `TimeZoneInfo` with an invalid name. >>> TimeZoneInfo('Does not exist') Traceback (most recent call last): ... ValueError: Timezone Name 'Does not exist' not found >>> TimeZoneInfo(None) Traceback (most recent call last): ... ValueError: subkey name cannot be empty >>> TimeZoneInfo("") Traceback (most recent call last): ... ValueError: subkey name cannot be empty z7SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zonesc[U[5(aURU5 OXlUR 5 X lgr9)rrd _LoadFromTZI timeZoneName_LoadInfoFromKeyfixedStandardTime)r!paramfix_standard_times r)r*TimeZoneInfo.__init__3s8 e/ 0 0   e $ %   ! ! #!2r,c2URUR4$r9) staticInforrs r)__getinitargs__TimeZoneInfo.__getinitargs__@s!7!788r,cB[URS55nURURUR5n[R [ RUR5nURU5nU$![a [SU<S35ef=f)zAFind the registry key for the time zone name (self.timeZoneName).StdzTimezone Name z not found) dict_get_indexed_time_zone_keysgetr _RegKeyDictopenwinregHKEY_LOCAL_MACHINEtzRegKeysubkeyFileNotFoundErrorrh)r! zoneNamesrkeyrs r)_FindTimeZoneKeyTimeZoneInfo._FindTimeZoneKeyCs99%@A !}}T%6%68I8IJ v88$--H JZZ -F ! J~l-=ZHI I Js 0BBcUR5nUSUlUSUlUSUl[ US5UlUR U5 g)zcLoads the information from an opened time zone registry key into relevant fields of this TZI objectDisplayrDltTZIN)r displayName standardName daylightNamerdr_LoadDynamicInfoFromKeyr!rs r)rTimeZoneInfo._LoadInfoFromKeySsT##%y>JJ,SZ8 $$S)r,cURUlSUlURUlURUlXlg)NUnknown)rXrrrr[rrrs r)rTimeZoneInfo._LoadFromTZI]s9--$----r,cURS5nUS US UR5VVs/sHup4[U5[ U54PM nnn[ USS0[ RS9Ulg![a gf=fs snnf)ag >>> tzi = TimeZoneInfo('Central Standard Time') Here's how the RangeMap is supposed to work: >>> m = RangeMap(zip([2006,2007], 'BC'), ... sort_params = {"reverse": True}, ... key_match_comparator=operator.ge) >>> m.get(2000, 'A') 'A' >>> m[2006] 'B' >>> m[2007] 'C' >>> m[2008] 'C' >>> m[RangeMap.last_item] 'B' >>> m.get(2008, m[RangeMap.last_item]) 'C' Now test the dynamic info (but fallback to our simple RangeMap on systems that don't have dynamicInfo). >>> dinfo = getattr(tzi, 'dynamicInfo', m) >>> 2007 in dinfo True >>> 2008 in dinfo False >>> dinfo[2007] == dinfo[2008] == dinfo[2012] True z Dynamic DSTN FirstEntry LastEntryreverseT sort_paramskey_match_comparator) rritemsrTrdRangeMapoperatorge dynamicInfo)r!rinforLvaluesinfoss r)r$TimeZoneInfo._LoadDynamicInfoFromKeydsF ::m,D    IM  HT SY*62 3   $ "D)!) !     sA2"B2 A?>A?cURRSUR<3nUR(aUS- nUS- nU$)N(z, True))rkrDrr)r!rs r)__repr__TimeZoneInfo.__repr__sENN++,Ad.?.?-BC  ! ! h F#  r,cUR$r9)rrs r)__str__TimeZoneInfo.__str__sr,cgr9rr!dts r)tznameTimeZoneInfo.tznames47r,cgr9rrs r)rrs(+r,cUcgURU5nURUR5nX#R*:Xa UR$X#R *:Xa UR $[SUUURUR 5e)z >>> MST = TimeZoneInfo('Mountain Standard Time') >>> MST.tzname(datetime.datetime(2003, 8, 2)) 'Mountain Daylight Time' >>> MST.tzname(datetime.datetime(2003, 11, 25)) 'Mountain Standard Time' >>> MST.tzname(None) NzUnexpected daylight bias)dst getWinInforLr]rrZrrh)r!rrwinInfos r)rrs :hhrl//"''* ((( ($$ $ *** *$$ $ &    ! !  ! !   r,c[US05(d UR$URRXR[R 5$)zH Return the most relevant "info" for this time zone in the target year. r)r3rrrr last_item)r! targetYears r)rTimeZoneInfo.getWinInfosG t]B//?? "##J0@0@ASAS0TUUr,cjURUR5nURUR-$r9)rrLrWrZr!rrs r)_getStandardBiasTimeZoneInfo._getStandardBias)//"''*||g3333r,cjURUR5nURUR-$r9)rrLrWr]r s r)_getDaylightBiasTimeZoneInfo._getDaylightBiasrr,cgr9rrs r) utcoffsetTimeZoneInfo.utcoffsets+.r,cgr9rrs r)rrsFIr,c~UcgURUR5nUR*URU5-$)z>Calculates the utcoffset according to the datetime.tzinfo specN)rrLrWrr s r)rrs5 ://"''* }txx|++r,cgr9rrs r)rTimeZoneInfo.dsts%(r,cgr9rrs r)rrs@Cr,cUcgURUR5nUR(d%URU5(aURnU*$UR nU*$)zN Calculate the daylight savings offset according to the datetime.tzinfo spec. N)rrLr_inDaylightSavingsr]rZ)r!rrrs r)rrs_ ://"''*%%$*A*A"*E*E**Fw**Fwr,cURSS9nURUR5nURUR5nUR UR5nXBR -nX2R -nX4:aXas=:*=(a U:Os nU$XQs=:=(a U:*Os (+nU$![a SnU$f=f)NtzinfoF)replacerrLGetDSTStartTime GetDSTEndTimer]rZrh)r!rrdstStartdstEnd dstEndAdj dstStartAdjin_dsts r)rTimeZoneInfo._inDaylightSavingss ZZtZ $//"''* ++BGG4H''0F !6!66I#%:%::K $66Y6 (;; ;<   F  sA+B5B55 CCcBURU5RU5$)zCGiven a year, determines the time when daylight savings time starts)rrrs r)r"TimeZoneInfo.GetDSTStartTimet$::4@@r,cBURU5RU5$)z=Given a year, determines the time when daylight savings ends.)rrrs r)r#TimeZoneInfo.GetDSTEndTimer,r,c4URUR:H$r9__dict__r:s r)r6TimeZoneInfo.__eq__}}..r,c4URUR:g$r9r0r:s r)r;TimeZoneInfo.__ne__r3r,cL[R5upU(+nU"X#5$)aReturns the local time zone as defined by the operating system in the registry. >>> localTZ = TimeZoneInfo.local() >>> now_local = datetime.datetime.now(localTZ) >>> now_UTC = datetime.datetime.utcnow() # deprecated >>> (now_UTC - now_local) < datetime.timedelta(seconds = 5) Traceback (most recent call last): ... TypeError: can't subtract offset-naive and offset-aware datetimes >>> now_UTC = now_UTC.replace(tzinfo = TimeZoneInfo('GMT Standard Time', True)) Now one can compare the results of the two offset aware values >>> (now_UTC - now_local) < datetime.timedelta(seconds = 5) True Or use the newer `datetime.timezone.utc` >>> now_UTC = datetime.datetime.now(datetime.timezone.utc) >>> (now_UTC - now_local) < datetime.timedelta(seconds = 5) True )rdr)rrrrs r)localTimeZoneInfo.local"s+.(//1 !%H 4++r,NzClassVar[Self | None]_tzutccXUR(dU"SS5UlUR$)zReturns a time-zone representing UTC. Same as TimeZoneInfo('GMT Standard Time', True) but caches the result for performance. >>> isinstance(TimeZoneInfo.utc(), TimeZoneInfo) True zGMT Standard TimeT)r9)rs r)utcTimeZoneInfo.utcFs$zz0$7CJzzr,c[R[R[R 5nU(aUR U5nU$)z5Return the registry key that stores time zone details)rrrrrrr)rrs r)_get_time_zone_keyTimeZoneInfo._get_time_zone_keyUs8v88,:O:OP **V$C r,cF[R5R5$)z:Returns the names of the (registry keys of the) time zones)rr>subkeysrr,r)_get_time_zone_key_names%TimeZoneInfo._get_time_zone_key_names]s..088::r,c^[[R55nU4Sjn[X!5nS[ X155$)z Get the names of the registry keys indexed by a value in that key, ignoring any keys for which that value is empty or missing. cP>[RU5nURT5$r9)rr>r)rar index_keys r)get_index_valueATimeZoneInfo._get_indexed_time_zone_keys..get_index_valuejs"11(;C779% %r,c3># UHupU(dMX4v M g7fr9r)rr}ras r)r;TimeZoneInfo._get_indexed_time_zone_keys..ps 5K/%u U 5Ks  )listrrBmapzip)rF key_namesrGrs` r)r(TimeZoneInfo._get_indexed_time_zone_keysbs@ >>@A  &_0 585K  r,cl[R5nUVs/sHoRPM sn$s snf)zY Return a list of time zone names that can be used to initialize TimeZoneInfo instances. )rget_sorted_time_zonesr)tzstzs r)get_sorted_time_zone_names'TimeZoneInfo.get_sorted_time_zone_namests, 002*-.#B#...s1ch[R5Vs/sHn[U5PM sn$s snfr9)rrB)rs r)get_all_time_zonesTimeZoneInfo.get_all_time_zones}s))5)N)N)PQ)PA Q)PQQQs/cdU=(d Sn[R5nURUS9 U$)aB Return the time zones sorted by some key. key must be a function that takes a TimeZoneInfo object and returns a value suitable for sorting on. The key defaults to the bias (descending), as is done in Windows (see https://web.archive.org/web/20130723075340/http://blogs.msdn.com/b/michkap/archive/2006/12/22/1350684.aspx) c0URR*$r9)rrW)rs r)4TimeZoneInfo.get_sorted_time_zones..s3>>#6#6"6r,r)rrWsort)rzoness r)rQ"TimeZoneInfo.get_sorted_time_zoness076//1 s  r,)rrrrrrr)F)rzstr | TimeZoneDefinitionrrAr>r?)r>ztuple[TimeZoneDefinition, bool])r>rr=)rrd)r>r^)rrr>r^)rr?r>r?)rdatetime.datetime | Noner> str | None)r rTr>rd)rrr>r)rrar>zdatetime.timedelta | None)rLrTr>rrBrr9)Indexr@)r>zlist[TimeZoneInfo])'rDrErFrGrrr*rrrrrrrrrrrrrrrr"r#r6r;rr7r9rHr;rr>rBrrTrWrQrIrr,r)rr s!HJH #( 3' 3  3  39 *3 j 77 ++ > V44.. II,(( CC :AA//,,B%)F !(  ;;  "//RR  r,rc\rSrSrS Sjr\S SSjj5rSSjrSrSr \ S5r \ S5r \ SS j5r S rg )ricZ[RU5 XlUR5 gr9)rr*r_RegKeyDict__load_valuesrs r)r*_RegKeyDict.__init__s d r,cB[[R"XX455$r9)rr OpenKeyEx)rrsub_keyreservedaccesss r)r_RegKeyDict.opens6++C(KLLr,czU(d [S5e[[R"URU55$)Nzsubkey name cannot be empty)rhrrrir)r!r%s r)r_RegKeyDict.subkeys-:; ;6++DHHd;<>r,c#d# [5H nU"X5v M g![a gf=f7f)z8Enumerates an open registry key as an iterable generatorN)rOSError)rfuncindexs r)r{_RegKeyDict._enumerate_regs2  3&&!   s0 0 -0-0r]N)rwinreg._KeyType)ri) rrrjr^rkrTrlrTr>r)r%r^r>r)rrrzCallable[[_T, int], _VT]r>zGenerator[_VT, None, None])rDrErFrGr*rrrrfrArrqrxr{rIrr,r)rrs RXM!M,/M;>MLOM MM = 2AA?? / #r,rcd[RR[R55$)z Return the UTC time now with timezone awareness as enabled by this module >>> now = utcnow() >>> (now - datetime.datetime.now(datetime.timezone.utc)) < datetime.timedelta(seconds = 5) True >>> type(now.tzinfo) is TimeZoneInfo True )rnowrr;rr,r)utcnowrs$    !1!1!3 44r,cd[RR[R55$)z Return the local time now with timezone awareness as enabled by this module >>> now_local = now() >>> (now_local - datetime.datetime.now(datetime.timezone.utc)) < datetime.timedelta(seconds = 5) True >>> type(now_local.tzinfo) is TimeZoneInfo True )rrrr7rr,r)rrs$    !3!3!5 66r,c[S5n[R"SSSUS9R5S:gnU(+=(a( [R"SSSUS9R5S:HnA[5$) z Run a few known tests to determine the capabilities of the time zone database on this machine. Note Dynamic Time Zone support is not available on any platform at this time; this is a limitation of this library, not the platform.zMountain Standard Timerqr) rrqrrrr2r) rrqrrrrrrr)rr utctimetuplelocals)rMissingTZPatchDynamicTZSupports r)GetTZCapabilitiesrsz / 0C&&tR3?LLN S N*):h.?.? b!C/ln9/: 8Or,c(\rSrSrSSjrSSjrSrg)DLLHandleCacheic0Ulgr9)_DLLHandleCache__cachers r)r*DLLHandleCache.__init__s ') r,cUR5nURRU[R"U55$r9)lowerr setdefaultr LoadLibrary)r!filenamers r) __getitem__DLLHandleCache.__getitem__s0nn||&&sH,@,@,EFFr,)__cacheNr=)rr^r>rT)rDrErFrGr*rrIrr,r)rrs *Gr,rc*[R"S5nURU5nU(dS5eUR5n[USn[ R "U[US55nU$![ Ra SnU$f=f)aResolve a multilingual user interface resource for the time zone name spec should be of the format @path,-stringID[;comment] see https://learn.microsoft.com/en-ca/windows/win32/api/timezoneapi/ns-timezoneapi-time_zone_information for details >>> import sys >>> result = resolveMUITimeZone('@tzres.dll,-110') >>> expectedResultType = [type(None),str][sys.getwindowsversion() >= (6,)] >>> type(result) is expectedResultType True z5@(?P.*),-(?P\d+)(?:;(?P.*))?zCould not parse MUI specdllnamerN) recompilematch groupdictDLLCacher LoadStringrTerror)specpatternmatcherrhandlers r)resolveMUITimeZonersjjQRGmmD!G ...7!!#I)I./%00Yw=O9PQ M >> Ms/A88BBc \rSrSrSr0\R 4SSjjr\SSj5r SSjr \ SSj5r \ SSSjj5r SSS jjr SS jr SS jr\"S S 05"5r"SS\5r\"S5r\"S5rSrg)riat A dictionary-like object that uses the keys as bounds for a range. Inclusion of the value for that range is determined by the key_match_comparator, which defaults to less-than-or-equal. A value is returned for a key if it is the first key that matches in the sorted list of keys. One may supply keyword parameters to be passed to the sort function used to sort keys (i.e. key, reverse) as sort_params. Create a map that maps 1-3 -> 'a', 4-6 -> 'b' >>> r = RangeMap({3: 'a', 6: 'b'}) # boy, that was easy >>> r[1], r[2], r[3], r[4], r[5], r[6] ('a', 'a', 'a', 'b', 'b', 'b') Even float values should work so long as the comparison operator supports it. >>> r[4.5] 'b' Notice that the way rangemap is defined, it must be open-ended on one side. >>> r[0] 'a' >>> r[-1] 'a' One can close the open-end of the RangeMap by using undefined_value >>> r = RangeMap({0: RangeMap.undefined_value, 3: 'a', 6: 'b'}) >>> r[0] Traceback (most recent call last): ... KeyError: 0 One can get the first or last elements in the range by using RangeMap.Item >>> last_item = RangeMap.Item(-1) >>> r[last_item] 'b' .last_item is a shortcut for Item(-1) >>> r[RangeMap.last_item] 'b' Sometimes it's useful to find the bounds for a RangeMap >>> r.bounds() (0, 6) RangeMap supports .get(key, default) >>> r.get(0, 'not found') 'not found' >>> r.get(7, 'not found') 'not found' One often wishes to define the ranges by their left-most values, which requires use of sort params and a key_match_comparator. >>> r = RangeMap({1: 'a', 4: 'b'}, ... sort_params=dict(reverse=True), ... key_match_comparator=operator.ge) >>> r[1], r[2], r[3], r[4], r[5], r[6] ('a', 'a', 'a', 'b', 'b', 'b') That wasn't nearly as easy as before, so an alternate constructor is provided: >>> r = RangeMap.left({1: 'a', 4: 'b', 7: RangeMap.undefined_value}) >>> r[1], r[2], r[3], r[4], r[5], r[6] ('a', 'a', 'a', 'b', 'b', 'b') cF[RX5 X lX0lgr9)rr*rr)r!sourcerrs r)r*RangeMap.__init__js d#&) r,c2U"USS0[RS9$)NrTr)rr)rrs r)left RangeMap.leftvs! D 1   r,c"[U40URD6n[U[R5(aUR X!5nU$UR X!5n[R X5nU[RLa [U5eU$r9) sortedrrrItemr_find_first_match_rundefined_valueKeyError)r!item sorted_keysrrs r)rRangeMap.__getitem__sT6T%5%56 dHMM * *%%k&78F  ))+Ar,Ncgr9rrs r)rrsILr,c0X$![a Us$f=f)z Return the value for key if key is in the dictionary, else default. If default is not given, it defaults to None, so that this method never raises a KeyError. )rrs r)rrs# 9  N s  c[R"URU5n[X15n[ U5$![ a [ U5Sef=fr9) functoolspartialrfilternext StopIterationr)r!keysris_matchmatchess r)rRangeMap._find_first_match_sN$$TZZ6( +=  +4.d * +s 9Acz[U40URD6nU[RU[R4$r9)rrr first_itemr )r!rs r)boundsRangeMap.boundss8T6T%5%56 H//0+h>P>P2QRRr,RangeValueUndefinedrc\rSrSrSrSrg) RangeMap.Itemiz RangeMap ItemrN)rDrErFrGrrIrr,r)rrsr,rr)rr)rLSupportsKeysAndGetItem[_RangeMapKT, _VT] | Iterable[tuple[_RangeMapKT, _VT]]rzMapping[str, Any]rz*Callable[[_RangeMapKT, _RangeMapKT], bool]r>r?)rrr>r)rrr>r)rrrrr>z_VT | _Tr9)rrrr?r>z _VT | None)rrrz _T | Noner>z_VT | _T | None)rzIterable[_RangeMapKT]rrr>r)r>ztuple[_RangeMapKT, _RangeMapKT])rDrErFrGrrler*rrrrrrrtyperrTrrr rIrr,r)rrsNj*,KS;; * Y * ' * I *  *  Y     AA LL +)+1<+ +S 0"b9;OsaJRIr,rr)r>zdict[str, bool])rr^r>rb)5r __future__rrrloggingrrrsr itertoolsrtypingrrrrr r r r r rr _operatorr _typeshedrtyping_extensionsr __author__rrr getLogger__file__logrrKrVr`rdr rr^rrrrrrrrrr,r)rs'kZ#    -0& 2 m+@A  T] en ! %&%&P   M $9h6hVA8??AH )$sCx.)X 5 74GG  6XtK$%Xr,