/snap/core20/2769/usr/lib/python3.8/__pycache__
Edit: /snap/core20/2769/usr/lib/python3.8/__pycache__/datetime.cpython-38.pyc (57173B)
U
yiX
@ s d Z ddlZddlZddlZdd ZdZdZdZ dd d
d d d d d d d d d d g
Z
dgZ dZ e
dd D ]Z
e e e e
7 Z qd[ [
d d
Zdd Zdd Zdd Zdd ZedZedZedZedkstede d kstede d kstd d Zdd d d d!d"d#d$d%d&d'd(d)g
Zdd*d+d,d-d.d/d0gZd1d2 Zdld4d5Z d6d7 Z d8d9 Z d:d; Z d
d? Z!d@dA Z"dBdC Z#dDdE Z$dFdG Z%dHdI Z&dJdK Z'dLdM Z(dNdO Z)G dPdQ dQZ*e*dRe*_+e*dSdTdUdUdVdWe*_,e*ddXe*_-G dYdZ dZZ.e.Z/e.ddde._+e.dd[d e._,e*dd\e._-G d]d^ d^Z0e0Z1G d_d` d`ZeZ2eddde_+edTdUdUdVe_,e*ddXe_-G dadb dbe.Z3e3ddde3_+e3dd[d dTdUdUdVe3_,e*ddXe3_-dcdd Z4G dedf dfe0Z5e56e*de5_7e56e*dTdUdg e5_+e56e*dTdUdge5_,e3dhdde5j7diZ8z ddjl9T W n e:k
r. Y nXX [[ [
[[[[8[ [[[%[$[&['["[#[[([/[[[[ [ [[4[[[[2[1[ [[)[ [![ ddkl9m Z dS )mzConcrete date/time and related types.
See http://www.iana.org/time-zones/repository/tz-link.html for
time zone and DST data sources.
Nc C s | |kr dS | |krdS dS )Nr xyr r /usr/lib/python3.8/datetime.py_cmp s r r i' i۹7 r c C s$ | d dko"| d dkp"| d dkS )z year -> 1 if leap year, else 0. r d r )yearr r r _is_leap% s r c C s( | d }|d |d |d |d S )z2year -> number of days before January 1st of year.r m r
r r r )r r r r r _days_before_year) s r c C s: d| krdks n t ||dkr2t| r2dS t| S )z9year, month -> number of days in that month in that year.r )AssertionErrorr _DAYS_IN_MONTHr monthr r r _days_in_month. s r c C s6 d| krdks n t dt| |dko2t| S )zCyear, month -> number of days in year preceding first day of month.r r month must be in 1..12r )r _DAYS_BEFORE_MONTHr r r r r _days_before_month5 s r c C s` d| krdks n t dt| |}d| kr<|ksJn t d| t| t| | | S )z>year, month, day -> ordinal, considering 01-Jan-0001 as day 1.r r r day must be in 1..%d)r r r r r r daydimr r r _ymd2ord: s
"r# i e i r
c C s8 | d8 } t | t\}} |d d }t | t\}} t | t\}} t | d\}} ||d |d | 7 }|dkst|dkr| dkst|d ddfS |d ko|d
kp|d k}|t|kst| d d ? }t| |d
ko| }|| kr|d8 }|t| |d
ko| 8 }| |8 } d| kr$t||k s*n t||| d fS )z@ordinal -> (year, month, day), considering 01-Jan-0001 as day 1.r r r r r
r r r
2 r% r ) divmod_DI400Y_DI100Y_DI4Yr r r r r ) nZn400r Zn100Zn4Zn1Zleapyearr Z precedingr r r _ord2ymdS s( $r/ ZJanZFebZMarZAprZMayZJunZJulZAugZSepZOctZNovZDecZMonZTueZWedZThuZFriZSatZSunc C s> t | ||d d }t| || }t| ||||||||f S )N )r# r _time struct_time) r mdhhmmssZdstflagZwdayZdnumr r r _build_struct_time s r9 autoc C st dddddd}|dkr&|r dnd }n|d
kr6|d }z || }W n t k
r^ td Y nX || |||S d S )
Nz{:02d}z
{:02d}:{:02d}z{:02d}:{:02d}:{:02d}z{:02d}:{:02d}:{:02d}.{:03d}z{:02d}:{:02d}:{:02d}.{:06d})hoursminutesseconds milliseconds microsecondsr: r? r= r> zUnknown timespec value)KeyError
ValueErrorformat)r6 r7 r8 ustimespecZspecsfmtr r r _format_time s rG c C s d}| d k r| j dk r"d}| } nd}t| tdd\}}t|tdd\}}|d|||f 7 }|sj|jr|d |j 7 }|jr|d
|j 7 }|S ) N r -+r r; r< z %s%02d:%02dz:%02d.%06d)daysr* timedeltar? r= )offssignr6 r7 r8 r r r _format_offset s
rS c C s d }d }d }g }|j }dt| }} || k r|| }
|d7 }|
dkr|| k r|| }
|d7 }|
dkr|d krdt| dd }| | q|
dkrl|d krRd}t| d rR| } | d k rRd
} | jdk r| } d } t| tdd \}
}t|tdd
\}}|j}| j }|r,d| |
|||f }n&|rDd| |
||f }nd| |
|f }d|ks`t
| | n^|
dkr|d krd}t| dr| }|d k r| dd}| | n|d ||
n|d q$||
q$d
|}t||S )Nr r %fz%06d microsecondzrH utcoffsetrJ rI rK rL z%c%02d%02d%02d.%06dz%c%02d%02d%02dz
%c%02d%02dZtznamez%%)appendlengetattrhasattrrX rN r* rO r= r? r rZ replacejoinr2 strftime)objectrC timetupleZfreplaceZzreplaceZZreplaceZ newformatpushir. ZchoffsetrR hrestr4 rQ ur r r _wrap_strftime sn
rj c C sj t | dd }| d dkr,td| d t | dd }| d dkrPtdt | dd }|||gS )
Nr r
rI zInvalid date separator: %sr% r1 zInvalid date separator
)intrB )Zdtstrr r r! r r r _parse_isoformat_date s rn c C s
t | }ddddg}d}tddD ]t}|| dk r:tdt| ||d ||< |d7 }| ||d }|rv|dkrz q|dkrtd| |d7 }q"||k r| | dkrtd nN|d7 }|| }|d
krtd t| |d |d< |dkr|d d 9 < |S ) Nr r' r zIncomplete time componentr :zInvalid time separator: %c.z Invalid microsecond component)r' r0 r@ )r\ rangerB rm )tstrlen_str
time_compsposcompZ next_charZ
len_remainderr r r _parse_hh_mm_ss_ff s2
rw c
C s t | }|dk rtd| dd p2| dd }|dkrL| d |d n| }t|}d }|dkr| |d }t |dkrtdt|}td d
|D rtj}nD| |d dkrd nd}t|d |d |d |d d
} t|| }|| |S )Nr zIsoformat time too shortrI r rJ r )r% rk zMalformed time zone stringc s s | ]}|d kV qdS )r Nr ).0r r r r T s z(_parse_isoformat_time..r r' r; r< r= r? ) r\ rB findrw alltimezoneutcrO r[ )
rr rs Ztz_posZtimestrrt ZtziZtzstrZtz_compsZtzsignZtdr r r _parse_isoformat_time; s,
r c C s& | d k r"t | ts"tdt| d S )Nz4tzinfo.tzname() must return None or string, not '%s')
isinstancestr TypeErrortype)namer r r
_check_tznamed s r c C sj | dks t |d krd S t|ts6td| t|f td | k rTtdk sfn td| |f d S )N)rX dstz3tzinfo.%s() must return None or timedelta, not '%s'r zN%s()=%s, must be strictly between -timedelta(hours=24) and timedelta(hours=24))r r rO r r rB )r rf r r r _check_utc_offseto s
r c C s t | tr| S t | tr tdz | } W n tk
r@ Y n"X t | ts^tdt| j | S | }z | } W n tk
r Y nDX t | tstdt| j dd l }|j
dt|j t dd | S tdt| j d S )Nz$integer argument expected, got floatz$__index__ returned non-int (type %s)z"__int__ returned non-int (type %s)r z$an integer is required (got type %s)r )
stacklevel) r rm floatr __index__AttributeErrorr __name____int__warningswarnDeprecationWarning)valueZorigr r r r _check_int_field{ sB
r c C s t | } t |}t |}t| kr,tks@n tdttf | d| krTdks`n td|t| |}d| kr~|ksn td| || ||fS )Nzyear must be in %d..%dr r r r )r MINYEARMAXYEARrB r r r r r _check_date_fields s
r c C s t | } t |}t |}t |}d| kr4dks@n td| d| krTdks`n td|d| krtdksn td|d| krdksn td||d krtd
|| ||||fS ) Nr zhour must be in 0..23; zminute must be in 0..59zsecond must be in 0..59?B z microsecond must be in 0..999999)r r zfold must be either 0 or 1)r rB )hourminutesecondrV foldr r r _check_time_fields s
r c C s | d k rt | tstdd S )Nz4tzinfo argument must be None or of a tzinfo subclass)r tzinfor )tzr r r _check_tzinfo_arg s r c C s t dt| jt|jf d S )Nzcan't compare '%s' to '%s')r r r r r r r _cmperror s r c C sR t | |\}}|d9 }|dkr&||kn||k }|sF||krN|d dkrN|d7 }|S )zdivide a by b and round result to the nearest integer
When the ratio is exactly half-way between two integers,
the even integer is returned.
r r r )r* )abqrZgreater_than_halfr r r _divide_and_round s r c @ s e Zd ZdZdZd?ddZdd Zdd Zd
d Ze d d
Z
e dd Z e dd Z dd Z
e
Zdd Zdd Zdd Zdd Zd d Zd d ZeZd d! Zd"d# Zd$d% Zd&d' Zd(d) Zd*d+ Zd,d- Z d.d/ Z d0d1 Z d2d3 Z d4d5 Z d6d7 Z!d8d9 Z"d:d; Z#dS )@rO a Represent the difference between two datetime objects.
Supported operators:
- add, subtract timedelta
- unary plus, minus, abs
- compare to timedelta
- multiply, divide by int
In addition, datetime supports subtraction of two datetime objects
returning a timedelta, and addition or subtraction of a datetime
and a timedelta giving a datetime.
Representation: (days, seconds, microseconds). Why? Because I
felt like it.
)_days_seconds
_microseconds _hashcoder c C sV d } } }
||d 7 }||d |d 7 }||d 7 }t |trt|\} }t| d \} }
|
t|
ksrtt|
} |t|kstt|}nd} |}t | tstt| dkstt |tstt| d kstt |tr(t|\}}|t|kstt|}|| 7 }t|d
ks,tn| }t |ts r< r; Zweeksr5 rQ rD ZdayfracZdaysecondsfracZdaysecondswholeZ secondsfracZusdoubleselfr r r r s
**
ztimedelta.__new__c C sp g }| j r|d| j | jr0|d| j | jrF|d| j |sT|d d| jj| jjd|f S )Nzdays=%dz
seconds=%dzmicroseconds=%d0 %s.%s(%s), )r r[ r r __class__
__module__ __qualname__r` )r argsr r r __repr__M s
ztimedelta.__repr__c C sd t | jd\}}t |d\}}d|||f }| jrLdd }d|| j | }| jr`|d| j }|S )Nr z %d:%02d:%02dc S s | t | dkrdpdfS )Nr rQ rH )r )r. r r r plural` s z!timedelta.__str__..pluralz
%d day%s, rM )r* r r r )r r7 r8 r6 rQ r r r r __str__[ s ztimedelta.__str__c C s | j d | j d | j d S )z Total seconds in the duration.r r )rN r= r? r r r r
total_secondsg s
ztimedelta.total_secondsc C s | j S rN r r r r r rN m s ztimedelta.daysc C s | j S r= )r r r r r r= r s ztimedelta.secondsc C s | j S r? )r r r r r r? w s ztimedelta.microsecondsc C s2 t |tr.t| j|j | j|j | j|j S tS Nr rO r r r NotImplementedr otherr r r __add__| s
ztimedelta.__add__c C s2 t |tr.t| j|j | j|j | j|j S tS r r r r r r __sub__ s
ztimedelta.__sub__c C s t |tr| | S tS r )r rO r r r r r __rsub__ s
ztimedelta.__rsub__c C s t | j | j | j S r )rO r r r r r r r __neg__ s ztimedelta.__neg__c C s | S r r r r r r __pos__ s ztimedelta.__pos__c C s | j dk r| S | S d S Nr r r r r r __abs__ s
ztimedelta.__abs__c C s` t |tr(t| j| | j| | j| S t |tr\| }| \}}tddt || |S t
S r ) r rm rO r r r r _to_microsecondsas_integer_ratior r r r usecr r r r r __mul__ s
ztimedelta.__mul__c C s | j d | j d | j S )Nr r r r r r r r r r s ztimedelta._to_microsecondsc C sN t |ttfstS | }t |tr0|| S t |trJtdd|| S d S r )r rm rO r r )r r r r r r __floordiv__ s
ztimedelta.__floordiv__c C s~ t |tttfstS | }t |tr2|| S t |trNtddt||S t |trz| \}}tddt|| |S d S r )r rm r rO r r r r r r r r __truediv__ s
ztimedelta.__truediv__c C s* t |tr&| | }tdd|S tS r )r rO r r )r r r r r r __mod__ s
ztimedelta.__mod__c C s4 t |tr0t| | \}}|tdd|fS tS r )r rO r* r r )r r r r r r r
__divmod__ s
ztimedelta.__divmod__c C s t |tr| |dkS tS d S r r rO r r r r r r __eq__ s
ztimedelta.__eq__c C s t |tr| |dkS tS d S r r r r r r __le__ s
ztimedelta.__le__c C s t |tr| |dk S tS d S r r r r r r __lt__ s
ztimedelta.__lt__c C s t |tr| |dkS tS d S r r r r r r __ge__ s
ztimedelta.__ge__c C s t |tr| |dkS tS d S r r r r r r __gt__ s
ztimedelta.__gt__c C s t |tstt| | S r )r rO r r _getstater r r r r s ztimedelta._cmpc C s | j dkrt| | _ | j S )Nr r hashr r r r r __hash__ s
ztimedelta.__hash__c C s | j dkp | jdkp | jdkS r r r r r r __bool__ s
ztimedelta.__bool__c C s | j | j| jfS r r r r r r r
s ztimedelta._getstatec C s | j | fS r r r r r r r
__reduce__
s ztimedelta.__reduce__N)r r r r r r r )%r r r __doc__ __slots__r r r r propertyrN r= r? r __radd__r r r r r r __rmul__r r r r r r r r r r r r r r r r r r r rO sR
e
rO i6er r r r )rN r; r< r= r? r c @ s@ e Zd ZdZdZdDddZedd Zedd Zed
d Z ed d
Z
edd Z dd Z dd Z
dd Zdd Zdd ZeZedd Zed d Zed d Zd d! Zd"d# ZdEd$d%Zd&d' Zd(d) Zd*d+ Zd,d- Z d.d/ Z d0d1 Z d2d3 Z d4d5 Z e Z!d6d7 Z"d8d9 Z#d:d; Z$dd? Z&d@dA Z'dBdC Z(dS )Fdatea Concrete date type.
Constructors:
__new__()
fromtimestamp()
today()
fromordinal()
Operators:
__repr__, __str__
__eq__, __le__, __lt__, __ge__, __gt__, __hash__
__add__, __radd__, __sub__ (add/radd only with timedelta arg)
Methods:
timetuple()
toordinal()
weekday()
isoweekday(), isocalendar(), isoformat()
ctime()
strftime()
Properties (readonly):
year, month, day
)_year_month_dayr Nc C s |dkrt |ttfrt|dkrdt|dd krBdkrn nTt |tr|z|d}W n tk
rz tdY nX t | }|
| d |_ |S t |||\}}}t | }||_
||_||_d |_ |S )
zVConstructor.
Arguments:
year, month, day (required, base 1)
Nr
r r r' r latin1znFailed to encode latin1 string when unpickling a date object. pickle.load(data, encoding='latin1') is assumed.r )r bytesr r\ ordencodeUnicodeEncodeErrorrB rb r _date__setstater r r r r )r r r r! r r r r r 3 s8
z date.__new__c C s( t |\ }}}}}}}} }
| |||S )z;Construct a date from a POSIX timestamp (like time.time()).)r2 localtime) r tr r4 r5 r6 r7 r8 weekdayjdayr r r r
fromtimestampU s zdate.fromtimestampc C s t }| |S )z"Construct a date from time.time().r2 timer r r r r r today[ s z
date.todayc C s t |\}}}| |||S )zConstruct a date from a proleptic Gregorian ordinal.
January 1 of year 1 is day 1. Only the year, month and day are
non-zero in the result.
)r/ )r r. r r4 r5 r r r fromordinala s zdate.fromordinalc C sX t |tstdz t|dks$t| t| W S tk
rR td|Y nX dS )z5Construct a date from the output of date.isoformat().#fromisoformat: argument must be strrl Invalid isoformat string: N)r r r r\ r rn ExceptionrB )r date_stringr r r
fromisoformatk s
zdate.fromisoformatc C s t | krtks$n td| d| k r8dk sn d}|dkrrt|ddd }|dksn|dkrrt|rrd }|rtd
| d| k rd k sn td | d
|d d |d }t|}|| }| t| S )z|Construct a date from the ISO year, week number and weekday.
This is the inverse of the date.isocalendar() functionzYear is out of range: r 5 Tr r1 r
r' FzInvalid week: rk zInvalid weekday: z (range is [1, 7]))r r rB r# r _isoweek1mondayr/ ) r r weekr! Z out_of_rangeZ
first_weekdayZ
day_offsetZday_1Zord_dayr r r fromisocalendarw s$ zdate.fromisocalendarc C s d| j j| j j| j| j| jf S )a5 Convert to formal string, for repr().
>>> dt = datetime(2010, 1, 1)
>>> repr(dt)
'datetime.datetime(2010, 1, 1, 0, 0)'
>>> dt = datetime(2010, 1, 1, tzinfo=timezone.utc)
>>> repr(dt)
'datetime.datetime(2010, 1, 1, 0, 0, tzinfo=datetime.timezone.utc)'
z%s.%s(%d, %d, %d))r r r r r r r r r r r s z
date.__repr__c C s. | d pd}dt| t| j | j| jf S ) Return ctime() style string.r1 z%s %s %2d 00:00:00 %04d) toordinal _DAYNAMES _MONTHNAMESr r r r r r r r ctime s z
date.ctimec C s t | || S )zFormat using strftime().)rj rc r rF r r r ra s z
date.strftimec C s: t |ts tdt|j t|dkr2| |S t| S Nzmust be str, not %sr r r r r r r\ ra r r r r
__format__ s
zdate.__format__c C s d| j | j| jf S )zReturn the date formatted according to ISO.
This is 'YYYY-MM-DD'.
References:
- http://www.w3.org/TR/NOTE-datetime
- http://www.cl.cam.ac.uk/~mgk25/iso-time.html
z%04d-%02d-%02d)r r r r r r r isoformat s zdate.isoformatc C s | j S )z
year (1-9999))r r r r r r s z date.yearc C s | j S )z month (1-12))r r r r r r s z
date.monthc C s | j S )z
day (1-31))r r r r r r! s zdate.dayc C s t | j| j| jddddS )9Return local time tuple compatible with time.localtime().r r )r9 r r r r r r r rc s zdate.timetuplec C s t | j| j| jS )zReturn proleptic Gregorian ordinal for the year, month and day.
January 1 of year 1 is day 1. Only the year, month and day values
contribute to the result.
)r# r r r r r r r r s zdate.toordinalc C s: |dkr| j }|dkr | j}|dkr*| j}t| |||S )z;Return a new date with new values for the specified fields.N)r r r r )r r r r! r r r r_ s z date.replacec C s t |tr| |dkS tS r r r r r r r r r r s
z date.__eq__c C s t |tr| |dkS tS r r r r r r r s
z date.__le__c C s t |tr| |dk S tS r r r r r r r s
z date.__lt__c C s t |tr| |dkS tS r r r r r r r
s
z date.__ge__c C s t |tr| |dkS tS r r r r r r r s
z date.__gt__c C sP t |tst| j| j| j }}}|j|j|j }}}t|||f|||fS r )r r r r r r r )r r r r4 r5 Zy2Zm2Zd2r r r r s z date._cmpc C s | j dkrt| | _ | j S )Hash.r r r r r r r s
z
date.__hash__c C sJ t |trF| |j }d| k r,tkr>n nt| |S tdtS )zAdd a date to a timedelta.r result out of range) r rO r rN _MAXORDINALr r r r )r r or r r r % s
z date.__add__c C sD t |tr| t|j S t |tr@| }| }t|| S tS )z.Subtract two dates, or a date and a timedelta.)r rO rN r r r )r r days1days2r r r r 0 s
z date.__sub__c C s | d d S )z:Return day of the week, where Monday == 0 ... Sunday == 6.r0 r1 r r r r r r : s z date.weekdayc C s | d pdS )z:Return day of the week, where Monday == 1 ... Sunday == 7.r1 r" r r r r
isoweekday@ s zdate.isoweekdayc C s | j }t|}t| j | j| j}t|| d\}}|dk r^|d8 }t|}t|| d\}}n$|dkr|t|d kr|d7 }d}||d |d fS )a Return a 3-tuple containing ISO year, week number, and weekday.
The first ISO week of the year is the (Mon-Sun) week
containing the year's first Thursday; everything else derives
from that.
The first week is 1; Monday is 1 ... Sunday is 7.
ISO calendar algorithm taken from
http://www.phys.uu.nl/~vgent/calendar/isocalendar.htm
(used with permission)
r1 r r 4 )r r r# r r r* )r r week1mondayr r
r! r r r isocalendarE s
zdate.isocalendarc C s& t | jd\}}t||| j| jgfS N )r* r r r r )r yhiylor r r r c s zdate._getstatec C s" |\}}| _ | _|d | | _d S r' )r r r )r stringr) r* r r r
__setstateg s zdate.__setstatec C s | j | fS r r r r r r r k s zdate.__reduce__)NN)NNN))r r r r r r classmethodr r r r
r r r ra r r r r r r r! rc r r_ r r r r r r r r r r r r# r& r r r r r r r r sX
"
$
r r r c @ s< e Zd ZdZdZdd Zdd Zdd Zd d
Zd d Z d
S )r z}Abstract base class for time zone info classes.
Subclasses must override the name(), utcoffset() and dst() methods.
r c C s t ddS )z%datetime -> string name of time zone.z&tzinfo subclass must override tzname()NNotImplementedErrorr dtr r r rZ | s z
tzinfo.tznamec C s t ddS )zIdatetime -> timedelta, positive for east of UTC, negative for west of UTCz)tzinfo subclass must override utcoffset()Nr. r0 r r r rX s ztzinfo.utcoffsetc C s t ddS )zdatetime -> DST offset as timedelta, positive for east of UTC.
Return 0 if DST not in effect. utcoffset() must include the DST
offset.
z#tzinfo subclass must override dst()Nr. r0 r r r r s z
tzinfo.dstc C s t |tstd|j| k r$td| }|dkr datetime in local time.z&fromutc() requires a datetime argumentzdt.tzinfo is not selfNz0fromutc() requires a non-None utcoffset() resultz*fromutc() requires a non-None dst() resultz;fromutc(): dt.dst gave inconsistent results; cannot convert)r datetimer r rB rX r )r r1 ZdtoffZdtdstdeltar r r fromutc s"
ztzinfo.fromutcc C sf t | dd }|r| }nd}t | dd }|r4| }nt | dd pBd }|d krV| j|fS | j||fS d S )N__getinitargs__r __getstate____dict__)r] r )r Z getinitargsr getstatestater r r r s
ztzinfo.__reduce__N)
r r r r r rZ rX r r4 r r r r r r u s r c @ s* e Zd ZdZdZdBddddZedd Zed
d Zed d
Z edd Z
edd Z edd Z dd Z
dd Zdd Zdd Zd d ZdCd d Zd!d" Zd#d$ Zd%d& ZdDd(d)ZeZed*d+ Zd,d- Zd.d/ Zd0d1 Z d2d3 Z d4d5 Z dEddd7d8Z dFd:d;Z dd? Z"d@dA Z#dS )Gr a< Time with time zone.
Constructors:
__new__()
Operators:
__repr__, __str__
__eq__, __le__, __lt__, __ge__, __gt__, __hash__
Methods:
strftime()
isoformat()
utcoffset()
tzname()
dst()
Properties (readonly):
hour, minute, second, microsecond, tzinfo, fold
)_hour_minute_second _microsecond_tzinfor _foldr Nr c C s t |ttfrt|dkrt|dd d@ dk rt |trhz|d}W n tk
rf tdY nX t | }|
||p~d d |_ |S t |||||\}}}}}t
| t | }||_||_||_||_||_d |_ ||_|S )
zConstructor.
Arguments:
hour, minute (required)
second, microsecond (default to zero)
tzinfo (default to None)
fold (keyword only, default to zero)
r0 r r r( r znFailed to encode latin1 string when unpickling a time object. pickle.load(data, encoding='latin1') is assumed.Nr )r r r r\ r r r rB rb r _time__setstater r r r: r; r< r= r> r? )r r r r rV r r r r r r r s>
z time.__new__c C s | j S z hour (0-23)r: r r r r r s z time.hourc C s | j S z
minute (0-59)r; r r r r r s z time.minutec C s | j S z
second (0-59)r< r r r r r s z time.secondc C s | j S zmicrosecond (0-999999)r= r r r r rV s ztime.microsecondc C s | j S ztimezone info objectr> r r r r r s z time.tzinfoc C s | j S r r? r r r r r s z time.foldc C s$ t |tr | j|dddkS tS d S )NT allow_mixedr r r r r r r r r r s
z time.__eq__c C s t |tr| |dkS tS d S r rP r r r r r # s
z time.__le__c C s t |tr| |dk S tS d S r rP r r r r r ) s
z time.__lt__c C s t |tr| |dkS tS d S r rP r r r r r / s
z time.__ge__c C s t |tr| |dkS tS d S r rP r r r r r 5 s
z time.__gt__Fc
C s t |tst| j}|j}d }}||kr0d}n| }| }||k}|rvt| j| j| j| j f|j|j|j|j fS |d ks|d kr|rdS t
d| jd | j |t dd }|jd |j |t dd } t|| j| j f| |j|j fS )NTr z$cannot compare naive and aware timesr r rL ) r r r r> rX r r: r; r< r= r rO )
r r rO mytzottzmyoffotoff base_compareZmyhhmmZothhmmr r r r ; s4 z time._cmpc C s | j dkr| jr | jdd}n| }| }|sBt| d | _ ntt| j| j d| tdd\}}|tdd r|t
d|tdd }d| krd k rn ntt ||| j | j
| _ nt||| j | j
f| _ | j S )
r r r r@ r; r< r rK rL z whole minuter( )r r r_ rX r r r* rO r r r r r rV )r r tzoffrg r4 r r r r W s
z
time.__hash__c C s | }t|S )z=Return formatted timezone offset (+xx:xx) or an empty string.)rX rS )r rP r r r _tzstrn s z time._tzstrc C s | j dkr d| j| j f }n| jdkr2d| j }nd}d| jj| jj| j| j|f }| jdk r|dd dksrt|dd d | j d }| j r|dd dkst|dd d
}|S ) %Convert to formal string, for repr().r z, %d, %dz, %drH z%s.%s(%d, %d%s)Nr ) , tzinfo=%r , fold=1))
r= r< r r r r: r; r> r r? r rQ r r r r s s$
z
time.__repr__r: c C s0 t | j| j| j| j|}| }|r,||7 }|S )a Return the time formatted according to ISO.
The full format is 'HH:MM:SS.mmmmmm+zz:zz'. By default, the fractional
part is omitted if self.microsecond == 0.
The optional argument timespec specifies the number of additional
terms of the time to include. Valid options are 'auto', 'hours',
'minutes', 'seconds', 'milliseconds' and 'microseconds'.
)rG r: r; r< r= rX )r rE rQ r r r r r s
ztime.isoformatc C sH t |tstdz| t| W S tk
rB td|Y nX dS )z0Construct a time from the output of isoformat().r r N)r r r r r rB )r Z time_stringr r r r
s
ztime.fromisoformatc C s( ddd| j | j| jdddf }t| ||S )z{Format using strftime(). The date part of the timestamp passed
to underlying strftime should not be used.
il r r r )r: r; r< rj )r rF rc r r r ra s z
time.strftimec C s: t |ts tdt|j t|dkr2| |S t| S r r r r r r r s
ztime.__format__c C s( | j dkrdS | j d}td| |S )z^Return the timezone offset as timedelta, positive east of UTC
(negative west of UTC).NrX r> rX r r rf r r r rX s
ztime.utcoffsetc C s& | j dkrdS | j d}t| |S a Return the timezone name.
Note that the name is 100% informational -- there's no requirement that
it mean anything in particular. For example, "GMT", "UTC", "-500",
"-5:00", "EDT", "US/Eastern", "America/New York" are all valid replies.
Nr> rZ r r r r r r rZ s
z time.tznamec C s( | j dkrdS | j d}td| |S aq Return 0 if DST is not in effect, or the DST offset (as timedelta
positive eastward) if DST is in effect.
This is purely informational; the DST offset has already been added to
the UTC offset returned by utcoffset() if applicable, so there's no
need to consult dst() unless you're interested in displaying the DST
info.
Nr r> r r r_ r r r r s
ztime.dstTc C sl |dkr| j }|dkr | j}|dkr*| j}|dkr8| j}|dkrF| j}|dkrT| j}t| ||||||dS )z;Return a new time with new values for the specified fields.NTr@ )r r r rV r r? r )r r r r rV r r r r r r_ s z time.replacer' c C sp t | jd\}}t |d\}}| j}| jr:|dkr:|d7 }t|| j| j|||g}| jd krb|fS || jfS d S Nr( r' )r* r= r: r? r r; r< r> )r protocolus2us3us1rg basestater r r r s
ztime._getstatec C st |d k rt |tstd|\}| _| _}}}|dkrHd| _|d | _n d| _|| _|d> |B d> |B | _|| _d S )Nbad tzinfo state argrA r rf r rk ) r
_tzinfo_classr r; r< r? r: r= r> )r r+ r rg rj rh ri r r r r, s ztime.__setstatec C s | j | |fS r r r rg r r r
__reduce_ex__ s ztime.__reduce_ex__c C s
| dS Nr ro r r r r r s ztime.__reduce__)r r r r N)F)r: )NNNNT)r' )$r r r r r r r r r r rV r r r r r r r r r rX r r r r- r
ra r rX rZ r r_ r rB ro r r r r r r sT (
r c @ s e Zd ZdZejej ZddddddZedd Z ed d
Z
ed d Z ed
d Z edd Z
edd Zedd ZededdZedd ZedfddZedd Zedgd d Zed d! Zd"d# Zd$d% Zd&d' Zd(d) Zd*d+ Zd,d- Zd.d/ Zdhddd0d1Z d2d3 Z did4d5Z d6d7 Z djd:d;Z dd? Z"ed@dA Z#dBdC Z$dDdE Z%dFdG Z&dHdI Z'dJdK Z(dLdM Z)dNdO Z*dPdQ Z+dkdSdTZ,dUdV Z-e-Z.dWdX Z/dYdZ Z0dld\d]Z1d^d_ Z2d`da Z3dbdc Z4dS )mr2 zdatetime(year, month, day[, hour[, minute[, second[, microsecond[,tzinfo]]]]])
The year, month and day arguments are required. tzinfo may be None, or an
instance of a tzinfo subclass. The remaining arguments may be ints.
Nr r@ c C s t |ttfrt|dkrdt|dd d@ kr>dkrn nVt |trxzt|d}W n tk
rv tdY nX t| }
|
|| d |
_
|
S t |||\}}}t ||||| \}}}}} t
| t| }
||
_||
_||
_||
_||
_||
_||
_||
_d |
_
| |
_|
S )
Nrl r r r' rA r r zrFailed to encode latin1 string when unpickling a datetime object. pickle.load(data, encoding='latin1') is assumed.r )r r r r\ r r rB rb r _datetime__setstater r r r r r r r: r; r< r= r> r? ) r r r r! r r r rV r r r r r r r sL
zdatetime.__new__c C s | j S rC rD r r r r r C s z
datetime.hourc C s | j S rE rF r r r r r H s zdatetime.minutec C s | j S rG rH r r r r r M s zdatetime.secondc C s | j S rI rJ r r r r rV R s zdatetime.microsecondc C s | j S rK rL r r r r r W s zdatetime.tzinfoc C s | j S r rM r r r r r \ s z
datetime.foldc C sp t |\}}t|d }|dkr4|d7 }|d8 }n|dk rL|d8 }|d7 }|rVtjntj}||\ }}} }
} } }
}}t| d} | ||| |
| | ||}|dkrbd}||k rtj dr|S ||| dd \}}} }
} } | ||| |
| | ||}|| t
d| }|j dk rl|||t
dd dd \}}} }
} } | ||| |
| | ||}||krld|_ n
|
|}|S )
Construct a datetime from a POSIX timestamp (like time.time()).
A timezone info object may be passed in as well.
r r r r r Nr winr0 )r r r r2 gmtimer minsysplatform
startswithrO rN r? r4 )r r r r ZfracrD Z converterr r4 r5 r6 r7 r8 r r r resultmax_fold_secondsZprobe1ZtransZprobe2r r r _fromtimestamp` s4
*
zdatetime._fromtimestampc C s t | | ||dk |S )rs N)r r| )r r r r r r r s zdatetime.fromtimestampc C s | |ddS )z6Construct a naive UTC datetime from a POSIX timestamp.TN)r| r r r r utcfromtimestamp s zdatetime.utcfromtimestampc C s t }| ||S )zBConstruct a datetime from time.time() and optional time zone info.r )r r r r r r now s z datetime.nowc C s t }| |S )z*Construct a UTC datetime from time.time().)r2 r r} r r r r utcnow s zdatetime.utcnowTc C s\ t |tstdt |ts$td|dkr2|j}| |j|j|j|j|j |j
|j ||j d S )z8Construct a datetime from a given date and a given time.z%date argument must be a date instancez%time argument must be a time instanceTr@ )
r _date_classr _time_classr r r r! r r r rV r )r r r r r r r combine s
zdatetime.combinec C s t |tstd|dd }|dd }z t|}W n" tk
rX td|Y nX |rz t|}W q tk
r td|Y qX ndddddg}| || S )z=Construct a datetime from the output of datetime.isoformat().r r rl Nr )r r r rn rB r )r r Zdstrrr Zdate_componentsZtime_componentsr r r r
s
zdatetime.fromisoformatc C sD | }|dkrd}n|r d}nd}t| j| j| j| j| j| j|S )r Nr r r )r r9 r r r! r r r )r r r r r rc s zdatetime.timetuplec
s t ddd d}| tdd } fdd}||| }|| }||}||kr|| |f| j }||| }||kr|S n|| }||kst|| }||} | |kr|S ||kr|S ttf| j ||S )z Return integer POSIX timestamp. r r r c s> t | d d \}}}}}}t|||||| tdd S )Nr0 r r )r2 r r2 rO )ri r r4 r5 r6 r7 r8 Zepochr r local s z datetime._mktime..local)r2 rO r r maxrv )
r r{ r r r Zu1t1Zu2r t2r r r _mktime s* zdatetime._mktimec C s0 | j dkr | }|| jd S | t S dS )z Return POSIX timestamp as floatNr )r> r rV _EPOCHr r] r r r timestamp s
zdatetime.timestampc C sT | }|r| |8 } | j| j| j }}}| j| j| j }}}t||||||dS )z4Return UTC time tuple compatible with time.gmtime().r )rX r r r! r r r r9 )r rf r r4 r5 r6 r7 r8 r r r utctimetuple s zdatetime.utctimetuplec C s t | j| j| jS )zReturn the date part.)r r r r r r r r r s z
datetime.datec C s t | j| j| j| j| jdS )z'Return the time part, with tzinfo None.r@ )r r r r rV r r r r r r s z
datetime.timec C s t | j| j| j| j| j| jdS )z'Return the time part, with same tzinfo.r@ )r r r r rV r> r r r r r timetz s zdatetime.timetzc
C s |dkr| j }|dkr | j}|dkr*| j}|dkr8| j}|dkrF| j}|dkrT| j}|dkrb| j}|dkrp| j}| dkr~| j} t | ||||||||| d S )z?Return a new datetime with new values for the specified fields.NTr@ )
r r r! r r r rV r r r )
r r r r! r r r rV r r r r r r_ s. zdatetime.replacec C s\ | j d kr| }n| t tdd }t|}t|d d }|j}|j}t t|d|S )Nr r r0 )
r r r rO r2 r r2 tm_gmtofftm_zoner~ )r ZtsZlocaltmr ZgmtoffZzoner r r _local_timezone4 s
zdatetime._local_timezonec C s |d kr| }nt|ts$td| j}|d krF| }|| }n,|| }|d krr| jd d }|| }||kr~| S | | j|d}||S )Nz)tz argument must be an instance of tzinfor )r r r r rX r_ r4 )r r rQ Zmyoffsetr r r r
astimezone@ s
zdatetime.astimezonec C s: | d pd}dt| t| j | j| j| j| j| jf S )r r1 z %s %s %2d %02d:%02d:%02d %04d) r r r r r r: r; r< r r r r r r [ s zdatetime.ctimeTr: c C sN d| j | j| j|f t| j| j| j| j| }| }t |}|rJ||7 }|S )a Return the time formatted according to ISO.
The full format looks like 'YYYY-MM-DD HH:MM:SS.mmmmmm'.
By default, the fractional part is omitted if self.microsecond == 0.
If self.tzinfo is not None, the UTC offset is also attached, giving
giving a full format of 'YYYY-MM-DD HH:MM:SS.mmmmmm+HH:MM'.
Optional argument sep specifies the separator between date and
time, default 'T'.
The optional argument timespec specifies the number of additional
terms of the time to include. Valid options are 'auto', 'hours',
'minutes', 'seconds', 'milliseconds' and 'microseconds'.
z%04d-%02d-%02d%c)
r r r rG r: r; r< r= rX rS )r seprE rQ rP r r r r r e s zdatetime.isoformatc C s | j | j| j| j| j| j| jg}|d dkr2|d= |d dkrD|d= d| jj| jj d
t t |f }| j
dk r|dd dkst|dd d| j
d }| jr|dd dkst|dd d }|S ) rY r r r r NrZ r[ r\ )r r r r: r; r< r= r r r r` mapr r> r r? )r LrQ r r r r s*
zdatetime.__repr__c C s | j ddS )z Convert to string, for str(). )r )r r r r r r s zdatetime.__str__c C s ddl }|| ||S )zKstring, format -> new datetime parsed from a string (like time.strptime()).r N) _strptimeZ_strptime_datetime)r r rC r r r r strptime s zdatetime.strptimec C s( | j dkrdS | j | }td| |S )z\Return the timezone offset as timedelta positive east of UTC (negative west of
UTC).NrX r^ r_ r r r rX s
zdatetime.utcoffsetc C s& | j dkrdS | j | }t| |S r` ra rb r r r rZ s
zdatetime.tznamec C s( | j dkrdS | j | }td| |S rc rd r_ r r r r s
z datetime.dstc C s2 t |tr | j|dddkS t |ts*tS dS d S )NTrN r F)r r2 r r r r r r r r s
zdatetime.__eq__c C s4 t |tr| |dkS t |ts&tS t| | d S r r r2 r r r r r r r r r s
zdatetime.__le__c C s4 t |tr| |dk S t |ts&tS t| | d S r r r r r r r s
zdatetime.__lt__c C s4 t |tr| |dkS t |ts&tS t| | d S r r r r r r r s
zdatetime.__ge__c C s4 t |tr| |dkS t |ts&tS t| | d S r r r r r r r s
zdatetime.__gt__Fc C s t |tst| j}|j}d }}||kr0d}nT| }| }|r||| j| j d kr`dS ||j|j d kr|dS ||k}|rt| j| j | j
| j | j | j
| jf|j|j |j
|j |j |j
|jfS |d ks|d kr|rdS td| | }|jdk rdS |rdpdS )NTr@ r z(cannot compare naive and aware datetimesr r r )r r2 r r> rX r_ r r r r r r: r; r< r= r rN ) r r rO rQ rR rS rT rU Zdiffr r r r sH z
datetime._cmpc
C s t |tstS t| | j| j| j| jd}||7 }t|j d\}}t|d\}}d|j
k rht krn n*t |
t|j
t||||j| jdS tddS )z Add a datetime and a timedelta.r{ r r r r r N)r rO r r r: r; r< r= r* r= rN r r r r r r r? r> r )r r r3 r Zremr r r r r r s&
zdatetime.__add__c C s t |ts"t |tr | | S tS | }| }| j| jd | jd }|j|jd |jd }t|| || | j|j }| j |j kr|S |
}|
}||kr|S |dks|dkrt d|| | S )z6Subtract two datetimes, or a datetime and a timedelta.r r Nz(cannot mix naive and timezone-aware time) r r2 rO r r r< r; r: r= r> rX r ) r r r r! Zsecs1Zsecs2baserS rT r r r r & s*
zdatetime.__sub__c C s | j dkr| jr | jdd}n| }| }|d krFt| d | _ nDt| j| j| j }| j
d | j d | j }tt
||| j| | _ | j S )Nr r r@ r r )r r r_ rX r r r# r r r! r r r rO rV )r r rW rN r= r r r r > s
zdatetime.__hash__r' c C s t | jd\}}t | jd\}}t |d\}}| j}| jrJ|dkrJ|d7 }t|||| j| j| j| j |||g
}| j
d kr~|fS || j
fS d S re ) r* r r= r r? r r r: r; r< r> ) r rg r) r* rh ri rj r4 rk r r r r O s"
zdatetime._getstatec
C s |d k rt |tstd|\
}}}| _| _| _| _}}}|dkrTd| _|d | _n d| _|| _|d | | _ |d> |B d> |B | _
|| _ d S )Nrl rA r rf r r( rk ) r rm r r r: r; r< r? r r r= r> ) r r+ r r) r* r4 rj rh ri r r r r, ^ s" zdatetime.__setstatec C s | j | |fS r r rn r r r ro m s zdatetime.__reduce_ex__c C s
| dS rp rq r r r r r p s zdatetime.__reduce__)NNr r r r N)N)N)T)NNNNNNNT)N)r r: )F)r' )5r r r r r r r r r r r r rV r r r- r| r r} r~ r r r
rc r r r r r_ r r r r r r r rX rZ r r r r r r r r r r r r rr ro r r r r r r2 s $
+
#
%
r2 c C s8 d}t | dd}|d d }|| }||kr4|d7 }|S )Nr' r r0 r1 )r# )r ZTHURSDAYZfirstdayZ firstweekdayr% r r r r y s r c @ s e Zd ZdZe ZefddZed ddZdd Z d d
Z
d d Z d
d Z dd Z
dd Zdd Zdd Zdd ZedddZe Zed d ZdS ) r~ )_offset_namec C sl t |tstd|| jkr,|s&| jS d }nt |ts>td| j| krV| jks`n td| ||S )Nzoffset must be a timedeltazname must be a stringzYoffset must be a timedelta strictly between -timedelta(hours=24) and timedelta(hours=24).)
r rO r _Omittedr r
_minoffset
_maxoffsetrB _create)r rf r r r r r s
ztimezone.__new__Nc C s t | }||_||_|S r )r r r r )r rf r r r r r r s
ztimezone._createc C s | j dkr| jfS | j| j fS )zpickle supportN)r r r r r r r5 s
ztimezone.__getinitargs__c C s t |tr| j|jkS tS r )r r~ r r r r r r r s
ztimezone.__eq__c C s
t | jS r )r r r r r r r s ztimezone.__hash__c C sL | | j krdS | jdkr0d| jj| jj| jf S d| jj| jj| j| jf S )a Convert to formal string, for repr().
>>> tz = timezone.utc
>>> repr(tz)
'datetime.timezone.utc'
>>> tz = timezone(timedelta(hours=-5), 'EST')
>>> repr(tz)
"datetime.timezone(datetime.timedelta(-1, 68400), 'EST')"
zdatetime.timezone.utcNz %s.%s(%r)z
%s.%s(%r, %r))r r r r r r r r r r r s
ztimezone.__repr__c C s
| d S r )rZ r r r r r s ztimezone.__str__c C s$ t |ts|d kr| jS tdd S )Nz8utcoffset() argument must be a datetime instance or None)r r2 r r r0 r r r rX s ztimezone.utcoffsetc C s: t |ts|d kr.| jd kr(| | jS | jS tdd S )Nz5tzname() argument must be a datetime instance or None)r r2 r _name_from_offsetr r r0 r r r rZ s
ztimezone.tznamec C s" t |ts|d krd S tdd S )Nz2dst() argument must be a datetime instance or None)r r2 r r0 r r r r s z timezone.dstc C s2 t |tr&|j| k r td|| j S tdd S )Nz fromutc: dt.tzinfo is not selfz6fromutc() argument must be a datetime instance or None)r r2 r rB r r r0 r r r r4 s
ztimezone.fromutcr( r )r; r? c
C s | sdS | t dk r d}| } nd}t| t dd\}}t|t dd\}}|j}|j}|rd| |dd |dd |dd
|d S |rd| |dd |dd |dS d| |dd |dS ) NZUTCr rI rJ r rK rL Z02dro rp Z06d)rO r* r= r? )r3 rR r; rh r< r= r? r r r r s ( ztimezone._name_from_offset)N)r r r r rb r r r- r r5 r r r r rX rZ r r4 rO r r staticmethodr r r r r r~ s$ r~ rV r r )*)r )r: );r r r2 Zmathr rw r r r r r r Zdbmr" r[ r r r r r# r+ r, r- r r/ r r r9 rG rS rj rn rw r r r r r r r r r rO rv r Z
resolutionr r r rm r r2 r r~ r r r Z _datetime ImportErrorr r r r s
?
@')
=
[ D X a t G