1008 lines
84 KiB
Plaintext
1008 lines
84 KiB
Plaintext
|
Ë
|
|||
|
|
gÀj ) ã ó — U d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z m
|
|||
|
|
Z
|
|||
|
|
m Z ddl Z ddlZddlmZ ddlmZ ddlmZmZmZ dd lmZ e rrdd
|
|||
|
|
lmZ ej8 ej: z e z dz Z d e d < e
|
|||
|
|
d
|
|||
|
|
Z!d e d< e
|
|||
|
|
d Z"d e d< ej ejF z e$z e%z ej: z dz Z&d e d< dZ'ejP jR Z*ejV Z+ ed« Z,dod„Z- dpd„Z.dqd„Z/drd„Z0 ds dtd„Z1 ds dud„Z2dsdvd„Z3 dw dxd„Z4 dy dzd „Z5 dy dxd „Z6 dy dxd „Z7 d{ d|d „Z8 d} d~d!„Z9 d} d~d"„Z: d} d~d#„Z; d d€d$„Z< d� d‚d%„Z= dƒ d„d&„Z> d… d†d'„Z? d‡ dˆd(„Z@ d‡ d‰d)„ZA dŠ d‹d*„ZBd+ZCd,e d-< dŒ d�d.„ZD dŽd/„ZE dŠ d�d0„ZF d� d‘d1„ZG G d2„ d3eH« ZI d’ d“d4„ZJ d’ d”d5„ZK G d6„ d « ZL G d7„ d8« ZMi d9g d:¢“d;d“d<d“d=d“d>g d:¢“d?g d:¢“d@g d:¢“dAg d:¢“dBdCdDg“dEdCg“dFdCdDg“dGg dH¢“dIdCg“dJd“dKg dL¢“dMg dL¢“dNg dO¢“i dPg d:¢“dQg d:¢“dRg d:¢“dSdCdDg“dTdCdDg“dUdCdDg“dVdCdDg“dWdCdDg“dXdCdDg“dYd“dZd“d[g d\¢“d]g d:¢“d^dCd_g“d`dCd_g“dag d\¢“dbg d:¢“¥dcg d:¢i¥ZNdde de< dfZOd•dg„ZP edh¬i« d–dj„« ZQd—dk„ZRd˜dl„ZSd™dm„ZT dš d›dn„ZUy# e
|
|||
|
|
$ r
|
|||
|
|
dZ ddlZY �ŒTw xY w)œa[
|
|||
|
|
babel.dates
|
|||
|
|
~~~~~~~~~~~
|
|||
|
|
|
|||
|
|
Locale dependent formatting and parsing of dates and times.
|
|||
|
|
|
|||
|
|
The default locale for the functions in this module is determined by the
|
|||
|
|
following environment variables, in that order:
|
|||
|
|
|
|||
|
|
* ``LC_TIME``,
|
|||
|
|
* ``LC_ALL``, and
|
|||
|
|
* ``LANG``
|
|||
|
|
|
|||
|
|
:copyright: (c) 2013-2026 by the Babel Team.
|
|||
|
|
:license: BSD, see LICENSE for more details.
|
|||
|
|
é )Ú annotationsN)Ú lru_cache)Ú
|
|||
|
|
TYPE_CHECKINGÚLiteralÚ SupportsInt)ÚIterable)Ú localtime)ÚLocaleÚdefault_localeÚ
|
|||
|
|
get_global)ÚLocaleDataDict)Ú TypeAliasr Ú_Instant©ÚfullÚlongÚmediumÚshortÚ_PredefinedTimeFormat)Úformatú stand-aloneÚ_ContextÚ _DtOrTzinfou ∅∅∅ÚLC_TIMEc óº — |j | u r|S t | d« r| j |« S |j €|j | ¬« S |j | « S )NÚlocalize©Útzinfo)r Úhasattrr ÚreplaceÚ
|
|||
|
|
astimezone)ÚtzÚdts úN/home/antigravity/intellecton/venv/lib/python3.12/site-packages/babel/dates.pyÚ _localizer% > sX € ð
|
|||
|
|
‡y�y�B�؈ äˆr�:Ô Ø�{‰{˜2‹Ð à ‡y�yÐà�z‰z ˆzÓ$Ð$ð �=‰=˜Ó Ð ó c óŽ — | €(t j j « }t }||fS t | t « rd}t | « }||fS t | t « r d}t }||fS t | t j t j f« r-t | « }|j � |j nt }||fS d}| }||fS )z¦
|
|||
|
|
Parse a `dt_or_tzinfo` value into a datetime and a tzinfo.
|
|||
|
|
|
|||
|
|
See the docs for this function's callers for semantics.
|
|||
|
|
|
|||
|
|
:rtype: tuple[datetime, tzinfo]
|
|||
|
|
N) ÚdatetimeÚnowÚLOCALTZÚ
|
|||
|
|
isinstanceÚstrÚ get_timezoneÚintÚUTCÚtimeÚ
|
|||
|
|
_get_datetimer ©Ú dt_or_tzinfor# r s r$ Ú_get_dt_and_tzinfor4 O sÓ € ð ÐÜ
|
|||
|
|
×
|
|||
|
|
Ñ
|
|||
|
|
×
|
|||
|
|
"Ñ
|
|||
|
|
"Ó
|
|||
|
|
$ˆÜˆð ˆvˆ:Ðô
|
|||
|
|
�L¤#Ô &Ø
|
|||
|
|
ˆÜ ˜lÓ+ˆð ˆvˆ:Ðô
|
|||
|
|
�L¤#Ô &Ø
|
|||
|
|
ˆÜˆð ˆvˆ:Ðô
|
|||
|
|
|
|||
|
|
�L¤8×#4Ñ#4´h·m±mÐ"DÔ EÜ
|
|||
|
|
˜<Ó
|
|||
|
|
(ˆØ Ÿi™iÐ 3�—’¼ˆð ˆvˆ:Ðð ˆØ ˆØ
|
|||
|
|
ˆvˆ:Ðr& c ó — t | « \ }}t |d« r |j S t |d« r|j � |j S |j |xs# t
|
|||
|
|
j
|
|||
|
|
j
|
|||
|
|
t « « S )z[
|
|||
|
|
Get the timezone name out of a time, datetime, or tzinfo object.
|
|||
|
|
|
|||
|
|
:rtype: str
|
|||
|
|
ÚzoneÚkey)r4 r r6 r7 Útznamer( r) r/ r2 s r$ Ú _get_tz_namer9 k sh € ô $ LÓ1�J€BˆÜˆv�vÔ Ø�{‰{ÐÜ �˜Ô F§J¡JÐ$:Ø�z‰zÐà�}‰}˜RÒ =¤8×#4Ñ#4×#8Ñ#8¼Ó#=Ó>Ð>r& c ó| — | €3t j j t « j d¬« S t | t
|
|||
|
|
t f« r4t j j | t « j d¬« S t | t j « r<t j j t j j « | « S t | t j « rLt | t j « s2t j j | t j « « S | S )a„
|
|||
|
|
Get a datetime out of an "instant" (date, time, datetime, number).
|
|||
|
|
|
|||
|
|
.. warning:: The return values of this function may depend on the system clock.
|
|||
|
|
|
|||
|
|
If the instant is None, the current moment is used.
|
|||
|
|
If the instant is a time, it's augmented with today's date.
|
|||
|
|
|
|||
|
|
Dates are converted to naive datetimes with midnight as the time component.
|
|||
|
|
|
|||
|
|
>>> from datetime import date, datetime
|
|||
|
|
>>> _get_datetime(date(2015, 1, 1))
|
|||
|
|
datetime.datetime(2015, 1, 1, 0, 0)
|
|||
|
|
|
|||
|
|
UNIX timestamps are converted to datetimes.
|
|||
|
|
|
|||
|
|
>>> _get_datetime(1400000000)
|
|||
|
|
datetime.datetime(2014, 5, 13, 16, 53, 20)
|
|||
|
|
|
|||
|
|
Other values are passed through as-is.
|
|||
|
|
|
|||
|
|
>>> x = datetime(2015, 1, 1)
|
|||
|
|
>>> _get_datetime(x) is x
|
|||
|
|
True
|
|||
|
|
|
|||
|
|
:param instant: date, time, datetime, integer, float or None
|
|||
|
|
:type instant: date|time|datetime|int|float|None
|
|||
|
|
:return: a datetime
|
|||
|
|
:rtype: datetime
|
|||
|
|
Nr ) r( r) r/ r r+ r. ÚfloatÚ
|
|||
|
|
fromtimestampr0 ÚcombineÚdateÚtoday)Úinstants r$ r1 r1 z sØ € ð> €Ü× Ñ ×$Ñ$¤SÓ)×1Ñ1¸Ð1Ó>Ð>Ü �Gœc¤5˜\Ô *Ü× Ñ ×.Ñ.¨w¼Ó<×DÑDÈDÐDÓQÐQÜ �GœXŸ]™]Ô +Ü× Ñ ×(Ñ(¬¯ © ×)<Ñ)<Ó)>ÀÓHÐHÜ �GœXŸ]™]Ô +´J¸wÌ×HYÑHYÔ4ZÜ× Ñ ×(Ñ(¨´(·-±-³/ÓBÐBà €Nr& c ó¼ — | j €| j t ¬« } |�7| j t |« « } t |d« r|j
|
|||
|
|
| « } | S )aS
|
|||
|
|
Ensure the datetime passed has an attached tzinfo.
|
|||
|
|
|
|||
|
|
If the datetime is tz-naive to begin with, UTC is attached.
|
|||
|
|
|
|||
|
|
If a tzinfo is passed in, the datetime is normalized to that timezone.
|
|||
|
|
|
|||
|
|
>>> from datetime import datetime
|
|||
|
|
>>> _get_tz_name(_ensure_datetime_tzinfo(datetime(2015, 1, 1)))
|
|||
|
|
'UTC'
|
|||
|
|
|
|||
|
|
>>> tz = get_timezone("Europe/Stockholm")
|
|||
|
|
>>> _ensure_datetime_tzinfo(datetime(2015, 1, 1, 13, 15, tzinfo=UTC), tzinfo=tz).hour
|
|||
|
|
14
|
|||
|
|
|
|||
|
|
:param datetime: Datetime to augment.
|
|||
|
|
:param tzinfo: optional tzinfo
|
|||
|
|
:return: datetime with tzinfo
|
|||
|
|
:rtype: datetime
|
|||
|
|
r Ú normalize)r r r/ r! r- r rB )r# r s r$ Ú_ensure_datetime_tzinforC ¥ sV € ð0
|
|||
|
|
‡y�yÐØ
|
|||
|
|
�Z‰ZœsˆZÓ
|
|||
|
|
#ˆØ
|
|||
|
|
ÐØ
|
|||
|
|
�]‰]œ<¨Ó/Ó
|
|||
|
|
0ˆÜ �6˜;Ô 'Ø×!Ñ! "Ó%ˆBØ
|
|||
|
|
€Ir& c óê — | €$t j j t « } n:t | t t
|
|||
|
|
f« r$t j j
|
|||
|
|
| t « } | j €| j t ¬« } t | t j « rB|�.| j |« } t |d« r|j | « } | j « } | S |�| j |¬« } | S )zÃ
|
|||
|
|
Get a timezoned time from a given instant.
|
|||
|
|
|
|||
|
|
.. warning:: The return values of this function may depend on the system clock.
|
|||
|
|
|
|||
|
|
:param time: time, datetime or None
|
|||
|
|
:rtype: time
|
|||
|
|
r rB )
|
|||
|
|
r( r) r/ r+ r. r; r< r r r! r rB Útimetz)r0 r s r$ Ú _get_timerF Æ sÌ € ð €|Ü× Ñ ×$Ñ$¤SÓ)‰Ü �Dœ3¤˜,Ô 'Ü× Ñ ×.Ñ.¨t´SÓ9ˆà ‡{�{ÐØ�|‰|¤3ˆ|Ó'ˆä�$œ×)Ñ)Ô*Ø Ð Ø—?‘? 6Ó*ˆDÜ�v˜{Ô+Ø ×'Ñ'¨Ó-�Ø�{‰{‹}ˆð €Kð
|
|||
|
|
Ð Ø�|‰| 6ˆ|Ó*ˆØ €Kr& c óP — | €t S t | t « s| S t r t j | « S t sJ ‚ t
|
|||
|
|
j | « S # t j
|
|||
|
|
$ r }|}Y d}~n*d}~ww xY w# t j $ r }|}Y d}~nd}~ww xY wt d| › �« |‚)a Looks up a timezone by name and returns it. The timezone object
|
|||
|
|
returned comes from ``pytz`` or ``zoneinfo``, whichever is available.
|
|||
|
|
It corresponds to the `tzinfo` interface and can be used with all of
|
|||
|
|
the functions of Babel that operate with dates.
|
|||
|
|
|
|||
|
|
If a timezone is not known a :exc:`LookupError` is raised. If `zone`
|
|||
|
|
is ``None`` a local zone object is returned.
|
|||
|
|
|
|||
|
|
:param zone: the name of the timezone to look up. If a timezone object
|
|||
|
|
itself is passed in, it's returned unchanged.
|
|||
|
|
NzUnknown timezone )
|
|||
|
|
r* r+ r, ÚpytzÚtimezoneÚUnknownTimeZoneErrorÚzoneinfoÚZoneInfoÚZoneInfoNotFoundErrorÚ LookupError)r6 ÚeÚexcs r$ r- r- å s£ € ð €|ÜˆÜ �dœCÔ Øˆ å ð Ü—=‘= Ó&Ð &õ ˆˆxð Ü×$Ñ$ TÓ*Ð *øô ×(Ñ(ò Ø�Cûð ûô ×-Ñ-ò Ø�Cûð úô Ð)¨$¨Ð0Ó
|
|||
|
|
1°sÐ:s/ ¢A Á A7 ÁA4Á(A/Á/A4Á7BÂ
|
|||
|
|
BÂBc ó\ — t j |xs t « j | | S )ak Return the names for day periods (AM/PM) used by the locale.
|
|||
|
|
|
|||
|
|
>>> get_period_names(locale='en_US')['am']
|
|||
|
|
'AM'
|
|||
|
|
|
|||
|
|
:param width: the width to use, one of "abbreviated", "narrow", or "wide"
|
|||
|
|
:param context: the context, either "format" or "stand-alone"
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
)r
|
|||
|
|
Úparser Ú day_periods©ÚwidthÚcontextÚlocales r$ Úget_period_namesrX s( € ô �<‰<˜Ò)¤'Ó *× 6Ñ 6°wÑ ?ÀÑ FÐFr& c ó\ — t j |xs t « j | | S )aK Return the day names used by the locale for the specified format.
|
|||
|
|
|
|||
|
|
>>> get_day_names('wide', locale='en_US')[1]
|
|||
|
|
'Tuesday'
|
|||
|
|
>>> get_day_names('short', locale='en_US')[1]
|
|||
|
|
'Tu'
|
|||
|
|
>>> get_day_names('abbreviated', locale='es')[1]
|
|||
|
|
'mar'
|
|||
|
|
>>> get_day_names('narrow', context='stand-alone', locale='de_DE')[1]
|
|||
|
|
'D'
|
|||
|
|
|
|||
|
|
:param width: the width to use, one of "wide", "abbreviated", "short" or "narrow"
|
|||
|
|
:param context: the context, either "format" or "stand-alone"
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
)r
|
|||
|
|
rR r ÚdaysrT s r$ Ú
|
|||
|
|
get_day_namesr[ s( € ô( �<‰<˜Ò)¤'Ó *× /Ñ /°Ñ 8¸Ñ ?Ð?r& c ó\ — t j |xs t « j | | S )a Return the month names used by the locale for the specified format.
|
|||
|
|
|
|||
|
|
>>> get_month_names('wide', locale='en_US')[1]
|
|||
|
|
'January'
|
|||
|
|
>>> get_month_names('abbreviated', locale='es')[1]
|
|||
|
|
'ene'
|
|||
|
|
>>> get_month_names('narrow', context='stand-alone', locale='de_DE')[1]
|
|||
|
|
'J'
|
|||
|
|
|
|||
|
|
:param width: the width to use, one of "wide", "abbreviated", or "narrow"
|
|||
|
|
:param context: the context, either "format" or "stand-alone"
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
)r
|
|||
|
|
rR r ÚmonthsrT s r$ Úget_month_namesr^ - s( € ô$ �<‰<˜Ò)¤'Ó *× 1Ñ 1°'Ñ :¸5Ñ AÐAr& c ó\ — t j |xs t « j | | S )a Return the quarter names used by the locale for the specified format.
|
|||
|
|
|
|||
|
|
>>> get_quarter_names('wide', locale='en_US')[1]
|
|||
|
|
'1st quarter'
|
|||
|
|
>>> get_quarter_names('abbreviated', locale='de_DE')[1]
|
|||
|
|
'Q1'
|
|||
|
|
>>> get_quarter_names('narrow', locale='de_DE')[1]
|
|||
|
|
'1'
|
|||
|
|
|
|||
|
|
:param width: the width to use, one of "wide", "abbreviated", or "narrow"
|
|||
|
|
:param context: the context, either "format" or "stand-alone"
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
)r
|
|||
|
|
rR r ÚquartersrT s r$ Úget_quarter_namesra B s( € ô$ �<‰<˜Ò)¤'Ó *× 3Ñ 3°GÑ <¸UÑ CÐCr& c óV — t j |xs t « j | S )a Return the era names used by the locale for the specified format.
|
|||
|
|
|
|||
|
|
>>> get_era_names('wide', locale='en_US')[1]
|
|||
|
|
'Anno Domini'
|
|||
|
|
>>> get_era_names('abbreviated', locale='de_DE')[1]
|
|||
|
|
'n. Chr.'
|
|||
|
|
|
|||
|
|
:param width: the width to use, either "wide", "abbreviated", or "narrow"
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
)r
|
|||
|
|
rR r Úeras©rU rW s r$ Ú
|
|||
|
|
get_era_namesre W s# € ô �<‰<˜Ò)¤'Ó *× /Ñ /°Ñ 6Ð6r& ÚDateTimePatternc óV — t j |xs t « j | S )aÁ Return the date formatting patterns used by the locale for the specified
|
|||
|
|
format.
|
|||
|
|
|
|||
|
|
>>> get_date_format(locale='en_US')
|
|||
|
|
<DateTimePattern 'MMM d, y'>
|
|||
|
|
>>> get_date_format('full', locale='de_DE')
|
|||
|
|
<DateTimePattern 'EEEE, d. MMMM y'>
|
|||
|
|
|
|||
|
|
:param format: the format to use, one of "full", "long", "medium", or
|
|||
|
|
"short"
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
)r
|
|||
|
|
rR r Ú date_formats©r rW s r$ Úget_date_formatrj h ó# € ô �<‰<˜Ò)¤'Ó *× 7Ñ 7¸Ñ ?Ð?r& c óf — t j |xs t « j }| |vrd} || S )a_ Return the datetime formatting patterns used by the locale for the
|
|||
|
|
specified format.
|
|||
|
|
|
|||
|
|
>>> get_datetime_format(locale='en_US')
|
|||
|
|
'{1}, {0}'
|
|||
|
|
|
|||
|
|
:param format: the format to use, one of "full", "long", "medium", or
|
|||
|
|
"short"
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
N)r
|
|||
|
|
rR r Údatetime_formats)r rW Úpatternss r$ Úget_datetime_formatro { s5 € ô �|‰|˜FÒ -¤gÓ.×?Ñ?€HØ
|
|||
|
|
�XÑ ØˆØ �FÑ Ðr& c óV — t j |xs t « j | S )aÅ Return the time formatting patterns used by the locale for the specified
|
|||
|
|
format.
|
|||
|
|
|
|||
|
|
>>> get_time_format(locale='en_US')
|
|||
|
|
<DateTimePattern 'h:mm:ss\u202fa'>
|
|||
|
|
>>> get_time_format('full', locale='de_DE')
|
|||
|
|
<DateTimePattern 'HH:mm:ss zzzz'>
|
|||
|
|
|
|||
|
|
:param format: the format to use, one of "full", "long", "medium", or
|
|||
|
|
"short"
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
)r
|
|||
|
|
rR r Ú time_formatsri s r$ Úget_time_formatrr � rk r& c ó– — t t | « « } t j |xs t « }| j
|
|||
|
|
j
|
|||
|
|
| « }|j dz dz dz |j z }t |d« \ }}|r |dk( r|dk( ry|dk( r
|
|||
|
|
|dk( rd|z S |dk( s|dk( rd }n|d
|
|||
|
|
k( rd }n|j d d z }|||dz fz S )
|
|||
|
|
a. Return the timezone associated with the given `datetime` object formatted
|
|||
|
|
as string indicating the offset from GMT.
|
|||
|
|
|
|||
|
|
>>> from datetime import datetime
|
|||
|
|
>>> dt = datetime(2007, 4, 1, 15, 30)
|
|||
|
|
>>> get_timezone_gmt(dt, locale='en')
|
|||
|
|
'GMT+00:00'
|
|||
|
|
>>> get_timezone_gmt(dt, locale='en', return_z=True)
|
|||
|
|
'Z'
|
|||
|
|
>>> get_timezone_gmt(dt, locale='en', width='iso8601_short')
|
|||
|
|
'+00'
|
|||
|
|
>>> tz = get_timezone('America/Los_Angeles')
|
|||
|
|
>>> dt = _localize(tz, datetime(2007, 4, 1, 15, 30))
|
|||
|
|
>>> get_timezone_gmt(dt, locale='en')
|
|||
|
|
'GMT-07:00'
|
|||
|
|
>>> get_timezone_gmt(dt, 'short', locale='en')
|
|||
|
|
'-0700'
|
|||
|
|
>>> get_timezone_gmt(dt, locale='en', width='iso8601_short')
|
|||
|
|
'-07'
|
|||
|
|
|
|||
|
|
The long format depends on the locale, for example in France the acronym
|
|||
|
|
UTC string is used instead of GMT:
|
|||
|
|
|
|||
|
|
>>> get_timezone_gmt(dt, 'long', locale='fr_FR')
|
|||
|
|
'UTC-07:00'
|
|||
|
|
|
|||
|
|
.. versionadded:: 0.9
|
|||
|
|
|
|||
|
|
:param datetime: the ``datetime`` object; if `None`, the current date and
|
|||
|
|
time in UTC is used
|
|||
|
|
:param width: either "long" or "short" or "iso8601" or "iso8601_short"
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
:param return_z: True or False; Function returns indicator "Z"
|
|||
|
|
when local time offset is 0
|
|||
|
|
é é< é r ÚZÚ
|
|||
|
|
iso8601_shortz%+03dr z %+03d%02dÚiso8601z
|
|||
|
|
%+03d:%02dÚgmt) rC r1 r
|
|||
|
|
rR r r Ú utcoffsetrZ ÚsecondsÚdivmodÚ zone_formats)r( rU rW Úreturn_zÚoffsetr| ÚhoursÚpatterns r$ Úget_timezone_gmtrƒ ¢ sà € ôR '¤}°XÓ'>Ó?€HÜ
|
|||
|
|
�\‰\˜&Ò+¤GÓ
|
|||
|
|
,€Fà
|
|||
|
|
�_‰_×
|
|||
|
|
&Ñ
|
|||
|
|
& xÓ
|
|||
|
|
0€FØ�k‰k˜BÑ Ñ# bÑ(¨6¯>©>Ñ9€GܘG TÓ*�N€Eˆ7Ù�E˜Q’J 7¨a¢<ØØ �AŠ ˜% ?Ò2ؘ‰Ð Ø �'Ò ˜U oÒ 5Ø ‰Ø �)Ò Ø ‰à×%Ñ% eÑ,¨|Ñ;ˆØ �e˜W¨™]Ð+Ñ +Ð+r& c óø — t j |xs t « }t | « }t d« j ||« }|j j |i « }|j d }t d« j |« }||j vrd}|j | }|s.|r,t t d« j |g « « dk( r||z S |j d }d|v r|d } n|t d « j |« }
|
|||
|
|
|j j |
|
|||
|
|
i « } d| v r| d } n<d
|
|||
|
|
|v r&|j d
|
|||
|
|
d« d j d d « } n|j d d « } |r| S ||| |d
|
|||
|
|
œz z S )uƒ Return a representation of the given timezone using "location format".
|
|||
|
|
|
|||
|
|
The result depends on both the local display name of the country and the
|
|||
|
|
city associated with the time zone:
|
|||
|
|
|
|||
|
|
>>> tz = get_timezone('America/St_Johns')
|
|||
|
|
>>> print(get_timezone_location(tz, locale='de_DE'))
|
|||
|
|
Kanada (St. John’s) (Ortszeit)
|
|||
|
|
>>> print(get_timezone_location(tz, locale='en'))
|
|||
|
|
Canada (St. John’s) Time
|
|||
|
|
>>> print(get_timezone_location(tz, locale='en', return_city=True))
|
|||
|
|
St. John’s
|
|||
|
|
>>> tz = get_timezone('America/Mexico_City')
|
|||
|
|
>>> get_timezone_location(tz, locale='de_DE')
|
|||
|
|
'Mexiko (Mexiko-Stadt) (Ortszeit)'
|
|||
|
|
|
|||
|
|
If the timezone is associated with a country that uses only a single
|
|||
|
|
timezone, just the localized country name is returned:
|
|||
|
|
|
|||
|
|
>>> tz = get_timezone('Europe/Berlin')
|
|||
|
|
>>> get_timezone_name(tz, locale='de_DE')
|
|||
|
|
'Mitteleuropäische Zeit'
|
|||
|
|
|
|||
|
|
.. versionadded:: 0.9
|
|||
|
|
|
|||
|
|
:param dt_or_tzinfo: the ``datetime`` or ``tzinfo`` object that determines
|
|||
|
|
the timezone; if `None`, the current date and time in
|
|||
|
|
UTC is assumed
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
:param return_city: True or False, if True then return exemplar city (location)
|
|||
|
|
for the time zone
|
|||
|
|
:return: the localized timezone name using location format
|
|||
|
|
|
|||
|
|
Ú zone_aliasesÚregionÚzone_territoriesÚZZÚterritory_zonesé ÚfallbackÚcityÚ
|
|||
|
|
meta_zonesú/Ú_ú )Ú0Ú1)
|
|||
|
|
r
|
|||
|
|
rR r r9 r ÚgetÚ
|
|||
|
|
time_zonesr~ Ú territoriesÚlenr� Úsplitr ) r3 rW Ú return_cityr6 ÚinfoÚ
|
|||
|
|
region_formatÚ territoryÚterritory_nameÚfallback_formatÚ city_nameÚmetazoneÚ
|
|||
|
|
metazone_infos r$ Úget_timezone_locationr¡ Þ s’ € ôN �\‰\˜&Ò+¤GÓ
|
|||
|
|
,€Fä ˜ Ó %€Dô �nÓ %× )Ñ )¨$°Ó 5€Dà × Ñ × Ñ rÓ *€Dð ×'Ñ'¨Ñ1€MÜÐ-Ó.×2Ñ2°4Ó8€Iؘ×*Ñ*Ñ*؈ Ø×'Ñ'¨ Ñ2€Ná Ù Ü ”
|
|||
|
|
Ð,Ó-×1Ñ1°)¸RÓ@Ó AÀQÒ Fà ˜~Ñ-Ð-ð ×)Ñ)¨*Ñ5€OØ
|
|||
|
|
��~ؘ‘L‰ ä ˜lÓ+×/Ñ/°Ó5ˆØ ×)Ñ)×-Ñ-¨h¸Ó;ˆ
|
|||
|
|
Ø �]Ñ "Ø% fÑ-‰IØ
|
|||
|
|
�D‰[Ø Ÿ
|
|||
|
|
™
|
|||
|
|
3¨Ó*¨1Ñ-×5Ñ5°c¸3Ó?‰Ià Ÿ ™ S¨#Ó.ˆIáØÐØ ØàØ ñ
|
|||
|
|
ñ
|
|||
|
|
ñ ð r& c óÎ — t | « \ }}t j |xs t « }t | « }|€ |€d}n'|j |« } | rdnd}n|dvr t
|
|||
|
|
d« ‚t d« j ||« }|r|S |j j |i « }
|
|||
|
|
||
|
|||
|
|
v r||
|
|||
|
|
| v r|
|
|||
|
|
| | } | t k7 r| S t d« j |« } | rp|j j | i « }
|
|||
|
|
||
|
|||
|
|
v rP|
|
|||
|
|
| j |« }|dk( r*|t k( r!|
|
|||
|
|
j d i « j |« }|r |t k7 r|S |�t |||¬
|
|||
|
|
« S t | |¬ « S ) uo Return the localized display name for the given timezone. The timezone
|
|||
|
|
may be specified using a ``datetime`` or `tzinfo` object.
|
|||
|
|
|
|||
|
|
>>> from datetime import time
|
|||
|
|
>>> dt = time(15, 30, tzinfo=get_timezone('America/Los_Angeles'))
|
|||
|
|
>>> get_timezone_name(dt, locale='en_US') # doctest: +SKIP
|
|||
|
|
'Pacific Standard Time'
|
|||
|
|
>>> get_timezone_name(dt, locale='en_US', return_zone=True)
|
|||
|
|
'America/Los_Angeles'
|
|||
|
|
>>> get_timezone_name(dt, width='short', locale='en_US') # doctest: +SKIP
|
|||
|
|
'PST'
|
|||
|
|
|
|||
|
|
If this function gets passed only a `tzinfo` object and no concrete
|
|||
|
|
`datetime`, the returned display name is independent of daylight savings
|
|||
|
|
time. This can be used for example for selecting timezones, or to set the
|
|||
|
|
time of events that recur across DST changes:
|
|||
|
|
|
|||
|
|
>>> tz = get_timezone('America/Los_Angeles')
|
|||
|
|
>>> get_timezone_name(tz, locale='en_US')
|
|||
|
|
'Pacific Time'
|
|||
|
|
>>> get_timezone_name(tz, 'short', locale='en_US')
|
|||
|
|
'PT'
|
|||
|
|
|
|||
|
|
If no localized display name for the timezone is available, and the timezone
|
|||
|
|
is associated with a country that uses only a single timezone, the name of
|
|||
|
|
that country is returned, formatted according to the locale:
|
|||
|
|
|
|||
|
|
>>> tz = get_timezone('Europe/Berlin')
|
|||
|
|
>>> get_timezone_name(tz, locale='de_DE')
|
|||
|
|
'Mitteleuropäische Zeit'
|
|||
|
|
>>> get_timezone_name(tz, locale='pt_BR')
|
|||
|
|
'Horário da Europa Central'
|
|||
|
|
|
|||
|
|
On the other hand, if the country uses multiple timezones, the city is also
|
|||
|
|
included in the representation:
|
|||
|
|
|
|||
|
|
>>> tz = get_timezone('America/St_Johns')
|
|||
|
|
>>> get_timezone_name(tz, locale='de_DE')
|
|||
|
|
'Neufundland-Zeit'
|
|||
|
|
|
|||
|
|
Note that short format is currently not supported for all timezones and
|
|||
|
|
all locales. This is partially because not every timezone has a short
|
|||
|
|
code in every locale. In that case it currently falls back to the long
|
|||
|
|
format.
|
|||
|
|
|
|||
|
|
For more information see `LDML Appendix J: Time Zone Display Names
|
|||
|
|
<https://www.unicode.org/reports/tr35/#Time_Zone_Fallback>`_
|
|||
|
|
|
|||
|
|
.. versionadded:: 0.9
|
|||
|
|
|
|||
|
|
.. versionchanged:: 1.0
|
|||
|
|
Added `zone_variant` support.
|
|||
|
|
|
|||
|
|
:param dt_or_tzinfo: the ``datetime`` or ``tzinfo`` object that determines
|
|||
|
|
the timezone; if a ``tzinfo`` object is used, the
|
|||
|
|
resulting display name will be generic, i.e.
|
|||
|
|
independent of daylight savings time; if `None`, the
|
|||
|
|
current date in UTC is assumed
|
|||
|
|
:param width: either "long" or "short"
|
|||
|
|
:param uncommon: deprecated and ignored
|
|||
|
|
:param zone_variant: defines the zone variation to return. By default the
|
|||
|
|
variation is defined from the datetime object
|
|||
|
|
passed in. If no datetime object is passed in, the
|
|||
|
|
``'generic'`` variation is assumed. The following
|
|||
|
|
values are valid: ``'generic'``, ``'daylight'`` and
|
|||
|
|
``'standard'``.
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
:param return_zone: True or False. If true then function
|
|||
|
|
returns long time zone ID
|
|||
|
|
ÚgenericÚdaylightÚstandard)r£ r¥ r¤ zInvalid zone variationr… r� r r rd ©rW )r4 r
|
|||
|
|
rR r r9 ÚdstÚ
|
|||
|
|
ValueErrorr r“ r” ÚNO_INHERITANCE_MARKERr� rƒ r¡ )r3 rU ÚuncommonrW Ú zone_variantÚ return_zoner# r r6 r§ r™ ÚvaluerŸ r Únames r$ Úget_timezone_namer¯ 5 s� € ô\ $ LÓ1�J€BˆÜ
|
|||
|
|
�\‰\˜&Ò+¤GÓ
|
|||
|
|
,€Fä ˜ Ó %€DàÐØ
|
|||
|
|
ˆ:Ø$‰Là—*‘*˜R“.ˆCÙ),™:°*‰Là Ð BÑ BÜ Ð 5Ó6Ð 6ô �nÓ %× )Ñ )¨$°Ó 5€DÙ؈ Ø × Ñ × Ñ rÓ *€Dà ��}˜ ¨¨e©Ñ4Ø�U‘ ˜LÑ)ˆØ Ô)Ò )؈Lä˜,Ó'×+Ñ+¨DÓ1€HÙØ ×)Ñ)×-Ñ-¨h¸Ó;ˆ
|
|||
|
|
Ø �MÑ !Ø Ñ'×+Ñ+¨LÓ9ˆDØ˜Ò DÔ,AÒ$Að %×(Ñ(¨°Ó4×8Ñ8¸ ÓF�Ù˜Ô 5Ò5Ø� ð
|
|||
|
|
€~Ü ¨%¸Ô?Ð?ä °fÔ =Ð=r& c ó. — | € t j j « } n*t | t j « r| j « } t j
|
|||
|
|
|xs t « }|dv r
|
|||
|
|
t ||¬« }t |« }|j | |« S )aú Return a date formatted according to the given pattern.
|
|||
|
|
|
|||
|
|
>>> from datetime import date
|
|||
|
|
>>> d = date(2007, 4, 1)
|
|||
|
|
>>> format_date(d, locale='en_US')
|
|||
|
|
'Apr 1, 2007'
|
|||
|
|
>>> format_date(d, format='full', locale='de_DE')
|
|||
|
|
'Sonntag, 1. April 2007'
|
|||
|
|
|
|||
|
|
If you don't want to use the locale default formats, you can specify a
|
|||
|
|
custom date pattern:
|
|||
|
|
|
|||
|
|
>>> format_date(d, "EEE, MMM d, ''yy", locale='en')
|
|||
|
|
"Sun, Apr 1, '07"
|
|||
|
|
|
|||
|
|
:param date: the ``date`` or ``datetime`` object; if `None`, the current
|
|||
|
|
date is used
|
|||
|
|
:param format: one of "full", "long", "medium", or "short", or a custom
|
|||
|
|
date/time pattern
|
|||
|
|
:param locale: a `Locale` object or a locale identifier. Defaults to the system time locale.
|
|||
|
|
r r¦ )
|
|||
|
|
r( r> r? r+ r
|
|||
|
|
rR r rj Ú
|
|||
|
|
parse_patternÚapply)r> r rW r‚ s r$ Ú format_dater³ ± sy € ð4 €|Ü�}‰}×"Ñ"Ó$‰Ü �Dœ(×+Ñ+Ô ,Ø�y‰y‹{ˆä
|
|||
|
|
�\‰\˜&Ò+¤GÓ
|
|||
|
|
,€FØ
|
|||
|
|
Ð4Ñ4Ü °Ô7ˆÜ˜FÓ#€GØ �=‰=˜˜vÓ &Ð&r& c óP — t t | « |« } t j |xs t « }|dv rVt ||¬« j
|
|||
|
|
dd« j
|
|||
|
|
dt | |d|¬« « j
|
|||
|
|
dt | ||¬« « S t |« j | |« S ) u Return a date formatted according to the given pattern.
|
|||
|
|
|
|||
|
|
>>> from datetime import datetime
|
|||
|
|
>>> dt = datetime(2007, 4, 1, 15, 30)
|
|||
|
|
>>> format_datetime(dt, locale='en_US')
|
|||
|
|
'Apr 1, 2007, 3:30:00\u202fPM'
|
|||
|
|
|
|||
|
|
For any pattern requiring the display of the timezone:
|
|||
|
|
|
|||
|
|
>>> format_datetime(dt, 'full', tzinfo=get_timezone('Europe/Paris'),
|
|||
|
|
... locale='fr_FR')
|
|||
|
|
'dimanche 1 avril 2007, 17:30:00 heure d’été d’Europe centrale'
|
|||
|
|
>>> format_datetime(dt, "yyyy.MM.dd G 'at' HH:mm:ss zzz",
|
|||
|
|
... tzinfo=get_timezone('US/Eastern'), locale='en')
|
|||
|
|
'2007.04.01 AD at 11:30:00 EDT'
|
|||
|
|
|
|||
|
|
:param datetime: the `datetime` object; if `None`, the current date and
|
|||
|
|
time is used
|
|||
|
|
:param format: one of "full", "long", "medium", or "short", or a custom
|
|||
|
|
date/time pattern
|
|||
|
|
:param tzinfo: the timezone to apply to the time for display
|
|||
|
|
:param locale: a `Locale` object or a locale identifier. Defaults to the system time locale.
|
|||
|
|
r r¦ ú'Ú ú{0}N©r rW ú{1}) rC r1 r
|
|||
|
|
rR r ro r Ú format_timer³ r± r² )r( r r rW s r$ Úformat_datetimer» × s’ € ô: '¤}°XÓ'>ÀÓG€Hä
|
|||
|
|
�\‰\˜&Ò+¤GÓ
|
|||
|
|
,€FØ
|
|||
|
|
Ð4Ñ4ä ¨vÔ 6ß
|
|||
|
|
‰W�S˜"Ó
|
|||
|
|
ß
|
|||
|
|
‰W�UœK¨°&ÀÈfÔ UÓ
|
|||
|
|
Vß
|
|||
|
|
‰W�UœK¨°&ÀÔ HÓ
|
|||
|
|
Ið
|
|||
|
|
ô ˜VÓ$×*Ñ*¨8°VÓ<Ð<r& c ó — t | t j « r| j « nd}t | |« } t j
|
|||
|
|
|xs t « }|dv r
|
|||
|
|
t ||¬« }t |« j | ||¬« S )u° Return a time formatted according to the given pattern.
|
|||
|
|
|
|||
|
|
>>> from datetime import datetime, time
|
|||
|
|
>>> t = time(15, 30)
|
|||
|
|
>>> format_time(t, locale='en_US')
|
|||
|
|
'3:30:00\u202fPM'
|
|||
|
|
>>> format_time(t, format='short', locale='de_DE')
|
|||
|
|
'15:30'
|
|||
|
|
|
|||
|
|
If you don't want to use the locale default formats, you can specify a
|
|||
|
|
custom time pattern:
|
|||
|
|
|
|||
|
|
>>> format_time(t, "hh 'o''clock' a", locale='en')
|
|||
|
|
"03 o'clock PM"
|
|||
|
|
|
|||
|
|
For any pattern requiring the display of the time-zone a
|
|||
|
|
timezone has to be specified explicitly:
|
|||
|
|
|
|||
|
|
>>> t = datetime(2007, 4, 1, 15, 30)
|
|||
|
|
>>> tzinfo = get_timezone('Europe/Paris')
|
|||
|
|
>>> t = _localize(tzinfo, t)
|
|||
|
|
>>> format_time(t, format='full', tzinfo=tzinfo, locale='fr_FR')
|
|||
|
|
'15:30:00 heure d’été d’Europe centrale'
|
|||
|
|
>>> format_time(t, "hh 'o''clock' a, zzzz", tzinfo=get_timezone('US/Eastern'),
|
|||
|
|
... locale='en')
|
|||
|
|
"09 o'clock AM, Eastern Daylight Time"
|
|||
|
|
|
|||
|
|
As that example shows, when this function gets passed a
|
|||
|
|
``datetime.datetime`` value, the actual time in the formatted string is
|
|||
|
|
adjusted to the timezone specified by the `tzinfo` parameter. If the
|
|||
|
|
``datetime`` is "naive" (i.e. it has no associated timezone information),
|
|||
|
|
it is assumed to be in UTC.
|
|||
|
|
|
|||
|
|
These timezone calculations are **not** performed if the value is of type
|
|||
|
|
``datetime.time``, as without date information there's no way to determine
|
|||
|
|
what a given time would translate to in a different timezone without
|
|||
|
|
information about whether daylight savings time is in effect or not. This
|
|||
|
|
means that time values are left as-is, and the value of the `tzinfo`
|
|||
|
|
parameter is only used to display the timezone name if needed:
|
|||
|
|
|
|||
|
|
>>> t = time(15, 30)
|
|||
|
|
>>> format_time(t, format='full', tzinfo=get_timezone('Europe/Paris'),
|
|||
|
|
... locale='fr_FR') # doctest: +SKIP
|
|||
|
|
'15:30:00 heure normale d\u2019Europe centrale'
|
|||
|
|
>>> format_time(t, format='full', tzinfo=get_timezone('US/Eastern'),
|
|||
|
|
... locale='en_US') # doctest: +SKIP
|
|||
|
|
'3:30:00\u202fPM Eastern Standard Time'
|
|||
|
|
|
|||
|
|
:param time: the ``time`` or ``datetime`` object; if `None`, the current
|
|||
|
|
time in UTC is used
|
|||
|
|
:param format: one of "full", "long", "medium", or "short", or a custom
|
|||
|
|
date/time pattern
|
|||
|
|
:param tzinfo: the time-zone to apply to the time for display
|
|||
|
|
:param locale: a `Locale` object or a locale identifier. Defaults to the system time locale.
|
|||
|
|
Nr r¦ )Úreference_date)
|
|||
|
|
r+ r( r> rF r
|
|||
|
|
rR r rr r± r² )r0 r r rW Úref_dates r$ rº rº sr € ô@ )¨¬x×/@Ñ/@Ô Aˆt�y‰yŒ{Àt€Hä �T˜6Ó "€Dä
|
|||
|
|
�\‰\˜&Ò+¤GÓ
|
|||
|
|
,€FØ
|
|||
|
|
Ð4Ñ4Ü °Ô7ˆÜ ˜Ó × &Ñ & t¨VÀHÐ &Ó MÐMr& c ó — t j |xs t « }|r$| |j vrt | |j « } |j | }t ||||« S )aæ Return a time and/or date formatted according to the given pattern.
|
|||
|
|
|
|||
|
|
The skeletons are defined in the CLDR data and provide more flexibility
|
|||
|
|
than the simple short/long/medium formats, but are a bit harder to use.
|
|||
|
|
The are defined using the date/time symbols without order or punctuation
|
|||
|
|
and map to a suitable format for the given locale.
|
|||
|
|
|
|||
|
|
>>> from datetime import datetime
|
|||
|
|
>>> t = datetime(2007, 4, 1, 15, 30)
|
|||
|
|
>>> format_skeleton('MMMEd', t, locale='fr')
|
|||
|
|
'dim. 1 avr.'
|
|||
|
|
>>> format_skeleton('MMMEd', t, locale='en')
|
|||
|
|
'Sun, Apr 1'
|
|||
|
|
>>> format_skeleton('yMMd', t, locale='fi') # yMMd is not in the Finnish locale; yMd gets used
|
|||
|
|
'1.4.2007'
|
|||
|
|
>>> format_skeleton('yMMd', t, fuzzy=False, locale='fi') # yMMd is not in the Finnish locale, an error is thrown
|
|||
|
|
Traceback (most recent call last):
|
|||
|
|
...
|
|||
|
|
KeyError: yMMd
|
|||
|
|
>>> format_skeleton('GH', t, fuzzy=True, locale='fi_FI') # GH is not in the Finnish locale and there is no close match, an error is thrown
|
|||
|
|
Traceback (most recent call last):
|
|||
|
|
...
|
|||
|
|
KeyError: None
|
|||
|
|
|
|||
|
|
After the skeleton is resolved to a pattern `format_datetime` is called so
|
|||
|
|
all timezone processing etc is the same as for that.
|
|||
|
|
|
|||
|
|
:param skeleton: A date time skeleton as defined in the cldr data.
|
|||
|
|
:param datetime: the ``time`` or ``datetime`` object; if `None`, the current
|
|||
|
|
time in UTC is used
|
|||
|
|
:param tzinfo: the time-zone to apply to the time for display
|
|||
|
|
:param fuzzy: If the skeleton is not found, allow choosing a skeleton that's
|
|||
|
|
close enough to it. If there is no close match, a `KeyError`
|
|||
|
|
is thrown.
|
|||
|
|
:param locale: a `Locale` object or a locale identifier. Defaults to the system time locale.
|
|||
|
|
)r
|
|||
|
|
rR r Údatetime_skeletonsÚmatch_skeletonr» )Úskeletonr( r ÚfuzzyrW r s r$ Úformat_skeletonrÄ L s[ € ôV �\‰\˜&Ò+¤GÓ
|
|||
|
|
,€FÙ � ×!:Ñ!:Ñ:Ü! (¨F×,EÑ,EÓFˆØ
|
|||
|
|
×
|
|||
|
|
&Ñ
|
|||
|
|
& xÑ
|
|||
|
|
0€FÜ ˜8 V¨V°VÓ <Ð<r& ))Úyeari€3á)Úmonthi �' )Úweeki€: )Údayé€Q )Úhourrv )Úminuteru )ÚsecondrŠ ztuple[tuple[str, int], ...]ÚTIMEDELTA_UNITSc óö ‡‡‡
|
|||
|
|
‡‡— ‰dvr t d« ‚‰dk( r t j dt d¬« dŠt | t
|
|||
|
|
j « r&t | j dz | j z « Šn| Št j |xs t « }|j d Š
|
|||
|
|
|j d
|
|||
|
|
Šˆˆ
|
|||
|
|
ˆˆˆfd „}t D ]³ \ }}t ‰« |z } | |k\ s||k( sŒ ||k( r| d kD r t! d
|
|||
|
|
| « } t t# | « « } |j% | « }
|
|||
|
|
d} ||« D ]- } | €Œ| j' |
|
|||
|
|
« xs | j' d« } | sŒ- n | € y| j) dt+ | « « c S y)a
|
|||
|
|
Return a time delta according to the rules of the given locale.
|
|||
|
|
|
|||
|
|
>>> from datetime import timedelta
|
|||
|
|
>>> format_timedelta(timedelta(weeks=12), locale='en_US')
|
|||
|
|
'3 months'
|
|||
|
|
>>> format_timedelta(timedelta(seconds=1), locale='es')
|
|||
|
|
'1 segundo'
|
|||
|
|
|
|||
|
|
The granularity parameter can be provided to alter the lowest unit
|
|||
|
|
presented, which defaults to a second.
|
|||
|
|
|
|||
|
|
>>> format_timedelta(timedelta(hours=3), granularity='day', locale='en_US')
|
|||
|
|
'1 day'
|
|||
|
|
|
|||
|
|
The threshold parameter can be used to determine at which value the
|
|||
|
|
presentation switches to the next higher unit. A higher threshold factor
|
|||
|
|
means the presentation will switch later. For example:
|
|||
|
|
|
|||
|
|
>>> format_timedelta(timedelta(hours=23), threshold=0.9, locale='en_US')
|
|||
|
|
'1 day'
|
|||
|
|
>>> format_timedelta(timedelta(hours=23), threshold=1.1, locale='en_US')
|
|||
|
|
'23 hours'
|
|||
|
|
|
|||
|
|
In addition directional information can be provided that informs
|
|||
|
|
the user if the date is in the past or in the future:
|
|||
|
|
|
|||
|
|
>>> format_timedelta(timedelta(hours=1), add_direction=True, locale='en')
|
|||
|
|
'in 1 hour'
|
|||
|
|
>>> format_timedelta(timedelta(hours=-1), add_direction=True, locale='en')
|
|||
|
|
'1 hour ago'
|
|||
|
|
|
|||
|
|
The format parameter controls how compact or wide the presentation is:
|
|||
|
|
|
|||
|
|
>>> format_timedelta(timedelta(hours=3), format='short', locale='en')
|
|||
|
|
'3 hr'
|
|||
|
|
>>> format_timedelta(timedelta(hours=3), format='narrow', locale='en')
|
|||
|
|
'3h'
|
|||
|
|
|
|||
|
|
:param delta: a ``timedelta`` object representing the time difference to
|
|||
|
|
format, or the delta in seconds as an `int` value
|
|||
|
|
:param granularity: determines the smallest unit that should be displayed,
|
|||
|
|
the value can be one of "year", "month", "week", "day",
|
|||
|
|
"hour", "minute" or "second"
|
|||
|
|
:param threshold: factor that determines at which point the presentation
|
|||
|
|
switches to the next higher unit
|
|||
|
|
:param add_direction: if this flag is set to `True` the return value will
|
|||
|
|
include directional information. For instance a
|
|||
|
|
positive timedelta will include the information about
|
|||
|
|
it being in the future, a negative will be information
|
|||
|
|
about the value being in the past.
|
|||
|
|
:param format: the format, can be "narrow", "short" or "long". (
|
|||
|
|
"medium" is deprecated, currently converted to "long" to
|
|||
|
|
maintain compatibility)
|
|||
|
|
:param locale: a `Locale` object or a locale identifier. Defaults to the system time locale.
|
|||
|
|
)Únarrowr r r z1Format must be one of "narrow", "short" or "long"r zU"medium" value for format param of format_timedelta is deprecated. Use "long" insteadé )ÚcategoryÚ
|
|||
|
|
stacklevelr rÉ Ú date_fieldsÚ
|
|||
|
|
unit_patternsc 3 óø •K — ‰r1‰j | › d‰› �« xs ‰| }‰dk\ r|d –— n|d –— d| › �} ‰j | i « }|j ‰« –— ‰dv r|j d« –— y y w)Nú-r ÚfutureÚpastz duration-)r rÏ r )r“ )Úa_unitÚunit_rel_patternsÚ unit_patsÚ
|
|||
|
|
add_directionrÓ r r| rÔ s €€€€€r$ Ú_iter_patternsz(format_timedelta.<locals>._iter_patternsá sš øè ø€ Ù ð !,§¡°6°(¸!¸F¸8Ð0DÓ EÒ \ÈÐU[ÑI\Рؘ!Š|Ø'¨Ñ1Ó1à'¨Ñ/Ò/Ø ˜V˜HÐ%ˆØ!×%Ñ% f¨bÓ1ˆ Ø�m‰m˜FÓ#Ò#ð
|
|||
|
|
Ð'Ñ 'Ø—-‘- Ó(Ó (ð (ùs ƒA7A:r rŠ NÚotherr¶ r· )Ú TypeErrorÚwarningsÚwarnÚDeprecationWarningr+ r( Ú timedeltar. rZ r| r
|
|||
|
|
rR r Ú_datarÍ ÚabsÚmaxÚroundÚ plural_formr“ r r, )ÚdeltaÚ granularityÚ thresholdrÜ r rW rÝ ÚunitÚ
|
|||
|
|
secs_per_unitr rè r‚ rn rÓ r| rÔ s `` @@@r$ Úformat_timedeltarî ‰ sx ü€ ðN Ð:Ñ:ÜÐKÓLÐLØ
|
|||
|
|
�ÒÜ�
|
|||
|
|
‰
|
|||
|
|
Ø cÜ'Øõ
|
|||
|
|
ð
|
|||
|
|
ˆÜ�%œ×+Ñ+Ô,Ü�u—z‘z EÑ)¨U¯]©]Ñ:Ó;‰àˆÜ
|
|||
|
|
�\‰\˜&Ò+¤GÓ
|
|||
|
|
,€FØ—,‘,˜}Ñ-€KØ—L‘L Ñ1€M÷)ð )ô& /ò 6шˆmÜ�G“ ˜}Ñ,ˆØ �IÒ ¨Ó!4Ø�{Ò" u¨q¢yܘA˜u›
|
|||
|
|
�Üœ˜e› Ó%ˆEØ ×,Ñ,¨UÓ3ˆK؈GÙ *¨4Ó 0ò
|
|||
|
|
�ØÑ'Ø &Ÿl™l¨;Ó 7Ò P¸8¿<¹<ÈÓ;P�GÚ Ù ð
|
|||
|
|
ð ˆÙØ—?‘? 5¬#¨e«*Ó5Ò 5ð!6ð$ r& c ó\ ‡‡‡— ‰‰j v rˆˆˆfd„}n;t d„ | |fD « « rˆfd„}n!t d„ | |fD « « rˆˆfd„}nˆˆfd„} || « } ||« }||k( r || « S ‰j j d d« j d|« j d |« S )
|
|||
|
|
Nc ó" •— t ‰| ‰‰¬« S ©Nr¦ )rÄ )r# rW r r s €€€r$ ú<lambda>z+_format_fallback_interval.<locals>.<lambda> s ø€ œO¨H°b¸&ÈÔ P€ r& c 3 óŠ K — | ]; }t |t j « xr t |t j « –— Œ= y w©N)r+ r( r> ©Ú.0Úds r$ ú <genexpr>z,_format_fallback_interval.<locals>.<genexpr> s= è ø€ ò
|
|||
|
|
ð
|
|||
|
|
ô
|
|||
|
|
�A”x—}‘}Ó %Ò N¬j¸¼H×<MÑ<MÓ.NÐ*NÓ Nñ
|
|||
|
|
ùó ‚AAc ó •— t | ‰¬« S rñ )r³ )r# rW s €r$ rò z+_format_fallback_interval.<locals>.<lambda> s ø€ œK¨°6Ô :€ r& c 3 óŠ K — | ]; }t |t j « xr t |t j « –— Œ= y wrô )r+ r( r0 r> rõ s r$ rø z,_format_fallback_interval.<locals>.<genexpr> s; è ø€ ò
|
|||
|
|
ð
|
|||
|
|
ô
|
|||
|
|
�A”x—}‘}Ó %Ò J¬j¸¼H¿M¹MÓ.JÐ*JÓ Jñ
|
|||
|
|
ùrù c ó •— t | ‰‰¬« S ©Nr¸ )rº ©r# rW r s €€r$ rò z+_format_fallback_interval.<locals>.<lambda> s ø€ œK¨°6À&Ô I€ r& c ó •— t | ‰‰¬« S rý )r» rþ s €€r$ rò z+_format_fallback_interval.<locals>.<lambda> s ø€ œO¨B°vÀfÔ M€ r& z{0}-{1}r· r¹ )rÀ ÚallÚinterval_formatsr“ r )ÚstartÚendr r rW r Úformatted_startÚ
|
|||
|
|
formatted_ends ``` r$ Ú_format_fallback_intervalr s» ú€ ð �6×,Ñ,Ñ,ÝP‰Ü ñ
|
|||
|
|
ð ˜� ô
|
|||
|
|
ô
|
|||
|
|
ó
|
|||
|
|
;‰Ü ñ
|
|||
|
|
ð ˜� ô
|
|||
|
|
ô
|
|||
|
|
ô
|
|||
|
|
J‰äMˆá ˜U“m€OÙ˜3“K€Mà˜-Ò'Ù�e‹}Ð ð × Ñ ×#Ñ# D¨)Ó4ß ‰�˜Ó (ß ‰�˜
|
|||
|
|
Ó &ðr& c óD ‡— t j ‰xs t « Š‰j }||vs|s$|r|r
|
|||
|
|
t ||« }nd}|st | |||‰« S || }| |k( rt
|
|||
|
|
|| ||‰¬« S t t | « |¬« } t t |« |¬« }t | ‰¬« }t |‰¬« } t D ]U }
|
|||
|
|
|
|
|||
|
|
|v sŒ|j |
|
|||
|
|
« | j |
|
|||
|
|
« k7 sŒ,dj ˆfd„t ||
|
|||
|
|
| |f« D « « c S t | |||‰« S )u)
|
|||
|
|
Format an interval between two instants according to the locale's rules.
|
|||
|
|
|
|||
|
|
>>> from datetime import date, time
|
|||
|
|
>>> format_interval(date(2016, 1, 15), date(2016, 1, 17), "yMd", locale="fi")
|
|||
|
|
'15.–17.1.2016'
|
|||
|
|
|
|||
|
|
>>> format_interval(time(12, 12), time(16, 16), "Hm", locale="en_GB")
|
|||
|
|
'12:12–16:16'
|
|||
|
|
|
|||
|
|
>>> format_interval(time(5, 12), time(16, 16), "hm", locale="en_US")
|
|||
|
|
'5:12\u202fAM\u2009–\u20094:16\u202fPM'
|
|||
|
|
|
|||
|
|
>>> format_interval(time(16, 18), time(16, 24), "Hm", locale="it")
|
|||
|
|
'16:18–16:24'
|
|||
|
|
|
|||
|
|
If the start instant equals the end instant, the interval is formatted like the instant.
|
|||
|
|
|
|||
|
|
>>> format_interval(time(16, 18), time(16, 18), "Hm", locale="it")
|
|||
|
|
'16:18'
|
|||
|
|
|
|||
|
|
Unknown skeletons fall back to "default" formatting.
|
|||
|
|
|
|||
|
|
>>> format_interval(date(2015, 1, 1), date(2017, 1, 1), "wzq", locale="ja")
|
|||
|
|
'2015/01/01～2017/01/01'
|
|||
|
|
|
|||
|
|
>>> format_interval(time(16, 18), time(16, 24), "xxx", locale="ja")
|
|||
|
|
'16:18:00～16:24:00'
|
|||
|
|
|
|||
|
|
>>> format_interval(date(2016, 1, 15), date(2016, 1, 17), "xxx", locale="de")
|
|||
|
|
'15.01.2016\u2009–\u200917.01.2016'
|
|||
|
|
|
|||
|
|
:param start: First instant (datetime/date/time)
|
|||
|
|
:param end: Second instant (datetime/date/time)
|
|||
|
|
:param skeleton: The "skeleton format" to use for formatting.
|
|||
|
|
:param tzinfo: tzinfo to use (if none is already attached)
|
|||
|
|
:param fuzzy: If the skeleton is not found, allow choosing a skeleton that's
|
|||
|
|
close enough to it.
|
|||
|
|
:param locale: A locale object or identifier. Defaults to the system time locale.
|
|||
|
|
:return: Formatted interval
|
|||
|
|
N)rà rW r r¦ r¶ c 3 óZ •K — | ]" \ }}t |« j |‰« –— Œ$ y wrô )r± r² )rö r‚ r@ rW s €r$ rø z"format_interval.<locals>.<genexpr>Œ s/ øè ø€ ò á$�G˜Wô ˜gÓ&×,Ñ,¨W°f×=ñùs ƒ(+)r
|
|||
|
|
rR r r rÁ r rÄ rC r1 ÚDateTimeFormatÚPATTERN_CHAR_ORDERÚextractÚjoinÚzip) r r r r rà rW r Ú skel_formatsÚ start_fmtÚend_fmtÚfields ` r$ Úformat_intervalr . s9 ø€ ôb �\‰\˜&Ò+¤GÓ
|
|||
|
|
,€Fð ×.Ñ.ÐàÐ'Ñ'©xñ ™Ü% hÐ0@ÓA‰HàˆHÙä,¨U°C¸À6È6ÓRÐ Rà# HÑ-€Là �‚|Ü ˜x¨°¸eÈFÔSÐSä #¤M°%Ó$8ÀÔ H€EÜ
|
|||
|
|
!¤-°Ó"4¸VÔ
|
|||
|
|
D€Cä ˜u¨VÔ4€IÜ ˜S¨Ô0€Gô $ò ˆØ �LÒ Y×%6Ñ%6°uÓ%=ÀÇ Á ÐQVÓAWÓ%Wð —7‘7ó ä(+¨L¸Ñ,?À%ÈÀ Ó(Nôó ò
|
|||
|
|
ð ô % U¨C°¸6À6Ó JÐJr& c óÈ — t | |« } t | j dz dz | j dz z | j z « }t j |xs t « }|j j |i « j « }|D ] \ }}|D ] }d|v sŒ|d |k( sŒ|c c S Œ! |D ]¨ \ }}|D ]ž }d|v rPd|v rL|d |d k r|d |cxk r|d k r0n n-|c c S |d |cxk rdk sn d|cxk r|d k r n n|c c S dx} }
|
|||
|
|
d|v r
|
|||
|
|
||d k\ rd} d |v r
|
|||
|
|
||d k rd}
|
|||
|
|
d|v r
|
|||
|
|
||d k rd}
|
|||
|
|
d
|
|||
|
|
|v r t d « ‚| sŒ—|
|
|||
|
|
sŒš|c c S Œª |d k ry
|
|||
|
|
y)u�
|
|||
|
|
Get the day period ID for a given time.
|
|||
|
|
|
|||
|
|
This ID can be used as a key for the period name dictionary.
|
|||
|
|
|
|||
|
|
>>> from datetime import time
|
|||
|
|
>>> get_period_names(locale="de")[get_period_id(time(7, 42), locale="de")]
|
|||
|
|
'Morgen'
|
|||
|
|
|
|||
|
|
>>> get_period_id(time(0), locale="en_US")
|
|||
|
|
'midnight'
|
|||
|
|
|
|||
|
|
>>> get_period_id(time(0), type="selection", locale="en_US")
|
|||
|
|
'morning1'
|
|||
|
|
|
|||
|
|
:param time: The time to inspect.
|
|||
|
|
:param tzinfo: The timezone for the time. See ``format_time``.
|
|||
|
|
:param type: The period type to use. Either "selection" or None.
|
|||
|
|
The selection type is used for selecting among phrases such as
|
|||
|
|
“Your email arrived yesterday evening� or “Your email arrived last night�.
|
|||
|
|
:param locale: the `Locale` object, or a locale string. Defaults to the system time locale.
|
|||
|
|
:return: period ID. Something is always returned -- even if it's just "am" or "pm".
|
|||
|
|
ru ÚatÚfromÚbeforerÉ r FTÚtoÚafterz$'after' is deprecated as of CLDR 29.iÀ¨ ÚamÚpm) rF r. rÊ rË rÌ r
|
|||
|
|
rR r Úday_period_rulesr“ ÚitemsÚNotImplementedError) r0 r ÚtyperW Úseconds_past_midnightÚrulesetsÚrule_idÚrulesÚruleÚstart_okÚend_oks r$ Ú
|
|||
|
|
get_period_idr& – s¹ € ô: �T˜6Ó "€DÜ § ¡ ¨B¡°Ñ 3°d·k±kÀBÑ6FÑ FÈÏÉÑ TÓ UÐÜ
|
|||
|
|
�\‰\˜&Ò+¤GÓ
|
|||
|
|
,€Fð ×&Ñ&×*Ñ*¨4°Ó4×:Ñ:Ó<€Hà"ò ‰ˆ�Øò ˆDØ�tŠ| T¡
|
|||
|
|
Ð.CÓ CØ ”ñ ð ð
|
|||
|
|
#ò ‰ˆ�Øò ˆDؘ‰~ (¨dÑ"2ؘ‘< $ x¡.Ò0ؘF‘|Ð'<ÔM¸tÀH¹~ÕMØ &œð ˜V™ Ð(=ÔEÀÔEØ Ð 5ÔF¸¸X¹ÕFà &œà %Ð %ˆH�và˜‰~Ð"7¸4À¹<Ò"GØ �Ø�t‰|Ð 5¸¸d¹Ò Cð �ؘ4Ñ Ð$9¸DÀ¹NÒ$JØ �ؘ$‰Ü)Ð*PÓQÐQâšFØ ”ñ7 ð ð< ˜uÒ$Øàr& c ó — e Zd Zy)Ú
|
|||
|
|
ParseErrorN)Ú__name__Ú
|
|||
|
|
__module__Ú __qualname__© r& r$ r( r( ä s „ Ør& r( c óv — t j d| « }|s t d« ‚|dv }t j d| t j ¬« }|r1|r/ t j t t |j « « Ž S |rt ||¬« }n t |« }|j j « }|j d« }|j! d« } | d k r|j d
|
|||
|
|
« } |j d « }
|
|||
|
|
t# |d f| d
|
|||
|
|
f|
|
|||
|
|
dfg« } t% | « D � �
|
|||
|
|
ci c] \ } }
|
|||
|
|
|
|
|||
|
|
d | “Œ
|
|||
|
|
} } }
|
|||
|
|
|| d }t' |« dk( rdt |« z n
|
|||
|
|
t |« }t || d
|
|||
|
|
« }t || d « }|dkD r||}}t j |||« S # t $ r Y �Œ0w xY wc c}
|
|||
|
|
} w )a Parse a date from a string.
|
|||
|
|
|
|||
|
|
If an explicit format is provided, it is used to parse the date.
|
|||
|
|
|
|||
|
|
>>> parse_date('01.04.2004', format='dd.MM.yyyy')
|
|||
|
|
datetime.date(2004, 4, 1)
|
|||
|
|
|
|||
|
|
If no format is given, or if it is one of "full", "long", "medium",
|
|||
|
|
or "short", the function first tries to interpret the string as
|
|||
|
|
ISO-8601 date format and then uses the date format for the locale
|
|||
|
|
as a hint to determine the order in which the date fields appear in
|
|||
|
|
the string.
|
|||
|
|
|
|||
|
|
>>> parse_date('4/1/04', locale='en_US')
|
|||
|
|
datetime.date(2004, 4, 1)
|
|||
|
|
>>> parse_date('01.04.2004', locale='de_DE')
|
|||
|
|
datetime.date(2004, 4, 1)
|
|||
|
|
>>> parse_date('2004-04-01', locale='en_US')
|
|||
|
|
datetime.date(2004, 4, 1)
|
|||
|
|
>>> parse_date('2004-04-01', locale='de_DE')
|
|||
|
|
datetime.date(2004, 4, 1)
|
|||
|
|
>>> parse_date('01.04.04', locale='de_DE', format='short')
|
|||
|
|
datetime.date(2004, 4, 1)
|
|||
|
|
|
|||
|
|
:param string: the string containing the date
|
|||
|
|
:param locale: a `Locale` object or a locale identifier
|
|||
|
|
:param locale: a `Locale` object or a locale identifier. Defaults to the system time locale.
|
|||
|
|
:param format: the format to use, either an explicit date format,
|
|||
|
|
or one of "full", "long", "medium", or "short"
|
|||
|
|
(see ``get_time_format``)
|
|||
|
|
ú(\d+)ú No numbers were found in inputr z ^(\d{4})-?([01]\d)-?([0-3]\d)$)Úflagsri ÚyÚmr Úlr÷ ÚYÚMÚDrŠ rÐ iÐ é )ÚreÚfindallr( ÚmatchÚASCIIr( r> Úmapr. Úgroupsr¨ rj r± r‚ ÚlowerÚindexÚfindÚsortedÚ enumerater– )ÚstringrW r ÚnumbersÚuse_predefined_formatÚ iso_alikeÚfmtÚ
|
|||
|
|
format_strÚyear_idxÚ month_idxÚday_idxÚindexesÚidxÚitemrÅ rÆ rÈ s r$ Ú
|
|||
|
|
parse_daterO è s½ € ôH �j‰j˜ 6Ó*€GÙ ÜÐ9Ó:Ð:à "Ð&IÐ IÐô —‘Ø)ØÜ�h‰hô€Iñ
|
|||
|
|
Ñ*ð Ü—=‘=¤#¤c¨9×+;Ñ+;Ó+=Ó">Ð?Ð ?ñ Ü V°FÔ;‰ä˜FÓ#ˆØ—‘×"Ñ"Ó$€JØ× Ñ Ó$€HØ—‘ Ó$€IØ�1‚}Ø ×$Ñ$ SÓ)ˆ Ø× Ñ ˜sÓ#€Gä�x �o¨ °3Ð'7¸'À3¸ ÐHÓI€GÜ-6°wÓ-?×@¡ Tˆt�A‰w˜‰|Ð@€GÑ@ð
|
|||
|
|
�7˜3‘<Ñ €DÜ " 4›y¨Aš~ˆ4”#�d“)Ò ´3°t³9€DÜ �˜ ™ Ñ%Ó &€EÜ
|
|||
|
|
|
|||
|
|
ˆg�g˜c‘lÑ#Ó
|
|||
|
|
$€CØ ˆr‚zؘ%ˆsˆÜ �=‰=˜˜u cÓ *Ð*øô5 ò Ú ð üó As Á-F% Ä!F5Æ% F2Æ1F2c óö — t j d| « }|s t d« ‚|dv rt ||¬« }n t |« }|j
|
|||
|
|
j
|
|||
|
|
« }|j d« }|dk r|j d« }|j d« }|j d « x}dk rt j }t |d
|
|||
|
|
f|d f|d fg« } t | « D �
|
|||
|
|
� ci c] \ }
|
|||
|
|
} | d
|
|||
|
|
|
|
|||
|
|
“Œ
|
|||
|
|
} }
|
|||
|
|
} d} d|v rd| j
|
|||
|
|
« v rd} dx}
|
|||
|
|
}t || d
|
|||
|
|
« | z }t |« d
|
|||
|
|
kD r0t || d « }
|
|||
|
|
t |« dkD rt || d « }t j ||
|
|||
|
|
|« S c c} }
|
|||
|
|
w )a Parse a time from a string.
|
|||
|
|
|
|||
|
|
This function uses the time format for the locale as a hint to determine
|
|||
|
|
the order in which the time fields appear in the string.
|
|||
|
|
|
|||
|
|
If an explicit format is provided, the function will use it to parse
|
|||
|
|
the time instead.
|
|||
|
|
|
|||
|
|
>>> parse_time('15:30:00', locale='en_US')
|
|||
|
|
datetime.time(15, 30)
|
|||
|
|
>>> parse_time('15:30:00', format='H:mm:ss')
|
|||
|
|
datetime.time(15, 30)
|
|||
|
|
|
|||
|
|
:param string: the string containing the time
|
|||
|
|
:param locale: a `Locale` object or a locale identifier. Defaults to the system time locale.
|
|||
|
|
:param format: the format to use, either an explicit time format,
|
|||
|
|
or one of "full", "long", "medium", or "short"
|
|||
|
|
(see ``get_time_format``)
|
|||
|
|
:return: the parsed time
|
|||
|
|
:rtype: `time`
|
|||
|
|
r. r/ r ri Úhr Úkr2 ÚsÚHr5 ÚSrŠ Úar r7 rÐ )r8 r9 r( rr r± r‚ r> r@ r? ÚmathÚinfrA rB r. r– r( r0 )rC rW r rD rG rH Úhour_idxÚmin_idxÚsec_idxrL rM rN Ú hour_offsetrË rÌ rÊ s r$ Ú
|
|||
|
|
parse_timer] 8 s‡ € ô4 �j‰j˜ 6Ó*€GÙ ÜÐ9Ó:Ð:ð Ð4Ñ4Ü V°FÔ;‰ä˜FÓ#ˆØ—‘×"Ñ"Ó$€JØ�‰˜sÓ#€HØ�!‚|Ø ×#Ñ# CÓ(ˆØ× Ñ ˜sÓ#€Gà —?‘? 3Ó'Ð'ˆ¨1Ò,Ü—(‘(ˆä�x �o¨° ~¸À°~ÐFÓG€GÜ-6°wÓ-?×@¡ Tˆt�A‰w˜‰|Ð@€GÑ@ð €KØ
|
|||
|
|
ˆjјT V§\¡\£^Ñ 3؈ ð ЀFˆVÜ ˆw�w˜s‘|Ñ$Ó %¨ Ñ 3€DÜ
|
|||
|
|
ˆ7ƒ|�aÒÜ�W˜W S™\Ñ*Ó+ˆÜ ˆw‹<˜!Ò Ü˜ ¨¡ Ñ.Ó/ˆFÜ �=‰=˜˜v vÓ .Ð.ùó# As ÃE5c óF — e Zd Zdd„Zdd„Zdd„Zd d„Z d
|
|||
|
|
d d„Zy) rf c ó — || _ || _ y rô )r‚ r )Úselfr‚ r s r$ Ú__init__zDateTimePattern.__init__z s € Ø ˆŒ Ø ˆ� r& c óN — dt | « j › d| j ›d�S )Nú<r� ú>)r r) r‚ ©r` s r$ Ú__repr__zDateTimePattern.__repr__~ s' € Ø”4˜“:×&Ñ&Ð' q¨¯ © Ð(8¸Ð:Ð:r& c ó — | j }|S rô ©r‚ )r` Úpats r$ Ú__str__zDateTimePattern.__str__� s € Ø�l‰lˆØˆ
|
|||
|
|
r& c óL — t |t « st S | j |z S rô )r+ r ÚNotImplementedr )r` rÞ s r$ Ú__mod__zDateTimePattern.__mod__… s! € ܘ%¤ Ô0Ü!Ð !Ø�{‰{˜UÑ"Ð"r& Nc ó" — | t |||« z S rô )r )r` r( rW r½ s r$ r² zDateTimePattern.applyŠ s € ð ”n X¨v°~ÓFÑFÐFr& )r‚ r, r r ©Úreturnr, )rÞ r rp r, rô )r( ú datetime.date | datetime.timerW úLocale | str | Noner½ údatetime.date | Nonerp r, )r) r* r+ ra rf rj rm r² r, r& r$ rf rf y sK „ ó ó;óó#ð 04ð Gà/ðGð $ðGð -ð Gð
|
|||
|
|
|
|||
|
|
|
|||
|
|
ô Gr& c óÂ — e Zd Z d dd„Zdd„Zdd„Zdd„Zdd„Zdd„Zdd„Z dd „Z
|
|||
|
|
ddd
|
|||
|
|
„Z d d „Z d d „Z
|
|||
|
|
dd
|
|||
|
|
„Zd d„Zd„ Zdd„Zd d„Zdd d„Zd d„Zd d„Zdd!d„Zy)"r Nc ób — t |t j t j t j f« sJ ‚t |t j t j f« r"|j €|j t ¬« }|| _ t j |« | _
|
|||
|
|
|| _ y )Nr ) r+ r( r> r0 r r r/ r r
|
|||
|
|
rR rW r½ )r` r rW r½ s r$ ra zDateTimeFormat.__init__” sz € ô ˜%¤(§-¡-´×1BÑ1BÄHÇMÁMÐ!RÔSÐSÐSÜ �eœh× /Ñ /´· ± Ð ?Ô @ÀUÇ\Á\ÐEYØ—M‘M¬�MÓ-ˆE؈Œ
|
|||
|
|
Ü —l‘l 6Ó*ˆŒ Ø ,ˆÕr& c óf — |d }t |« }|dk( r| j ||« S |dv r| j ||« S |dv r| j ||« S |dv r| j ||« S |dv r| j ||« S |dk( r&| j
|
|||
|
|
| j j |« S |dk( r| j |« S |d k( r| j « S |d
|
|||
|
|
v r| j ||« S |d v r| j ||« S |d k( rW| j j d
|
|||
|
|
z dk( r| j
|
|||
|
|
d
|
|||
|
|
|« S | j
|
|||
|
|
| j j d
|
|||
|
|
z |« S |dk( r&| j
|
|||
|
|
| j j |« S |dk( r)| j
|
|||
|
|
| j j d
|
|||
|
|
z |« S |dk( rQ| j j dk( r| j
|
|||
|
|
d|« S | j
|
|||
|
|
| j j |« S |dk( r&| j
|
|||
|
|
| j j |« S |dk( r&| j
|
|||
|
|
| j j |« S |dk( r| j! |« S |dk( r| j# |« S |dv r| j% ||« S t' d|›�« ‚)Nr ÚG)r1 r4 Úu©ÚQÚq©r5 ÚL)ÚwÚWr÷ r6 ÚF)ÚErO Úc)rV ÚbÚBrQ r7 rT ÚKrR rt r2 rS rU ÚA)Úzrw ÚvÚVÚxÚXÚOz Unsupported date/time field )r– Ú
|
|||
|
|
format_eraÚ format_yearÚformat_quarterÚ format_monthÚ format_weekr r rÈ Úformat_day_of_yearÚformat_day_of_week_in_monthÚformat_weekdayÚ
|
|||
|
|
format_periodrÊ rË rÌ Úformat_frac_secondsÚformat_milliseconds_in_dayÚformat_timezoneÚKeyError)r` r® ÚcharÚnums r$ Ú __getitem__zDateTimeFormat.__getitem__¡ s� € Ø�A‰wˆÜ�$‹iˆØ �3Š;Ø—?‘? 4¨Ó-Ð -Ø
|
|||
|
|
�_Ñ
|
|||
|
|
$Ø×#Ñ# D¨#Ó.Ð .Ø
|
|||
|
|
�ZÑ
|
|||
|
|
Ø×&Ñ& t¨SÓ1Ð 1Ø
|
|||
|
|
�ZÑ
|
|||
|
|
Ø×$Ñ$ T¨3Ó/Ð /Ø
|
|||
|
|
�ZÑ
|
|||
|
|
Ø×#Ñ# D¨#Ó.Ð .Ø
|
|||
|
|
�SŠ[Ø—;‘;˜tŸz™zŸ~™~¨sÓ3Ð 3Ø
|
|||
|
|
�SŠ[Ø×*Ñ*¨3Ó/Ð /Ø
|
|||
|
|
�SŠ[Ø×3Ñ3Ó5Ð 5Ø
|
|||
|
|
�_Ñ
|
|||
|
|
$Ø×&Ñ& t¨SÓ1Ð 1Ø
|
|||
|
|
�_Ñ
|
|||
|
|
$Ø×%Ñ% d¨CÓ0Ð 0Ø
|
|||
|
|
�SŠ[Ø�z‰z�‰ Ñ# qÒ(Ø—{‘{ 2 sÓ+Ð+à—{‘{ 4§:¡:§?¡?°RÑ#7¸Ó=Ð=Ø
|
|||
|
|
�SŠ[Ø—;‘;˜tŸz™zŸ™°Ó4Ð 4Ø
|
|||
|
|
�SŠ[Ø—;‘;˜tŸz™zŸ™°Ñ 3°SÓ9Ð 9Ø
|
|||
|
|
�SŠ[Ø�z‰z�‰ !Ò#Ø—{‘{ 2 sÓ+Ð+à—{‘{ 4§:¡:§?¡?°CÓ8Ð8Ø
|
|||
|
|
�SŠ[Ø—;‘;˜tŸz™z× 0Ñ 0°#Ó6Ð 6Ø
|
|||
|
|
�SŠ[Ø—;‘;˜tŸz™z× 0Ñ 0°#Ó6Ð 6Ø
|
|||
|
|
�SŠ[Ø×+Ñ+¨CÓ0Ð 0Ø
|
|||
|
|
�SŠ[Ø×2Ñ2°3Ó7Ð 7Ø
|
|||
|
|
Ð8Ñ
|
|||
|
|
8Ø×'Ñ'¨¨cÓ2Ð 2äÐ 9¸$¸ÐBÓCÐ Cr& c óô — t |« d }|dk( r| j j S |dk( r| j j S |dk( r| j j S |dk( r| j j
|
|||
|
|
S |dk( r | j j
|
|||
|
|
dz xs dS |dk( r| j j S |d k( r"t | j j
|
|||
|
|
dk\ « S t d
|
|||
|
|
|›d | j ›�« ‚) Nr r1 r5 r÷ rT rQ r7 r2 rV z Not implemented: extracting z from ) r, r rÅ rÆ rÈ rÊ rË r. r )r` rš s r$ r zDateTimeFormat.extractÓ sÛ € Ü�4‹y˜‰|ˆØ �3Š;Ø—:‘:—?‘?Ð "Ø
|
|||
|
|
�SŠ[Ø—:‘:×#Ñ#Ð #Ø
|
|||
|
|
�SŠ[Ø—:‘:—>‘>Ð !Ø
|
|||
|
|
�SŠ[Ø—:‘:—?‘?Ð "Ø
|
|||
|
|
�SŠ[Ø—:‘:—?‘? RÑ'Ò-¨2Ð -Ø
|
|||
|
|
�SŠ[Ø—:‘:×$Ñ$Ð $Ø
|
|||
|
|
�SŠ[Ü�t—z‘z—‘¨"Ñ,Ó-Ð -ä%Ø.¨t¨h°f¸T¿Z¹Z¸NÐKóð
|
|||
|
|
r& c óž — ddddœt d|« }t | j j dk\ « }t || j
|
|||
|
|
« | S )NÚ abbreviatedÚwiderÏ ©é é é r¢ r )ræ r. r rÅ re rW )r` rš r› rU Úeras r$ r� zDateTimeFormat.format_eraè sF € Ø! f°Ñ:¼3¸qÀ#»;ÑGˆÜ�$—*‘*—/‘/ QÑ&Ó'ˆÜ ˜U D§K¡KÓ0°Ñ5Ð5r& c ó� — | j j }|j « rƒ| j j }|dk( r2| j j dk r| j « dk\ r|dz }n6|dk( r1| j j dkD r| j « dk r|dz
|
|||
|
|
}| j
|
|||
|
|
||« }|dk( r|dd }|S )NrŠ é é4 r7 é rÐ éþÿÿÿ)r rÅ ÚisupperrÆ rÈ Úget_week_of_yearr )r` rš r› r rÆ rÅ s r$ rŽ zDateTimeFormat.format_yearí s® € Ø—
|
|||
|
|
‘
|
|||
|
|
—‘ˆØ �<‰<Œ>Ø—J‘J×$Ñ$ˆEؘŠz˜dŸj™jŸn™n¨qÒ 0°T×5JÑ5JÓ5LÐPRÒ5Rؘ‘
|
|||
|
|
‘ؘ"’ §¡§ ¡ °"Ò!4¸×9NÑ9NÓ9PÐTUÒ9Uؘ‘
|
|||
|
|
�Ø�{‰{˜5 #Ó&ˆØ �!Š8ؘ˜�9ˆD؈ r& c ó® — | j j dz
|
|||
|
|
dz dz }|dk rd||fz S ddddœ| }d d
|
|||
|
|
d œ| }t ||| j « | S ) NrŠ r¢ rÐ ú%0*drŸ r rÏ r¡ r r ry )r rÆ ra rW )r` rš r› ÚquarterrU rV s r$ r� z DateTimeFormat.format_quarterú sn € Ø—:‘:×#Ñ# aÑ'¨AÑ-°Ñ1ˆØ �!Š8ؘS '˜NÑ*Ð *Ø! f°Ñ:¸3Ñ?ˆØ }Ñ5°dÑ;ˆÜ ¨°·±Ó=¸gÑFÐFr& c óÀ — |dk rd|| j j fz S ddddœ| }ddd œ| }t ||| j « | j j S )
|
|||
|
|
NrÐ r® rŸ r rÏ r¡ r r r| )r rÆ r^ rW )r` rš r› rU rV s r$ r� zDateTimeFormat.format_month se € Ø �!Š8ؘS $§*¡*×"2Ñ"2Ð 3Ñ3Ð 3Ø! f°Ñ:¸3Ñ?ˆØ }Ñ5°dÑ;ˆÜ ˜u g¨t¯{©{Ó;¸D¿J¹J×<LÑ<LÑMÐMr& c óœ — |j « r"| j « }| j ||« S | j « }t |« S rô )Úislowerr¬ r Úget_week_of_monthr, )r` rš r› rÇ s r$ r‘ zDateTimeFormat.format_week sB € Ø �<‰<Œ>Ø×(Ñ(Ó*ˆDØ—;‘;˜t SÓ)Ð )à×)Ñ)Ó+ˆDÜ�t“9Ð r& c óV — |dk r^|j « rLd| j j z
|
|||
|
|
| j j « z }| j |dz dz |« S d}| j j « }dddddœ| }|d k( rd
|
|||
|
|
nd }t
|
|||
|
|
||| j « | S ) a�
|
|||
|
|
Return weekday from parsed datetime according to format pattern.
|
|||
|
|
|
|||
|
|
>>> from datetime import date
|
|||
|
|
>>> format = DateTimeFormat(date(2016, 2, 28), Locale.parse('en_US'))
|
|||
|
|
>>> format.format_weekday()
|
|||
|
|
'Sunday'
|
|||
|
|
|
|||
|
|
'E': Day of week - Use one through three letters for the abbreviated day name, four for the full (wide) name,
|
|||
|
|
five for the narrow name, or six for the short name.
|
|||
|
|
>>> format.format_weekday('E',2)
|
|||
|
|
'Sun'
|
|||
|
|
|
|||
|
|
'e': Local day of week. Same as E except adds a numeric value that will depend on the local starting day of the
|
|||
|
|
week, using one or two letters. For this example, Monday is the first day of the week.
|
|||
|
|
>>> format.format_weekday('e',2)
|
|||
|
|
'01'
|
|||
|
|
|
|||
|
|
'c': Stand-Alone local day of week - Use one letter for the local numeric value (same as 'e'), three for the
|
|||
|
|
abbreviated day name, four for the full (wide) name, five for the narrow name, or six for the short name.
|
|||
|
|
>>> format.format_weekday('c',1)
|
|||
|
|
'1'
|
|||
|
|
|
|||
|
|
:param char: pattern format character ('e','E','c')
|
|||
|
|
:param num: count of format character
|
|||
|
|
|
|||
|
|
r¢ r§ rŠ rŸ r rÏ r )r¢ r£ r¤ é r‚ r r )r² rW Úfirst_week_dayr Úweekdayr r[ )r` rš r› r r· rU rV s r$ r” z DateTimeFormat.format_weekday s¢ € ð8 �Š7Ø�|‰|Œ~ؘDŸK™K× 6Ñ 6Ñ6¸¿¹×9KÑ9KÓ9MÑM�Ø—{‘{ 5¨1¡9¨q¡=°#Ó6Ð6؈CØ—*‘*×$Ñ$Ó&ˆØ! f°¸gÑFÀsÑKˆØ#'¨3¢;‘-°HˆÜ ˜U G¨T¯[©[Ó9¸'ÑBÐBr& c óB — | j | j « |« S rô )r Úget_day_of_year)r` r› s r$ r’ z!DateTimeFormat.format_day_of_year7 s € Ø�{‰{˜4×/Ñ/Ó1°3Ó7Ð7r& c óR — t | j j dz
|
|||
|
|
dz dz « S )NrŠ r§ )r, r rÈ re s r$ r“ z*DateTimeFormat.format_day_of_week_in_month: s$ € Ü�D—J‘J—N‘N QÑ&¨1Ñ,¨qÑ0Ó1Ð1r& c óX — ddddœt d|« dddg}|dk( r | j j dk\ rdnd }d
|
|||
|
|
}n*t | j | j ¬ « }|d k( rd
|
|||
|
|
nd
|
|||
|
|
}|D ]% }t ||| j ¬« }||v sŒ || c S t
|
|||
|
|
d|› d| j › �« ‚)u
|
|||
|
|
Return period from parsed datetime according to format pattern.
|
|||
|
|
|
|||
|
|
>>> from datetime import datetime, time
|
|||
|
|
>>> format = DateTimeFormat(time(13, 42), 'fi_FI')
|
|||
|
|
>>> format.format_period('a', 1)
|
|||
|
|
'ip.'
|
|||
|
|
>>> format.format_period('b', 1)
|
|||
|
|
'iltap.'
|
|||
|
|
>>> format.format_period('b', 4)
|
|||
|
|
'iltapäivä'
|
|||
|
|
>>> format.format_period('B', 4)
|
|||
|
|
'iltapäivällä'
|
|||
|
|
>>> format.format_period('B', 5)
|
|||
|
|
'ip.'
|
|||
|
|
|
|||
|
|
>>> format = DateTimeFormat(datetime(2022, 4, 28, 6, 27), 'zh_Hant')
|
|||
|
|
>>> format.format_period('a', 1)
|
|||
|
|
'上�'
|
|||
|
|
>>> format.format_period('B', 1)
|
|||
|
|
'清晨'
|
|||
|
|
|
|||
|
|
:param char: pattern format character ('a', 'b', 'B')
|
|||
|
|
:param num: count of format character
|
|||
|
|
|
|||
|
|
rŸ r rÏ r¡ r¢ rV r7 r r r r¦ r„ r )rV rU rW zCould not format period z in )ræ r rÊ r& rW rX r¨ )r` rš r› ÚwidthsÚperiodrV rU Ú period_namess r$ r• z DateTimeFormat.format_period= sÄ € ð8 &¨XÑ 6´s¸1¸c³{Ñ CØ Ø Ø ð
|
|||
|
|
ˆð �3Š;Ø !ŸZ™ZŸ_™_°Ò 2‘T¸ˆFØ ‰Gä" 4§:¡:°d·k±kÔBˆFØ"&¨#¢+‘h°=ˆGØò ,ˆEÜ+°GÀ5ÐQU×Q\ÑQ\Ô]ˆLؘ Ò%Ø# FÑ+Ò+ð ,ô Ð3°F°8¸4ÀÇ Á ¸}ÐMÓNÐNr& c óx — | j j dz }| j t ||« d|z z |« S )zŽ Return fractional seconds.
|
|||
|
|
|
|||
|
|
Rounds the time's microseconds to the precision given by the number of digits passed in.
|
|||
|
|
i@B é
|
|||
|
|
)r Ú microsecondr rç )r` r› r s r$ r– z"DateTimeFormat.format_frac_secondsj s9 € ð —
|