o oR@s dZddlmZddlmZddlmZddlZddlZddlmZddlm Z ddl m Z ddl Z dd lmZdd lmZdd lmZdd lmZddlZzdd lmZWn eyadZYnwGdddejZGdddeZGdddeZGdddeZGdddeZde _e Ze Z dZ!ddZ"ddZ#dHdd Z$d!d"Z%d#d$Z&dId&d'Z'dJd(d)Z(d*d+Z)d,d-Z*dKd.d/Z+dKd0d1Z,Gd2d3d3e-Z.d4d5Z/defd6d7Z0efd8d9Z1efd:d;Z2efdd?Z4efd@dAZ5dLdBdCZ6GdDdEdEe j7Z8efdFdGZ9dS)Madateutil and datetime with portable timezone and ISO 8601 durations. This module supports round-trip conversions between strings, datetime objects and timestamps: => ParseDateTime => => GetTimeStampFromDateTime => string datetime timestamp <= FormatDateTime <= <= GetDateTimeFromTimeStamp <= GetTimeZone(str) returns the tzinfo object for a timezone name. It handles abbreviations, IANA timezone names, and on Windows translates timezone names to the closest Windows TimeZone registry equivalent. LocalizeDateTime(datetime, tzinfo) returns a datetime object relative to the timezone tzinfo. ISO 8601 duration/period conversions are also supported: => ParseDuration => => GetDateTimePlusDuration => string Duration datetime <= FormatDuration <= timedelta => GetDurationFromTimeDelta => Duration This module is biased to the local timezone by default. To operate on timezone naiive datetimes specify tzinfo=None in all calls that have a timezone kwarg. The datetime and/or dateutil modules should have covered all of this. )absolute_import)division)unicode_literalsN)parser)tz)_common) exceptions)encoding) iso_duration) times_data)tzwinc@eZdZdZdS)ErrorzBase errors for this module.N__name__ __module__ __qualname____doc__rr;/tmp/google-cloud-sdk/lib/googlecloudsdk/core/util/times.pyrGrc@r )DateTimeSyntaxErrorzDate/Time string syntax error.NrrrrrrKrrc@r )DateTimeValueErrorzDate/Time part overflow error.NrrrrrrOrrc@r )DurationSyntaxErrorzDuration string syntax error.NrrrrrrSrrc@r )DurationValueErrorzDuration part overflow error.NrrrrrrWrrTc Csz||WSttfy.}zd|vrtt|t||ddWYd}~Sd}~wtt t fyC}ztt|d}~ww)z/Convert strftime exceptions to Datetime Errors.z%Zz%EzN) strftime TypeError UnicodeErrorrsix text_typeFormatDateTimereplaceAttributeError OverflowError ValueError)dtfmterrr _StrFtimeds r)c Csbztj||WStttfy}ztt|d}~wty0}zt t|d}~ww)z/Convert strptime exceptions to Datetime Errors.N) datetimestrptimer#r$rrrr r%r)stringr'r(rrr _StrPtimessr-cCs|j||dS)aReturns an ISO 8601 string representation of the duration. The Duration format is: "[-]P[nY][nM][nD][T[nH][nM][n[.m]S]]". At least one part will always be displayed. The 0 duration is "P0". Negative durations are prefixed by "-". "T" disambiguates months "P2M" to the left of "T" and minutes "PT5MM" to the right. Args: duration: An iso_duration.Duration object. parts: Format at most this many duration parts starting with largest non-zero part. precision: Format the last duration part with precision digits after the decimal point. Trailing "0" and "." are always stripped. Raises: DurationValueError: A Duration numeric constant exceeded its range. Returns: An ISO 8601 string representation of the duration. )parts precision)Format)durationr/r0rrrFormatDuration}sr3cCs6dt|jt}|dr|dtd }|dS)aReturns a string representation of the duration, ending in 's'. See the section of on JSON formats. For example: >>> FormatDurationForJson(iso_duration.Duration(seconds=10)) 10s >>> FormatDurationForJson(iso_duration.Duration(hours=1)) 3600s >>> FormatDurationForJson(iso_duration.Duration(seconds=1, microseconds=5)) 1.000005s Args: duration: An iso_duration.Duration object. Raises: DurationValueError: A Duration numeric constant exceeded its range. Returns: An string representation of the duration. z{}z.0Ns)formatround total_seconds_MICROSECOND_PRECISIONendswithlen)r2numrrrFormatDurationForJsons r<cCsdd|DS)aReturns a list of string representations of the durations, ending in 's'. It will use FormatDurationForJson to process each duration object in the list. Args: duration_list: A list of iso_duration.Duration objects to be formatted. Raises: DurationValueError: A Duration numeric constant exceeded its range. Returns: A list of strings representation of the duration. cSsg|]}t|qSr)r<).0r2rrr sz-FormatDurationListForJson..r) duration_listrrrFormatDurationListForJsonsr@Fc Cs|rz t|}d||}Wn tyYnwz tj|d|WSttfy7}ztt |d}~wtyI}zt t |d}~ww)aFParses a duration string and returns a Duration object. Durations using only hours, miniutes, seconds and microseconds are exact. calendar=True allows the constructor to use duration units larger than hours. These durations will be inexact across daylight savings time and leap year boundaries, but will be "calendar" correct. For example: 2015-02-14 + P1Y => 2016-02-14 2015-02-14 + P365D => 2016-02-14 2016-02-14 + P1Y => 2017-02-14 2016-02-14 + P366D => 2017-02-14 2016-03-13T01:00:00 + P1D => 2016-03-14T01:00:00 2016-03-13T01:00:00 + PT23H => 2016-03-14T01:00:00 2016-03-13T01:00:00 + PT24H => 2016-03-14T03:00:00 Args: string: The ISO 8601 duration/period string to parse. calendar: Use duration units larger than hours if True. default_suffix: Use this suffix if string is an unqualified int. Raises: DurationSyntaxError: Invalid duration syntax. DurationValueError: A Duration numeric constant exceeded its range. Returns: An iso_duration.Duration object for the given ISO 8601 duration/period string. z{}{})calendarN) intr5r%r DurationParser#r$rrr r)r,rAdefault_suffixsecondsr(rrr ParseDurations  rGcCstj||dS)aReturns a Duration object converted from a datetime.timedelta object. Args: delta: The datetime.timedelta object to convert. calendar: Use duration units larger than hours if True. Returns: The iso_duration.Duration object converted from a datetime.timedelta object. deltarA)r rCrHrrrGetDurationFromTimeDeltas rJcCs ||S)zReturns a new datetime object representing dt + duration. Args: dt: The datetime object to add the duration to. duration: The iso_duration.Duration object. Returns: A new datetime object representing dt + duration. )GetRelativeDateTime)r&r2rrrGetDateTimePlusDurations rLcCsp|dvrtS|dvr tStj||}t|}|s6tr6tj||}zt|}W|St y5Y|Sw|S)zReturns a datetime.tzinfo object for name. Args: name: A timezone name string, None for the local timezone. Returns: A datetime.tzinfo object for name, local timezone if name is unknown. )UTCZ)LOCALL) rMrOr ABBREVIATION_TO_IANAgetrgettzr IANA_TO_WINDOWS WindowsError)nametzinforrr GetTimeZone s     rXc Cs.|rt||}|s d}td}||}|stt||Sg}d}|r||}||kr>|tt|||||d7}|| rSt ||}|d7}nd}||dvrd||} |d7}nd} ||} d| } | dkrt|| } |r|t | krt | d|} t | |}|d kr| d7} d j |d }| | } t | |kr| | d} n3| d krt |} n*| d krt|| } | r| dkr| dkrd} nt | d kr| ddd| dd} | r|t| ||7}|||d}|s%|t |kr|tt|||dd|S)aOReturns a string of a datetime object formatted by an extended strftime(). fmt handles these modifier extensions to the standard formatting chars: %Nf Limit the fractional seconds to N digits. The default is N=6. %Ez Format +/-HHMM offsets as ISO RFC 3339 Z for +0000 otherwise +/-HH:MM. %Oz Format +/-HHMM offsets as ISO RFC 3339 +/-HH:MM. NOTE: The standard Python 2 strftime() borks non-ascii time parts. It does so by encoding non-ascii names to bytes, presumably under the assumption that the return value will be immediately output. This code works around that by decoding strftime() values to unicode if necessary and then returning either an ASCII or UNICODE string. Args: dt: The datetime object to be formatted. fmt: The strftime(3) format string, None for the RFC 3339 format in the dt timezone ('%Y-%m-%dT%H:%M:%S.%3f%Ez'). tzinfo: Format dt relative to this timezone. Raises: DateTimeValueError: A DateTime numeric constant exceeded its range. Returns: A string of a datetime object formatted by an extended strftime(). z%Y-%m-%dT%H:%M:%S.%3f%Ezz%[1-9]?[EO]?[fsz]rN)EO%fz {{0:0{n}d}})nr4zrZz+0000rNr.:)LocalizeDateTimerecompilesearchr Decoder)startappendisdigitrBr:r5GetTimeStampFromDateTimeendjoin)r&r'rW extensionmr/rhmatchr_ alternatespecstd_fmtvalvr]zero_fill_formatrrrr!%sl                  7 r!csfdd|DS)a7Returns a list of strings of datetime objects formatted by FormatDateTime. It will use FormatDateTime to process each datetime object in the list. Args: dt_list: A list of datetime objects to be formatted. fmt: The strftime(3) format string, None for the RFC 3339 format in the dt timezone ('%Y-%m-%dT%H:%M:%S.%3f%Ez'). tzinfo: Format dt relative to this timezone. Raises: DateTimeValueError: A DateTime numeric constant exceeded its range. Returns: A list of strings of a datetime objects formatted by an extended strftime(). csg|]}t|qSr)r!)r=r&r'rWrrr>sz&FormatDateTimeList..r)dt_listr'rWrrwrFormatDateTimeListsryc@s,eZdZdZddZddZeddZdS) _TzInfoOrOffsetGetterzA helper class for dateutil.parser.parse(). Attributes: _timezone_was_specified: True if the parsed date/time string contained an explicit timezone name or offset. cCs d|_dS)NF_timezone_was_specifiedselfrrr__init__s z_TzInfoOrOffsetGetter.__init__cCs&|s|rd|_|s|dur|St|S)aReturns the tzinfo for name or offset. Used by dateutil.parser.parse() to convert timezone names and offsets. Args: name: A timezone name or None to use offset. If offset is also None then the local tzinfo is returned. offset: A signed UTC timezone offset in seconds. Returns: The tzinfo for name or offset or the local tzinfo if both are None. TN)r|rX)r~rVoffsetrrrGets   z_TzInfoOrOffsetGetter.GetcCs|jS)zCTrue if the parsed date/time string contained an explicit timezone.r{r}rrrtimezone_was_specifiedsz,_TzInfoOrOffsetGetter.timezone_was_specifiedN)rrrrrrpropertyrrrrrrzs rzcCsNztd|}Wn tyYdSw|r%t|d}|r%|d|fSdS)zFReturns (prefix,tzinfo) if string has a trailing tz, else (None,None).z(.*[\d\s])([^\d\s]+)$NNrY)rdrprrXgroup)r,rprWrrr_SplitTzFromDates rc Cs|rt||}|r|js|j|d}|St|d}t}d}ztj||j|d}|r;|js;tj|d|d}|j|d}|WSt yY}zt t t |}WYd}~n~d}~wtttfy}zkt tt |}|jst|\}} | rz tj||d}Wn:t y}zt t t |}WYd}~n/d}~wtttfy}zt tt |}WYd}~nd}~ww|j| dWYd}~SWYd}~nd}~wwz t|t|dWSty|YdSw)a\Parses a date/time string and returns a datetime.datetime object. Args: string: The date/time string to parse. This can be a parser.parse() date/time or an ISO 8601 duration after Now(tzinfo) or before if prefixed by '-'. fmt: The input must satisfy this strptime(3) format string. tzinfo: A default timezone tzinfo object to use if string has no timezone. Raises: DateTimeSyntaxError: Invalid date/time/duration syntax. DateTimeValueError: A date/time numeric constant exceeds its range. Returns: A datetime.datetime object for the given date/time string. rWN)tzinfosdefault)r)r-rWr"GetDateTimeDefaultsrzrparserrr$rExceptionContextrrr r#r%rrrrGrKNowrReraise) r,r'rWr&defaultstzgetterexcr(prefixexplicit_tzinforrr ParseDateTimesV           rc Cs>ztj||WStttfy}ztt|d}~ww)aReturns the datetime object for a UNIX timestamp. Args: timestamp: A UNIX timestamp in int or float seconds since the epoch (1970-01-01T00:00:00.000000Z). tzinfo: A tzinfo object for the timestamp timezone, None for naive. Raises: DateTimeValueError: A date/time numeric constant exceeds its range. Returns: The datetime object for a UNIX timestamp. N)r* fromtimestampr%OSErrorr$rrr ) timestamprWr(rrrGetDateTimeFromTimeStamps rcCs0|js |r |j|d}|tjdt}|S)zReturns the float UNIX timestamp (with microseconds) for dt. Args: dt: The datetime object to convert from. tzinfo: Use this tzinfo if dt is naiive. Returns: The float UNIX timestamp (with microseconds) for dt. rr)rWr"r*rrMr7)r&rWrIrrrrk's rkcCst||d}t||dS)aDReturns a datetime object localized to the timezone tzinfo. Args: dt: The datetime object to localize. It can be timezone naive or aware. tzinfo: The timezone of the localized dt. If None then the result is naive, otherwise it is aware. Returns: A datetime object localized to the timezone tzinfo. r)rkr)r&rWtsrrrrc7s rccCs tj|S)zReturns a timezone aware datetime object for the current time. Args: tzinfo: The timezone of the localized dt. If None then the result is naive, otherwise it is aware. Returns: A datetime object localized to the timezone tzinfo. )r*nowrrrrrFs rcCstjt|dtjjS)aReturns a datetime object of default values for parsing partial datetimes. The year, month and day default to today (right now), and the hour, minute, second and fractional second values default to 0. Args: tzinfo: The timezone of the localized dt. If None then the result is naive, otherwise it is aware. Returns: A datetime object of default values for parsing partial datetimes. r)r*combinerdatetimeminrrrrrSs rcCst||dS)aReturns a tzinfo for offset minutes east of UTC with optional name. Args: offset: The minutes east of UTC. Minutes west are negative. name: The optional timezone name. NOTE: no dst name. Returns: A tzinfo for offset seconds east of UTC. <)rtzoffset)rrVrrrTzOffsetds rc@s8eZdZdZdZdZdZdZdZdZ dZ e d d Z d S) WeekdayzRepresents a day of the week.rrYrr.r^rcCs*|}t||d}|std||S)Nz[{}] is not a valid Weekday)uppergetattrKeyErrorr5)clsdayvaluerrrr|s  z Weekday.GetN) rrrrMONDAYTUESDAY WEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY classmethodrrrrrrqsrcCs0t||}||}|j|d}t|S)aReturns the Weekday for dt in the timezone specified by tzinfo. Args: dt: The datetime object that represents the time on weekday. weekday: The day of the week specified as a Weekday enum. tzinfo: The timezone in which to get the new day of the week in. Returns: A Weekday that corresponds to dt and weekday pair localized to the timezone specified by dt. )rcweekdayrr)r&rrW localized_dtlocalized_weekday_offsetlocalized_weekday_indexrrrGetWeekdayInTimezones r)r.r.)FN)Fr)N):r __future__rrrr*rddateutilrr dateutil.tzr tz_commonenumgooglecloudsdk.corergooglecloudsdk.core.utilr r r rr ImportErrorrrrrrPY3tzlocalrOtzutcrMr8r)r-r3r<r@rGrJrLrXr!ryobjectrzrrrrkrcrrrEnumrrrrrrsf            !  ,   e$ A