"0 SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJ r SSK r Sr \ "\ 5r SrSrSrSr\ R$r\ R&"S 5r"S S \5r"S S \5r"SS\5r"SS\R25r\"5r"SS\R5rSS0rS\S-\S'S\S-\S'S\S-\S'\S\S'S\S-\S'\S\S'S\S-\S 'S!\S-\S"'\R<"S#S$R?\5-5r S%r!"S&S'\5r"\""S(S)S*S+S,S,S-\5r#S.\ -S- r$\""S/SS0S1S2SS-5r%g)3zSet of classes and functions for dealing with dates and timestamps. The BaseTimestamp and Timestamp are timezone-aware wrappers around Python datetime.datetime class. N)parseri@BcU[-$)zRConvert seconds to microseconds. Args: seconds: number Returns: microseconds )_MICROSECONDS_PER_SECONDsecondss 2platform/bq/third_party/google/apputils/datelib.pySecondsToMicrosecondsr (s + ++cP[[[R"555$)zfGet the current time in microseconds, in UTC. Returns: The number of microseconds since the epoch. )intr timer r_GetCurrentTimeMicrosr3s "499; / 00r c:[R"USSS-5$)z|Convert time_tuple (in UTC) to seconds (also in UTC). Args: time_tuple: tuple with at least 6 items. Returns: seconds. N)rrr)calendartimegm time_tuples rGetSecondsSinceEpochr<s BQ)3 44r c<[[[U555$)zGet a time in microseconds. Arguments: time_tuple: A (year, month, day, hour, minute, second) tuple (the python time tuple format) in the UTC time zone. Returns: The number of microseconds since the epoch represented by the input tuple. )r r rrs r GetTimeMicrosrGs "#7 #C D EEr z US/Pacificc\rSrSrSrSrg)TimestampErrorXz Generic timestamp-related error.rN__name__ __module__ __qualname____firstlineno____doc____static_attributes__rr rrrXs(r rc\rSrSrSrSrg)TimezoneNotSpecifiedError]z4This error is raised when timezone is not specified.rNrrr rr$r$]s<r r$c\rSrSrSrSrg)TimeParseErrorbz3This error is raised when we can't parse the input.rNrrr rr'r'bs;r r'c,\rSrSrSr\R "S5r\R "SS9r\R "\ R*S9r \ R(a\R "\ R*S9rO\ r\\ - rSrSrS rS rS rSS jrSS jrSrg)LocalTimezoneClassjz"This class defines local timezone.r)hoursrc^URU5(a UR$UR$)z;datetime -> minutes east of UTC (negative for west of UTC).)_isdst DSTOFFSET STDOFFSETselfdts r utcoffsetLocalTimezoneClass.utcoffsetxs# {{2 ^^ ^^r c^URU5(a UR$UR$)z.datetime -> DST offset in minutes east of UTC.)r/DSTDIFFZEROr2s rdstLocalTimezoneClass.dsts# {{2 \\ YYr cF[RURU5$)z%datetime -> string name of time zone.)r tznamer/r2s rr=LocalTimezoneClass.tznames ;;t{{2 ''r c "URURURURURUR UR 5SS4 n[R"U5n[R"U5nURS:$)z2Return true if given datetime is within local DST.r) yearmonthdayhourminutesecondweekdayr mktime localtimetm_isdst)r3r4ttstamps rr/LocalTimezoneClass._isdstsd ''288RVVRWWbii **,2 B KKOE  B ;;?r cg)zReturn string ''.zrr3s r__repr__LocalTimezoneClass.__repr__s r cPURb [S5eURUS9$)z!Convert naive time to local time.z*Not naive datetime (tzinfo is already set)tzinforT ValueErrorreplacer3r4 unused_is_dsts rlocalizeLocalTimezoneClass.localizes) yy C DD ::T: ""r cPURc [S5eURUS9$)z7Correct the timezone information on the given datetime.zNaive time - no tzinfo setrSrUrXs r normalizeLocalTimezoneClass.normalizes) yy 3 44 ::T: ""r rN)F)rrrr r!datetime timedeltar9HOURr timezoner1daylightaltzoner0r8r5r:r=r/rPrZr]r"rr rr*r*js*   A $   ! $$  $--8) ]]""DLL=9II  !'(# #r r*c ^\rSrSrSr\r\S5r\S5rU4Sjr U4Sjr \U4Sj5r \U4Sj5r \U4S j5r \U4S j5r\U4S j5r\SS j5rU4S jr\S5rSrSr\SU4Sjj5rSrU=r$) BaseTimestampaOur kind of wrapper over datetime.datetime. The objects produced by methods now, today, fromtimestamp, utcnow, utcfromtimestamp are timezone-aware (with correct timezone). We also overload __add__ and __sub__ method, to fix the result of arithmetic operations. cZUR(dURURS9$U$)z*If obj is naive, add local timezone to it.rS)rTrW LocalTimezoneclsobjs rAddLocalTimezoneBaseTimestamp.AddLocalTimezones' :: [[ 1 1[ 22 Jr c^UR(dURRU5$U$)z2If obj is naive, localize it to cls.LocalTimezone.)rTrirZrjs rLocalizeBaseTimestamp.Localizes' ::    ' ' ,, Jr c >[[U] "U0UD6n[U5"URUR UR URURURURUR5$)zx.__add__(y) <==> x+y.) superrf__add__typerArBrCrDrErF microsecondrTr3argskwargsr __class__s rrtBaseTimestamp.__add__s[ mT*D;F;A :affaggquuaffahhmmQXX //r c >>[[U] "U0UD6n[U[R5(ah[ U5"UR URURURURURURUR5$U$)zx.__add__(y) <==> x-y.)rsrf__sub__ isinstancer_rurArBrCrDrErFrvrTrws rr~BaseTimestamp.__sub__ss mT*D;F;A!X&&'' $Z!(( qxx11 Hr cJ>UR[[U]"U0UD65$)a/Get a timestamp corresponding to right now. Args: args: Positional arguments to pass to datetime.datetime.now(). kwargs: Keyword arguments to pass to datetime.datetime.now(). If tz is not specified, local timezone is assumed. Returns: A new BaseTimestamp with tz's local day and time. )rmrsrfnowrkrxryr{s rrBaseTimestamp.nows,    mS%t6v6 88r cF>UR[[U]55$)zjCurrent BaseTimestamp. Same as self.__class__.fromtimestamp(time.time()). Returns: New self.__class__. )rmrsrftodayrkr{s rrBaseTimestamp.todays    mS ? A BBr cJ>UR[[U]"U0UD65$)aMGet a new localized timestamp from a POSIX timestamp. Args: args: Positional arguments to pass to datetime.datetime.fromtimestamp(). kwargs: Keyword arguments to pass to datetime.datetime.fromtimestamp(). If tz is not specified, local timezone is assumed. Returns: A new BaseTimestamp with tz's local day and time. )rprsrf fromtimestamprs rrBaseTimestamp.fromtimestamps, << mS/@@ BBr c^>[[U] 5R[R S9$)z9Return a new BaseTimestamp representing UTC day and time.rS)rsrfutcnowrWpytzutcrs rrBaseTimestamp.utcnows'  + - 5 5TXX 5 FFr cb>[[U] "U0UD6R[R S9$)zDtimestamp -> UTC datetime from a POSIX timestamp (like time.time()).rS)rsrfutcfromtimestamprWrrrs rrBaseTimestamp.utcfromtimestamps4  5    12r cUc+URU"[R"X5SS65$URU"[R"X5SS65$)zParse date_string according to format and construct BaseTimestamp. Args: date_string: string passed to time.strptime. format: format string passed to time.strptime. tz: if not specified, local timezone assumed. Returns: New BaseTimestamp. Nr)rpr strptimerZ)rk date_stringformattzs rrBaseTimestamp.strptimesQ z \\# k B2A FH II ;;sT]];?CE FFr c >[[U] "U0UD6n[U5"URUR UR URURURURUR5$)z)tz -> convert to time in new timezone tz.) rsrf astimezonerurArBrCrDrErFrvrTrws rrBaseTimestamp.astimezones[ mT-t>v>A :affaggquuaffahhmmQXX //r c2URU[- 5$)zCreate new Timestamp object from microsecond UTC timestamp value. Args: ts: integer microsecond UTC timestamp Returns: New cls() )r_MICROSECONDS_PER_SECOND_F)rktss rFromMicroTimestamp BaseTimestamp.FromMicroTimestamps   #= = >>r c4[UR55$)z[[U] X5nU(aURU5nU$)zCombine date and time into timestamp, timezone-aware. Args: datepart: datetime.date timepart: datetime.time tz: timezone or None Returns: timestamp object )rsrfcombinerZ)rkdateparttimepartrresultr{s rrBaseTimestamp.combine)s,=# .x BF {{6"f Mr rN)rrrr r!ri classmethodrmrprtr~rrrrrrrrrrrr" __classcell__)r{s@rrfrfs -  /   8 8CC B BGG22  G G/ ??5   r rfsr,<mhdDwWMimYz^([0-9]+)([%s])?cZSnU(a[RU5nU(dg[URS55nURS5nU(a![ R U5nU(dgX5-nX- nXRS5SnU(aMU$![a gf=f)aConvert a formatted string representing an interval into seconds. Args: interval: String to interpret as an interval. A basic interval looks like "". Complex intervals consisting of a chain of basic intervals are also allowed. Returns: An integer representing the number of seconds represented by the interval string, or None if the interval string could not be decoded. rNr,)_INTERVAL_REGEXPmatchr grouprV_INTERVAL_CONV_DICTgetend)intervaltotalrnumsuffix multipliers rConvertIntervalToSecondsrHs %  " "8 ,E    A c[[^F &**62j  c LE ! &H% & ,  sB B*)B*cX\rSrSrSr\r\r\ SSj5r \ S5r \ SSj5r Sr g) TimestampikzThis subclass contains methods to parse W3C and interval date spec. The interval date specification is in the form "1D", where "D" can be "s"econds "m"inutes "h"ours "D"ays "W"eeks "M"onths "Y"ears. Nc Z[R"U5nUR(d$U=(d URR U5nU"UR UR URURURURURUR5nU$)zUse dateutil.parser to convert string into timestamp. dateutil.parser understands ISO8601 which is really handy. Args: timestring: string with datetime tz: optional timezone, if timezone is omitted from timestring. Returns: New Timestamp. ) rparserTrirZrArBrCrDrErFrv)rk timestringrrzrs r _StringToTimeTimestamp._StringToTimetsv  Z A 88 """ , ,Q /a !%%188*F Mr c<[R"[U5S9$)z@Parse interval date specification and create a timedelta object.r)r_r`r)rkrs r_IntStringToIntervalTimestamp._IntStringToIntervals   &>z&J KKr cURX5nU(aU$URU5nU(aUR5U- $[U5e)z(Try to create a Timestamp from a string.)rrrr')rkvaluervals r FromStringTimestamp.FromStringsK   E &C j " "5 )C ZZ\C   r rr)rrrr r!rINTERVAL_CONV_DICTrINTERVAL_REGEXPrrrrr"rr rrrksP +$/&LL    r ri' ;i?Bli)&r!rcopyr_resysr typesdateutilrrrfloatrr rrrUTCrb US_PACIFICrVrr$r'rTr*rirfrcompilejoinrrrMAXIMUM_PYTHON_TIMESTAMPMAXIMUM_MICROSECOND_TIMESTAMP#MAXIMUM_MICROSECOND_TIMESTAMP_AS_TSrr rrs    #"#;<,15 F hh ]]< ( Z  ^6#6#r#$ QH%%QlAh 3C 88C 3C 88C 3C 88C.s3C2377C.s3C 3C 88C!4S!99C::0277;N3OOP F- - f%"b"b"fc+ !+-E E I&/aQAv&N#r