API Guide

`arrow.arrow`

Provides the Arrow class, an enhanced datetime replacement.

class arrow.arrow.Arrow(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, **kwargs)

An Arrow object.

Implements the datetime interface, behaving as an aware datetime while implementing additional functionality.

Parameters:

year (int) – the calendar year.
month (int) – the calendar month.
day (int) – the calendar day.
hour (int) – (optional) the hour. Defaults to 0.
minute (int) – (optional) the minute, Defaults to 0.
second (int) – (optional) the second, Defaults to 0.
microsecond (int) – (optional) the microsecond. Defaults to 0.
tzinfo (Union[tzinfo, str, None]) – (optional) A timezone expression. Defaults to UTC.
fold – (optional) 0 or 1, used to disambiguate repeated wall times. Defaults to 0.

Recognized timezone expressions:

A tzinfo object.

A str describing a timezone, similar to ‘US/Pacific’, or ‘Europe/Berlin’.

A str in ISO 8601 style, as in ‘+07:00’.

A str, one of the following: ‘local’, ‘utc’, ‘UTC’.

Usage:

>>> import arrow
>>> arrow.Arrow(2013, 5, 5, 12, 30, 45)
<Arrow [2013-05-05T12:30:45+00:00]>

property ambiguous: bool: Indicates whether the Arrow object is a repeated wall time in the current timezone.

astimezone(tz)

Returns a datetime object, converted to the specified timezone.

Parameters:: tz (Optional[tzinfo]) – a tzinfo object.
Return type:: datetime

Usage:

>>> pacific=arrow.now('US/Pacific')
>>> nyc=arrow.now('America/New_York').tzinfo
>>> pacific.astimezone(nyc)
datetime.datetime(2019, 1, 20, 10, 24, 22, 328172, tzinfo=tzfile('/usr/share/zoneinfo/America/New_York'))

ceil(frame)

Returns a new Arrow object, representing the “ceiling” of the timespan of the Arrow object in a given timeframe. Equivalent to the second element in the 2-tuple returned by span.

Parameters:: frame (Literal['year', 'years', 'month', 'months', 'day', 'days', 'hour', 'hours', 'minute', 'minutes', 'second', 'seconds', 'microsecond', 'microseconds', 'week', 'weeks', 'quarter', 'quarters']) – the timeframe. Can be any datetime property (day, hour, minute…).
Return type:: Arrow

Usage:

>>> arrow.utcnow().ceil('hour')
<Arrow [2013-05-09T03:59:59.999999+00:00]>

clone()

Returns a new Arrow object, cloned from the current one.

Usage: :rtype: Arrow

>>> arw = arrow.utcnow()
>>> cloned = arw.clone()

ctime()

Returns a ctime formatted representation of the date and time.

Usage:

>>> arrow.utcnow().ctime()
'Sat Jan 19 18:26:50 2019'

Return type:: str

date()

Returns a date object with the same year, month and day.

Usage:

>>> arrow.utcnow().date()
datetime.date(2019, 1, 23)

Return type:: date

property datetime: datetime

Returns a datetime representation of the Arrow object.

Usage:

>>> arw=arrow.utcnow()
>>> arw.datetime
datetime.datetime(2019, 1, 24, 16, 35, 27, 276649, tzinfo=tzutc())

dehumanize(input_string, locale='en_us')

Returns a new Arrow object, that represents the time difference relative to the attributes of the Arrow object.

Parameters:

timestring – a str representing a humanized relative time.
locale (str) – (optional) a str specifying a locale. Defaults to ‘en-us’.

Return type:

Arrow

Usage:

>>> arw = arrow.utcnow()
>>> arw
<Arrow [2021-04-20T22:27:34.787885+00:00]>
>>> earlier = arw.dehumanize("2 days ago")
>>> earlier
<Arrow [2021-04-18T22:27:34.787885+00:00]>

>>> arw = arrow.utcnow()
>>> arw
<Arrow [2021-04-20T22:27:34.787885+00:00]>
>>> later = arw.dehumanize("in a month")
>>> later
<Arrow [2021-05-18T22:27:34.787885+00:00]>

dst()

Returns the daylight savings time adjustment.

Usage:

>>> arrow.utcnow().dst()
datetime.timedelta(0)

Return type:: Optional[timedelta]

property float_timestamp: float

Returns a floating-point timestamp representation of the Arrow object, in UTC time.

Usage:

>>> arrow.utcnow().float_timestamp
1548260516.830896

floor(frame)

Returns a new Arrow object, representing the “floor” of the timespan of the Arrow object in a given timeframe. Equivalent to the first element in the 2-tuple returned by span.

Parameters:: frame (Literal['year', 'years', 'month', 'months', 'day', 'days', 'hour', 'hours', 'minute', 'minutes', 'second', 'seconds', 'microsecond', 'microseconds', 'week', 'weeks', 'quarter', 'quarters']) – the timeframe. Can be any datetime property (day, hour, minute…).
Return type:: Arrow

Usage:

>>> arrow.utcnow().floor('hour')
<Arrow [2013-05-09T03:00:00+00:00]>

property fold: int: Returns the fold value of the Arrow object.

for_json()

Serializes for the for_json protocol of simplejson.

Usage:

>>> arrow.utcnow().for_json()
'2019-01-19T18:25:36.760079+00:00'

Return type:: str

format(fmt='YYYY-MM-DD HH:mm:ssZZ', locale='en-us')

Returns a string representation of the Arrow object, formatted according to the provided format string.

Parameters:

fmt (str) – the format string.
locale (str) – the locale to format.

Return type:

str

Usage:

>>> arrow.utcnow().format('YYYY-MM-DD HH:mm:ss ZZ')
'2013-05-09 03:56:47 -00:00'

>>> arrow.utcnow().format('X')
'1368071882'

>>> arrow.utcnow().format('MMMM DD, YYYY')
'May 09, 2013'

>>> arrow.utcnow().format()
'2013-05-09 03:56:47 -00:00'

classmethod fromdate(date, tzinfo=None)

Constructs an Arrow object from a date and optional replacement timezone. All time values are set to 0.

Parameters:

date (date) – the date
tzinfo (Union[tzinfo, str, None]) – (optional) A timezone expression. Defaults to UTC.

Return type:

Arrow

classmethod fromdatetime(dt, tzinfo=None)

Constructs an Arrow object from a datetime and optional replacement timezone.

Parameters:

dt (datetime) – the datetime
tzinfo (Union[tzinfo, str, None]) – (optional) A timezone expression. Defaults to dt’s timezone, or UTC if naive.

Return type:

Arrow

Usage:

>>> dt
datetime.datetime(2021, 4, 7, 13, 48, tzinfo=tzfile('/usr/share/zoneinfo/US/Pacific'))
>>> arrow.Arrow.fromdatetime(dt)
<Arrow [2021-04-07T13:48:00-07:00]>

classmethod fromordinal(ordinal)

Constructs an Arrow object corresponding: to the Gregorian Ordinal.

Parameters:: ordinal (int) – an int corresponding to a Gregorian Ordinal.
Return type:: Arrow

Usage:

>>> arrow.fromordinal(737741)
<Arrow [2020-11-12T00:00:00+00:00]>

classmethod fromtimestamp(timestamp, tzinfo=None)

Constructs an Arrow object from a timestamp, converted to the given timezone.

Parameters:

timestamp (Union[int, float, str]) – an int or float timestamp, or a str that converts to either.
tzinfo (Union[tzinfo, str, None]) – (optional) a tzinfo object. Defaults to local time.

Return type:

Arrow

humanize(other=None, locale='en-us', only_distance=False, granularity='auto')

Returns a localized, humanized representation of a relative difference in time.

Parameters:

other (Union[Arrow, datetime, None]) – (optional) an Arrow or datetime object. Defaults to now in the current Arrow object’s timezone.
locale (str) – (optional) a str specifying a locale. Defaults to ‘en-us’.
only_distance (bool) – (optional) returns only time difference eg: “11 seconds” without “in” or “ago” part.
granularity (Union[Literal['auto', 'second', 'minute', 'hour', 'day', 'week', 'month', 'quarter', 'year'], List[Literal['auto', 'second', 'minute', 'hour', 'day', 'week', 'month', 'quarter', 'year']]]) – (optional) defines the precision of the output. Set it to strings ‘second’, ‘minute’, ‘hour’, ‘day’, ‘week’, ‘month’ or ‘year’ or a list of any combination of these strings

Return type:

str

Usage:

>>> earlier = arrow.utcnow().shift(hours=-2)
>>> earlier.humanize()
'2 hours ago'

>>> later = earlier.shift(hours=4)
>>> later.humanize(earlier)
'in 4 hours'

property imaginary: bool: Indicates whether the :class: Arrow <arrow.arrow.Arrow> object exists in the current timezone.

property int_timestamp: int

Returns an integer timestamp representation of the Arrow object, in UTC time.

Usage:

>>> arrow.utcnow().int_timestamp
1548260567

classmethod interval(frame, start, end, interval=1, tz=None, bounds='[)', exact=False)

Returns an iterator of tuples, each Arrow objects, representing a series of intervals between two inputs.

Parameters:

frame (Literal['year', 'years', 'month', 'months', 'day', 'days', 'hour', 'hours', 'minute', 'minutes', 'second', 'seconds', 'microsecond', 'microseconds', 'week', 'weeks', 'quarter', 'quarters']) – The timeframe. Can be any datetime property (day, hour, minute…).
start (datetime) – A datetime expression, the start of the range.
end (datetime) – (optional) A datetime expression, the end of the range.
interval (int) – (optional) Time interval for the given time frame.
tz (Union[tzinfo, str, None]) – (optional) A timezone expression. Defaults to UTC.
bounds (Literal['[)', '()', '(]', '[]']) – (optional) a str of either ‘()’, ‘(]’, ‘[)’, or ‘[]’ that specifies whether to include or exclude the start and end values in the intervals. ‘(’ excludes the start, ‘[’ includes the start, ‘)’ excludes the end, and ‘]’ includes the end. If the bounds are not specified, the default bound ‘[)’ is used.
exact (bool) – (optional) whether to have the first timespan start exactly at the time specified by start and the final interval truncated so as not to extend beyond end.

Return type:

Iterable[Tuple[Arrow, Arrow]]

Supported frame values: year, quarter, month, week, day, hour, minute, second

Recognized datetime expressions:

An Arrow object.

A datetime object.

Recognized timezone expressions:

A tzinfo object.

A str describing a timezone, similar to ‘US/Pacific’, or ‘Europe/Berlin’.

A str in ISO 8601 style, as in ‘+07:00’.

A str, one of the following: ‘local’, ‘utc’, ‘UTC’.

Usage:

>>> start = datetime(2013, 5, 5, 12, 30)
>>> end = datetime(2013, 5, 5, 17, 15)
>>> for r in arrow.Arrow.interval('hour', start, end, 2):
...     print(r)
...
(<Arrow [2013-05-05T12:00:00+00:00]>, <Arrow [2013-05-05T13:59:59.999999+00:00]>)
(<Arrow [2013-05-05T14:00:00+00:00]>, <Arrow [2013-05-05T15:59:59.999999+00:00]>)
(<Arrow [2013-05-05T16:00:00+00:00]>, <Arrow [2013-05-05T17:59:59.999999+00:0]>)

is_between(start, end, bounds='()')

Returns a boolean denoting whether the Arrow object is between the start and end limits.

Parameters:

start (Arrow) – an Arrow object.
end (Arrow) – an Arrow object.
bounds (Literal['[)', '()', '(]', '[]']) – (optional) a str of either ‘()’, ‘(]’, ‘[)’, or ‘[]’ that specifies whether to include or exclude the start and end values in the range. ‘(’ excludes the start, ‘[’ includes the start, ‘)’ excludes the end, and ‘]’ includes the end. If the bounds are not specified, the default bound ‘()’ is used.

Return type:

bool

Usage:

>>> start = arrow.get(datetime(2013, 5, 5, 12, 30, 10))
>>> end = arrow.get(datetime(2013, 5, 5, 12, 30, 36))
>>> arrow.get(datetime(2013, 5, 5, 12, 30, 27)).is_between(start, end)
True

>>> start = arrow.get(datetime(2013, 5, 5))
>>> end = arrow.get(datetime(2013, 5, 8))
>>> arrow.get(datetime(2013, 5, 8)).is_between(start, end, '[]')
True

>>> start = arrow.get(datetime(2013, 5, 5))
>>> end = arrow.get(datetime(2013, 5, 8))
>>> arrow.get(datetime(2013, 5, 8)).is_between(start, end, '[)')
False

isocalendar()

Returns a 3-tuple, (ISO year, ISO week number, ISO weekday).

Usage:

>>> arrow.utcnow().isocalendar()
(2019, 3, 6)

Return type:: Tuple[int, int, int]

isoformat(sep='T', timespec='auto')

Returns an ISO 8601 formatted representation of the date and time.

Usage:

>>> arrow.utcnow().isoformat()
'2019-01-19T18:30:52.442118+00:00'

Return type:: str

isoweekday()

Returns the ISO day of the week as an integer (1-7).

Usage:

>>> arrow.utcnow().isoweekday()
6

Return type:: int

property naive: datetime

Returns a naive datetime representation of the Arrow object.

Usage:

>>> nairobi = arrow.now('Africa/Nairobi')
>>> nairobi
<Arrow [2019-01-23T19:27:12.297999+03:00]>
>>> nairobi.naive
datetime.datetime(2019, 1, 23, 19, 27, 12, 297999)

classmethod now(tzinfo=None)

Constructs an Arrow object, representing “now” in the given timezone.

Parameters:: tzinfo (Optional[tzinfo]) – (optional) a tzinfo object. Defaults to local time.
Return type:: Arrow

Usage:

>>> arrow.now('Asia/Baku')
<Arrow [2019-01-24T20:26:31.146412+04:00]>

classmethod range(frame, start, end=None, tz=None, limit=None)

Returns an iterator of Arrow objects, representing points in time between two inputs.

Parameters:

frame (Literal['year', 'years', 'month', 'months', 'day', 'days', 'hour', 'hours', 'minute', 'minutes', 'second', 'seconds', 'microsecond', 'microseconds', 'week', 'weeks', 'quarter', 'quarters']) – The timeframe. Can be any datetime property (day, hour, minute…).
start (Union[Arrow, datetime]) – A datetime expression, the start of the range.
end (Union[Arrow, datetime, None]) – (optional) A datetime expression, the end of the range.
tz (Union[tzinfo, str, None]) – (optional) A timezone expression. Defaults to start’s timezone, or UTC if start is naive.
limit (Optional[int]) – (optional) A maximum number of tuples to return.

Return type:

Generator[Arrow, None, None]

NOTE: The end or limit must be provided. Call with end alone to return the entire range. Call with limit alone to return a maximum # of results from the start. Call with both to cap a range at a maximum # of results.

NOTE: tz internally replaces the timezones of both start and end before iterating. As such, either call with naive objects and tz, or aware objects from the same timezone and no tz.

Supported frame values: year, quarter, month, week, day, hour, minute, second, microsecond.

Recognized datetime expressions:

An Arrow object.

A datetime object.

Usage:

>>> start = datetime(2013, 5, 5, 12, 30)
>>> end = datetime(2013, 5, 5, 17, 15)
>>> for r in arrow.Arrow.range('hour', start, end):
...     print(repr(r))
...
<Arrow [2013-05-05T12:30:00+00:00]>
<Arrow [2013-05-05T13:30:00+00:00]>
<Arrow [2013-05-05T14:30:00+00:00]>
<Arrow [2013-05-05T15:30:00+00:00]>
<Arrow [2013-05-05T16:30:00+00:00]>

NOTE: Unlike Python’s range, end may be included in the returned iterator:

>>> start = datetime(2013, 5, 5, 12, 30)
>>> end = datetime(2013, 5, 5, 13, 30)
>>> for r in arrow.Arrow.range('hour', start, end):
...     print(repr(r))
...
<Arrow [2013-05-05T12:30:00+00:00]>
<Arrow [2013-05-05T13:30:00+00:00]>

replace(**kwargs)

Returns a new Arrow object with attributes updated according to inputs.

Use property names to set their value absolutely:

>>> import arrow
>>> arw = arrow.utcnow()
>>> arw
<Arrow [2013-05-11T22:27:34.787885+00:00]>
>>> arw.replace(year=2014, month=6)
<Arrow [2014-06-11T22:27:34.787885+00:00]>

You can also replace the timezone without conversion, using a timezone expression:

>>> arw.replace(tzinfo=tz.tzlocal())
<Arrow [2013-05-11T22:27:34.787885-07:00]>

Return type:: Arrow

shift(**kwargs)

Returns a new Arrow object with attributes updated according to inputs.

Use pluralized property names to relatively shift their current value:

>>> import arrow
>>> arw = arrow.utcnow()
>>> arw
<Arrow [2013-05-11T22:27:34.787885+00:00]>
:rtype: :py:class:`~arrow.arrow.Arrow`

>>> arw.shift(years=1, months=-1)
<Arrow [2014-04-11T22:27:34.787885+00:00]>

Day-of-the-week relative shifting can use either Python’s weekday numbers (Monday = 0, Tuesday = 1 .. Sunday = 6) or using dateutil.relativedelta’s day instances (MO, TU .. SU). When using weekday numbers, the returned date will always be greater than or equal to the starting date.

Using the above code (which is a Saturday) and asking it to shift to Saturday:

>>> arw.shift(weekday=5)
<Arrow [2013-05-11T22:27:34.787885+00:00]>

While asking for a Monday:

>>> arw.shift(weekday=0)
<Arrow [2013-05-13T22:27:34.787885+00:00]>

span(frame, count=1, bounds='[)', exact=False, week_start=1)

Returns a tuple of two new Arrow objects, representing the timespan of the Arrow object in a given timeframe.

Parameters:

frame (Literal['year', 'years', 'month', 'months', 'day', 'days', 'hour', 'hours', 'minute', 'minutes', 'second', 'seconds', 'microsecond', 'microseconds', 'week', 'weeks', 'quarter', 'quarters']) – the timeframe. Can be any datetime property (day, hour, minute…).
count (int) – (optional) the number of frames to span.
bounds (Literal['[)', '()', '(]', '[]']) – (optional) a str of either ‘()’, ‘(]’, ‘[)’, or ‘[]’ that specifies whether to include or exclude the start and end values in the span. ‘(’ excludes the start, ‘[’ includes the start, ‘)’ excludes the end, and ‘]’ includes the end. If the bounds are not specified, the default bound ‘[)’ is used.
exact (bool) – (optional) whether to have the start of the timespan begin exactly at the time specified by start and the end of the timespan truncated so as not to extend beyond end.
week_start (int) – (optional) only used in combination with the week timeframe. Follows isoweekday() where Monday is 1 and Sunday is 7.

Return type:

Tuple[Arrow, Arrow]

Supported frame values: year, quarter, month, week, day, hour, minute, second.

Usage:

>>> arrow.utcnow()
<Arrow [2013-05-09T03:32:36.186203+00:00]>

>>> arrow.utcnow().span('hour')
(<Arrow [2013-05-09T03:00:00+00:00]>, <Arrow [2013-05-09T03:59:59.999999+00:00]>)

>>> arrow.utcnow().span('day')
(<Arrow [2013-05-09T00:00:00+00:00]>, <Arrow [2013-05-09T23:59:59.999999+00:00]>)

>>> arrow.utcnow().span('day', count=2)
(<Arrow [2013-05-09T00:00:00+00:00]>, <Arrow [2013-05-10T23:59:59.999999+00:00]>)

>>> arrow.utcnow().span('day', bounds='[]')
(<Arrow [2013-05-09T00:00:00+00:00]>, <Arrow [2013-05-10T00:00:00+00:00]>)

>>> arrow.utcnow().span('week')
(<Arrow [2021-02-22T00:00:00+00:00]>, <Arrow [2021-02-28T23:59:59.999999+00:00]>)

>>> arrow.utcnow().span('week', week_start=6)
(<Arrow [2021-02-20T00:00:00+00:00]>, <Arrow [2021-02-26T23:59:59.999999+00:00]>)

classmethod span_range(frame, start, end, tz=None, limit=None, bounds='[)', exact=False)

Returns an iterator of tuples, each Arrow objects, representing a series of timespans between two inputs.

Parameters:

frame (Literal['year', 'years', 'month', 'months', 'day', 'days', 'hour', 'hours', 'minute', 'minutes', 'second', 'seconds', 'microsecond', 'microseconds', 'week', 'weeks', 'quarter', 'quarters']) – The timeframe. Can be any datetime property (day, hour, minute…).
start (datetime) – A datetime expression, the start of the range.
end (datetime) – (optional) A datetime expression, the end of the range.
tz (Union[tzinfo, str, None]) – (optional) A timezone expression. Defaults to start’s timezone, or UTC if start is naive.
limit (Optional[int]) – (optional) A maximum number of tuples to return.
bounds (Literal['[)', '()', '(]', '[]']) – (optional) a str of either ‘()’, ‘(]’, ‘[)’, or ‘[]’ that specifies whether to include or exclude the start and end values in each span in the range. ‘(’ excludes the start, ‘[’ includes the start, ‘)’ excludes the end, and ‘]’ includes the end. If the bounds are not specified, the default bound ‘[)’ is used.
exact (bool) – (optional) whether to have the first timespan start exactly at the time specified by start and the final span truncated so as not to extend beyond end.

Return type:

Iterable[Tuple[Arrow, Arrow]]

NOTE: The end or limit must be provided. Call with end alone to return the entire range. Call with limit alone to return a maximum # of results from the start. Call with both to cap a range at a maximum # of results.

NOTE: tz internally replaces the timezones of both start and end before iterating. As such, either call with naive objects and tz, or aware objects from the same timezone and no tz.

Supported frame values: year, quarter, month, week, day, hour, minute, second, microsecond.

Recognized datetime expressions:

An Arrow object.

A datetime object.

NOTE: Unlike Python’s range, end will always be included in the returned iterator of timespans.

Usage:

>>> start = datetime(2013, 5, 5, 12, 30)
>>> end = datetime(2013, 5, 5, 17, 15)
>>> for r in arrow.Arrow.span_range('hour', start, end):
...     print(r)
...
(<Arrow [2013-05-05T12:00:00+00:00]>, <Arrow [2013-05-05T12:59:59.999999+00:00]>)
(<Arrow [2013-05-05T13:00:00+00:00]>, <Arrow [2013-05-05T13:59:59.999999+00:00]>)
(<Arrow [2013-05-05T14:00:00+00:00]>, <Arrow [2013-05-05T14:59:59.999999+00:00]>)
(<Arrow [2013-05-05T15:00:00+00:00]>, <Arrow [2013-05-05T15:59:59.999999+00:00]>)
(<Arrow [2013-05-05T16:00:00+00:00]>, <Arrow [2013-05-05T16:59:59.999999+00:00]>)
(<Arrow [2013-05-05T17:00:00+00:00]>, <Arrow [2013-05-05T17:59:59.999999+00:00]>)

strftime(format)

Formats in the style of datetime.strftime.

Parameters:: format (str) – the format string.
Return type:: str

Usage:

>>> arrow.utcnow().strftime('%d-%m-%Y %H:%M:%S')
'23-01-2019 12:28:17'

classmethod strptime(date_str, fmt, tzinfo=None)

Constructs an Arrow object from a date string and format, in the style of datetime.strptime. Optionally replaces the parsed timezone.

Parameters:

date_str (str) – the date string.
fmt (str) – the format string using datetime format codes.
tzinfo (Union[tzinfo, str, None]) – (optional) A timezone expression. Defaults to the parsed timezone if fmt contains a timezone directive, otherwise UTC.

Return type:

Arrow

Usage:

>>> arrow.Arrow.strptime('20-01-2019 15:49:10', '%d-%m-%Y %H:%M:%S')
<Arrow [2019-01-20T15:49:10+00:00]>

time()

Returns a time object with the same hour, minute, second, microsecond.

Usage:

>>> arrow.utcnow().time()
datetime.time(12, 15, 34, 68352)

Return type:: time

timestamp()

Returns a timestamp representation of the Arrow object, in UTC time.

Usage:

>>> arrow.utcnow().timestamp()
1616882340.256501

Return type:: float

timetuple()

Returns a time.struct_time, in the current timezone.

Usage:

>>> arrow.utcnow().timetuple()
time.struct_time(tm_year=2019, tm_mon=1, tm_mday=20, tm_hour=15, tm_min=17, tm_sec=8, tm_wday=6, tm_yday=20, tm_isdst=0)

Return type:: struct_time

timetz()

Returns a time object with the same hour, minute, second, microsecond and tzinfo.

Usage:

>>> arrow.utcnow().timetz()
datetime.time(12, 5, 18, 298893, tzinfo=tzutc())

Return type:: time

to(tz)

Returns a new Arrow object, converted to the target timezone.

Parameters:: tz (Union[tzinfo, str]) – A timezone expression.
Return type:: Arrow

Usage:

>>> utc = arrow.utcnow()
>>> utc
<Arrow [2013-05-09T03:49:12.311072+00:00]>

>>> utc.to('US/Pacific')
<Arrow [2013-05-08T20:49:12.311072-07:00]>

>>> utc.to(tz.tzlocal())
<Arrow [2013-05-08T20:49:12.311072-07:00]>

>>> utc.to('-07:00')
<Arrow [2013-05-08T20:49:12.311072-07:00]>

>>> utc.to('local')
<Arrow [2013-05-08T20:49:12.311072-07:00]>

>>> utc.to('local').to('utc')
<Arrow [2013-05-09T03:49:12.311072+00:00]>

toordinal()

Returns the proleptic Gregorian ordinal of the date.

Usage:

>>> arrow.utcnow().toordinal()
737078

Return type:: int

property tzinfo: tzinfo

Gets the tzinfo of the Arrow object.

Usage:

>>> arw=arrow.utcnow()
>>> arw.tzinfo
tzutc()

classmethod utcfromtimestamp(timestamp)

Constructs an Arrow object from a timestamp, in UTC time.

Parameters:: timestamp (Union[int, float, str]) – an int or float timestamp, or a str that converts to either.
Return type:: Arrow

classmethod utcnow()

Constructs an Arrow object, representing “now” in UTC time.

Usage:

>>> arrow.utcnow()
<Arrow [2019-01-24T16:31:40.651108+00:00]>

Return type:: Arrow

utcoffset()

Returns a timedelta object representing the whole number of minutes difference from UTC time.

Usage:

>>> arrow.now('US/Pacific').utcoffset()
datetime.timedelta(-1, 57600)

Return type:: Optional[timedelta]

utctimetuple()

Returns a time.struct_time, in UTC time.

Usage:

>>> arrow.utcnow().utctimetuple()
time.struct_time(tm_year=2019, tm_mon=1, tm_mday=19, tm_hour=21, tm_min=41, tm_sec=7, tm_wday=5, tm_yday=19, tm_isdst=0)

Return type:: struct_time

weekday()

Returns the day of the week as an integer (0-6).

Usage:

>>> arrow.utcnow().weekday()
5

Return type:: int

`arrow.factory`

Implements the ArrowFactory class, providing factory methods for common Arrow construction scenarios.

class arrow.factory.ArrowFactory(type=<class 'arrow.arrow.Arrow'>)

A factory for generating Arrow objects.

Parameters:: type (Type[Arrow]) – (optional) the Arrow-based class to construct from. Defaults to Arrow.

get(*args, **kwargs)

Returns an Arrow object based on flexible inputs.

Parameters:

locale – (optional) a str specifying a locale for the parser. Defaults to ‘en-us’.
tzinfo – (optional) a timezone expression or tzinfo object. Replaces the timezone unless using an input form that is explicitly UTC or specifies the timezone in a positional argument. Defaults to UTC.
normalize_whitespace – (optional) a bool specifying whether or not to normalize redundant whitespace (spaces, tabs, and newlines) in a datetime string before parsing. Defaults to false.

Return type:

Arrow

Usage:

>>> import arrow

No inputs to get current UTC time:

>>> arrow.get()
<Arrow [2013-05-08T05:51:43.316458+00:00]>

One Arrow object, to get a copy.

>>> arw = arrow.utcnow()
>>> arrow.get(arw)
<Arrow [2013-10-23T15:21:54.354846+00:00]>

One float or int, convertible to a floating-point timestamp, to get that timestamp in UTC:

>>> arrow.get(1367992474.293378)
<Arrow [2013-05-08T05:54:34.293378+00:00]>

>>> arrow.get(1367992474)
<Arrow [2013-05-08T05:54:34+00:00]>

One ISO 8601-formatted str, to parse it:

>>> arrow.get('2013-09-29T01:26:43.830580')
<Arrow [2013-09-29T01:26:43.830580+00:00]>

One ISO 8601-formatted str, in basic format, to parse it:

>>> arrow.get('20160413T133656.456289')
<Arrow [2016-04-13T13:36:56.456289+00:00]>

One tzinfo, to get the current time converted to that timezone:

>>> arrow.get(tz.tzlocal())
<Arrow [2013-05-07T22:57:28.484717-07:00]>

One naive datetime, to get that datetime in UTC:

>>> arrow.get(datetime(2013, 5, 5))
<Arrow [2013-05-05T00:00:00+00:00]>

One aware datetime, to get that datetime:

>>> arrow.get(datetime(2013, 5, 5, tzinfo=tz.tzlocal()))
<Arrow [2013-05-05T00:00:00-07:00]>

One naive date, to get that date in UTC:

>>> arrow.get(date(2013, 5, 5))
<Arrow [2013-05-05T00:00:00+00:00]>

One time.struct time:

>>> arrow.get(gmtime(0))
<Arrow [1970-01-01T00:00:00+00:00]>

One iso calendar tuple, to get that week date in UTC:

>>> arrow.get((2013, 18, 7))
<Arrow [2013-05-05T00:00:00+00:00]>

Two arguments, a naive or aware datetime, and a replacement timezone expression:

>>> arrow.get(datetime(2013, 5, 5), 'US/Pacific')
<Arrow [2013-05-05T00:00:00-07:00]>

Two arguments, a naive date, and a replacement timezone expression:

>>> arrow.get(date(2013, 5, 5), 'US/Pacific')
<Arrow [2013-05-05T00:00:00-07:00]>

Two arguments, both str, to parse the first according to the format of the second:

>>> arrow.get('2013-05-05 12:30:45 America/Chicago', 'YYYY-MM-DD HH:mm:ss ZZZ')
<Arrow [2013-05-05T12:30:45-05:00]>

Two arguments, first a str to parse and second a list of formats to try:

>>> arrow.get('2013-05-05 12:30:45', ['MM/DD/YYYY', 'YYYY-MM-DD HH:mm:ss'])
<Arrow [2013-05-05T12:30:45+00:00]>

Three or more arguments, as for the direct constructor of an Arrow object:

>>> arrow.get(2013, 5, 5, 12, 30, 45)
<Arrow [2013-05-05T12:30:45+00:00]>

now(tz=None)

Returns an Arrow object, representing “now” in the given timezone.

Parameters:: tz (Union[tzinfo, str, None]) – (optional) A timezone expression. Defaults to local time.
Return type:: Arrow

Usage:

>>> import arrow
>>> arrow.now()
<Arrow [2013-05-07T22:19:11.363410-07:00]>

>>> arrow.now('US/Pacific')
<Arrow [2013-05-07T22:19:15.251821-07:00]>

>>> arrow.now('+02:00')
<Arrow [2013-05-08T07:19:25.618646+02:00]>

>>> arrow.now('local')
<Arrow [2013-05-07T22:19:39.130059-07:00]>

utcnow()

Returns an Arrow object, representing “now” in UTC time.

Usage:

>>> import arrow
>>> arrow.utcnow()
<Arrow [2013-05-08T05:19:07.018993+00:00]>

Return type:: Arrow

`arrow.api`

Provides the default implementation of ArrowFactory methods for use as a module API.

arrow.api.factory(type)

Returns an ArrowFactory for the specified Arrow or derived type.

Parameters:: type (Type[Arrow]) – the type, Arrow or derived.
Return type:: ArrowFactory

arrow.api.get(*args, **kwargs)

Returns an Arrow object based on flexible inputs.

Parameters:

locale – (optional) a str specifying a locale for the parser. Defaults to ‘en-us’.
tzinfo – (optional) a timezone expression or tzinfo object. Replaces the timezone unless using an input form that is explicitly UTC or specifies the timezone in a positional argument. Defaults to UTC.
normalize_whitespace – (optional) a bool specifying whether or not to normalize redundant whitespace (spaces, tabs, and newlines) in a datetime string before parsing. Defaults to false.

Return type:

Arrow

Usage:

>>> import arrow

No inputs to get current UTC time:

>>> arrow.get()
<Arrow [2013-05-08T05:51:43.316458+00:00]>

One Arrow object, to get a copy.

>>> arw = arrow.utcnow()
>>> arrow.get(arw)
<Arrow [2013-10-23T15:21:54.354846+00:00]>

One float or int, convertible to a floating-point timestamp, to get that timestamp in UTC:

>>> arrow.get(1367992474.293378)
<Arrow [2013-05-08T05:54:34.293378+00:00]>

>>> arrow.get(1367992474)
<Arrow [2013-05-08T05:54:34+00:00]>

One ISO 8601-formatted str, to parse it:

>>> arrow.get('2013-09-29T01:26:43.830580')
<Arrow [2013-09-29T01:26:43.830580+00:00]>

One ISO 8601-formatted str, in basic format, to parse it:

>>> arrow.get('20160413T133656.456289')
<Arrow [2016-04-13T13:36:56.456289+00:00]>

One tzinfo, to get the current time converted to that timezone:

>>> arrow.get(tz.tzlocal())
<Arrow [2013-05-07T22:57:28.484717-07:00]>

One naive datetime, to get that datetime in UTC:

>>> arrow.get(datetime(2013, 5, 5))
<Arrow [2013-05-05T00:00:00+00:00]>

One aware datetime, to get that datetime:

>>> arrow.get(datetime(2013, 5, 5, tzinfo=tz.tzlocal()))
<Arrow [2013-05-05T00:00:00-07:00]>

One naive date, to get that date in UTC:

>>> arrow.get(date(2013, 5, 5))
<Arrow [2013-05-05T00:00:00+00:00]>

One time.struct time:

>>> arrow.get(gmtime(0))
<Arrow [1970-01-01T00:00:00+00:00]>

One iso calendar tuple, to get that week date in UTC:

>>> arrow.get((2013, 18, 7))
<Arrow [2013-05-05T00:00:00+00:00]>

Two arguments, a naive or aware datetime, and a replacement timezone expression:

>>> arrow.get(datetime(2013, 5, 5), 'US/Pacific')
<Arrow [2013-05-05T00:00:00-07:00]>

Two arguments, a naive date, and a replacement timezone expression:

>>> arrow.get(date(2013, 5, 5), 'US/Pacific')
<Arrow [2013-05-05T00:00:00-07:00]>

Two arguments, both str, to parse the first according to the format of the second:

>>> arrow.get('2013-05-05 12:30:45 America/Chicago', 'YYYY-MM-DD HH:mm:ss ZZZ')
<Arrow [2013-05-05T12:30:45-05:00]>

Two arguments, first a str to parse and second a list of formats to try:

>>> arrow.get('2013-05-05 12:30:45', ['MM/DD/YYYY', 'YYYY-MM-DD HH:mm:ss'])
<Arrow [2013-05-05T12:30:45+00:00]>

Three or more arguments, as for the direct constructor of an Arrow object:

>>> arrow.get(2013, 5, 5, 12, 30, 45)
<Arrow [2013-05-05T12:30:45+00:00]>

arrow.api.now(tz=None)

Returns an Arrow object, representing “now” in the given timezone.

Parameters:: tz (Union[tzinfo, str, None]) – (optional) A timezone expression. Defaults to local time.
Return type:: Arrow

Usage:

>>> import arrow
>>> arrow.now()
<Arrow [2013-05-07T22:19:11.363410-07:00]>

>>> arrow.now('US/Pacific')
<Arrow [2013-05-07T22:19:15.251821-07:00]>

>>> arrow.now('+02:00')
<Arrow [2013-05-08T07:19:25.618646+02:00]>

>>> arrow.now('local')
<Arrow [2013-05-07T22:19:39.130059-07:00]>

arrow.api.utcnow()

Returns an Arrow object, representing “now” in UTC time.

Usage:

>>> import arrow
>>> arrow.utcnow()
<Arrow [2013-05-08T05:19:07.018993+00:00]>

Return type:: Arrow

`arrow.locale`

Provides internationalization for arrow in over 60 languages and dialects.

class arrow.locales.AfrikaansLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Ma', 'Di', 'Wo', 'Do', 'Vr', 'Za', 'So']

day_names: ClassVar[List[str]] = ['', 'Maandag', 'Dinsdag', 'Woensdag', 'Donderdag', 'Vrydag', 'Saterdag', 'Sondag']

future: ClassVar[str] = 'in {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Feb', 'Mrt', 'Apr', 'Mei', 'Jun', 'Jul', 'Aug', 'Sep', 'Okt', 'Nov', 'Des']

month_names: ClassVar[List[str]] = ['', 'Januarie', 'Februarie', 'Maart', 'April', 'Mei', 'Junie', 'Julie', 'Augustus', 'September', 'Oktober', 'November', 'Desember']

names: ClassVar[List[str]] = ['af', 'af-nl']

past: ClassVar[str] = '{0} gelede'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'een dag', 'days': '{0} dae', 'hour': 'uur', 'hours': '{0} ure', 'minute': 'minuut', 'minutes': '{0} minute', 'month': 'een maand', 'months': '{0} maande', 'now': 'nou', 'second': 'n sekonde', 'seconds': '{0} sekondes', 'year': 'een jaar', 'years': '{0} jaar'}

class arrow.locales.AlbanianLocale

and_word: ClassVar[Optional[str]] = 'dhe'

day_abbreviations: ClassVar[List[str]] = ['', 'hën', 'mar', 'mër', 'enj', 'pre', 'sht', 'die']

day_names: ClassVar[List[str]] = ['', 'e hënë', 'e martë', 'e mërkurë', 'e enjte', 'e premte', 'e shtunë', 'e diel']

future: ClassVar[str] = 'në {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'shk', 'mar', 'pri', 'maj', 'qer', 'korr', 'gush', 'sht', 'tet', 'nën', 'dhj']

month_names: ClassVar[List[str]] = ['', 'janar', 'shkurt', 'mars', 'prill', 'maj', 'qershor', 'korrik', 'gusht', 'shtator', 'tetor', 'nëntor', 'dhjetor']

names: ClassVar[List[str]] = ['sq', 'sq-al']

past: ClassVar[str] = '{0} më parë'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'ditë', 'days': '{0} ditë', 'hour': 'orë', 'hours': '{0} orë', 'minute': 'minutë', 'minutes': '{0} minuta', 'month': 'muaj', 'months': '{0} muaj', 'now': 'tani', 'second': 'sekondë', 'seconds': '{0} sekonda', 'week': 'javë', 'weeks': '{0} javë', 'year': 'vit', 'years': '{0} vjet'}

class arrow.locales.AlgeriaTunisiaArabicLocale

month_abbreviations: ClassVar[List[str]] = ['', 'جانفي', 'فيفري', 'مارس', 'أفريل', 'ماي', 'جوان', 'جويلية', 'أوت', 'سبتمبر', 'أكتوبر', 'نوفمبر', 'ديسمبر']

month_names: ClassVar[List[str]] = ['', 'جانفي', 'فيفري', 'مارس', 'أفريل', 'ماي', 'جوان', 'جويلية', 'أوت', 'سبتمبر', 'أكتوبر', 'نوفمبر', 'ديسمبر']

names: ClassVar[List[str]] = ['ar-tn', 'ar-dz']

class arrow.locales.AmharicLocale

and_word: ClassVar[Optional[str]] = 'እና'

day_abbreviations: ClassVar[List[str]] = ['', 'እ', 'ሰ', 'ማ', 'ረ', 'ሐ', 'ዓ', 'ቅ']

day_names: ClassVar[List[str]] = ['', 'ሰኞ', 'ማክሰኞ', 'ረቡዕ', 'ሐሙስ', 'ዓርብ', 'ቅዳሜ', 'እሑድ']

describe(timeframe, delta=1, only_distance=False)

Describes a delta within a timeframe in plain language.

Parameters:

timeframe (Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years']) – a string representing a timeframe.
delta (Union[float, int]) – a quantity representing a delta in a timeframe.
only_distance (bool) – return only distance eg: “11 seconds” without “in” or “ago” keywords

Return type:

str

future: ClassVar[str] = '{0} ውስጥ'

month_abbreviations: ClassVar[List[str]] = ['', 'ጃንዩ', 'ፌብሩ', 'ማርች', 'ኤፕሪ', 'ሜይ', 'ጁን', 'ጁላይ', 'ኦገስ', 'ሴፕቴ', 'ኦክቶ', 'ኖቬም', 'ዲሴም']

month_names: ClassVar[List[str]] = ['', 'ጃንዩወሪ', 'ፌብሩወሪ', 'ማርች', 'ኤፕሪል', 'ሜይ', 'ጁን', 'ጁላይ', 'ኦገስት', 'ሴፕቴምበር', 'ኦክቶበር', 'ኖቬምበር', 'ዲሴምበር']

names: ClassVar[List[str]] = ['am', 'am-et']

past: ClassVar[str] = '{0} በፊት'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': {'future': 'በአንድ ቀን', 'past': 'ከአንድ ቀን'}, 'days': {'future': 'በ {0} ቀናት', 'past': 'ከ {0} ቀናት'}, 'hour': {'future': 'በአንድ ሰዓት', 'past': 'ከአንድ ሰዓት'}, 'hours': {'future': 'በ {0} ሰከንድ', 'past': 'ከ {0} ሰዓታት'}, 'minute': {'future': 'በአንድ ደቂቃ', 'past': 'ከአንድ ደቂቃ'}, 'minutes': {'future': 'በ {0} ደቂቃዎች', 'past': 'ከ {0} ደቂቃዎች'}, 'month': {'future': 'በአንድ ወር', 'past': 'ከአንድ ወር'}, 'months': {'future': 'በ {0} ወራት', 'past': 'ከ {0} ወር'}, 'now': 'አሁን', 'second': {'future': 'በአንድ ሰከንድ', 'past': 'ከአንድ ሰከንድ'}, 'seconds': {'future': 'በ {0} ሰከንድ', 'past': 'ከ {0} ሰከንድ'}, 'week': {'future': 'በአንድ ሳምንት', 'past': 'ከአንድ ሳምንት'}, 'weeks': {'future': 'በ {0} ሳምንታት', 'past': 'ከ {0} ሳምንታት'}, 'year': {'future': 'በአንድ አመት', 'past': 'ከአንድ አመት'}, 'years': {'future': 'በ {0} ዓመታት', 'past': 'ከ {0} ዓመታት'}}

timeframes_only_distance = {'day': 'አንድ ቀን', 'days': '{0} ቀናት', 'hour': 'አንድ ሰዓት', 'hours': '{0} ሰዓት', 'minute': 'አንድ ደቂቃ', 'minutes': '{0} ደቂቃዎች', 'month': 'አንድ ወር', 'months': '{0} ወራት', 'second': 'አንድ ሰከንድ', 'seconds': '{0} ሰከንድ', 'week': 'አንድ ሳምንት', 'weeks': '{0} ሳምንት', 'year': 'አንድ አመት', 'years': '{0} ዓመታት'}

class arrow.locales.ArabicLocale

day_abbreviations: ClassVar[List[str]] = ['', 'إثنين', 'ثلاثاء', 'أربعاء', 'خميس', 'جمعة', 'سبت', 'أحد']

day_names: ClassVar[List[str]] = ['', 'الإثنين', 'الثلاثاء', 'الأربعاء', 'الخميس', 'الجمعة', 'السبت', 'الأحد']

future: ClassVar[str] = 'خلال {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'يناير', 'فبراير', 'مارس', 'أبريل', 'مايو', 'يونيو', 'يوليو', 'أغسطس', 'سبتمبر', 'أكتوبر', 'نوفمبر', 'ديسمبر']

month_names: ClassVar[List[str]] = ['', 'يناير', 'فبراير', 'مارس', 'أبريل', 'مايو', 'يونيو', 'يوليو', 'أغسطس', 'سبتمبر', 'أكتوبر', 'نوفمبر', 'ديسمبر']

names: ClassVar[List[str]] = ['ar', 'ar-ae', 'ar-bh', 'ar-dj', 'ar-eg', 'ar-eh', 'ar-er', 'ar-km', 'ar-kw', 'ar-ly', 'ar-om', 'ar-qa', 'ar-sa', 'ar-sd', 'ar-so', 'ar-ss', 'ar-td', 'ar-ye']

past: ClassVar[str] = 'منذ {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'يوم', 'days': {'2': 'يومين', 'higher': '{0} يوم', 'ten': '{0} أيام'}, 'hour': 'ساعة', 'hours': {'2': 'ساعتين', 'higher': '{0} ساعة', 'ten': '{0} ساعات'}, 'minute': 'دقيقة', 'minutes': {'2': 'دقيقتين', 'higher': '{0} دقيقة', 'ten': '{0} دقائق'}, 'month': 'شهر', 'months': {'2': 'شهرين', 'higher': '{0} شهر', 'ten': '{0} أشهر'}, 'now': 'الآن', 'second': 'ثانية', 'seconds': {'2': 'ثانيتين', 'higher': '{0} ثانية', 'ten': '{0} ثوان'}, 'week': 'اسبوع', 'weeks': {'2': 'اسبوعين', 'higher': '{0} اسبوع', 'ten': '{0} أسابيع'}, 'year': 'سنة', 'years': {'2': 'سنتين', 'higher': '{0} سنة', 'ten': '{0} سنوات'}}

class arrow.locales.ArmenianLocale

and_word: ClassVar[Optional[str]] = 'Եվ'

day_abbreviations: ClassVar[List[str]] = ['', 'երկ.', 'երեք.', 'չորեք.', 'հինգ.', 'ուրբ.', 'շաբ.', 'կիր.']

day_names: ClassVar[List[str]] = ['', 'երկուշաբթի', 'երեքշաբթի', 'չորեքշաբթի', 'հինգշաբթի', 'ուրբաթ', 'շաբաթ', 'կիրակի']

future: ClassVar[str] = '{0}ից'

meridians: ClassVar[Dict[str, str]] = {'AM': 'Ամ', 'PM': 'պ.մ.', 'am': 'Ամ', 'pm': 'պ.մ.'}

month_abbreviations: ClassVar[List[str]] = ['', 'հունվար', 'փետրվար', 'մարտ', 'ապրիլ', 'մայիս', 'հունիս', 'հուլիս', 'օգոստոս', 'սեպտեմբեր', 'հոկտեմբեր', 'նոյեմբեր', 'դեկտեմբեր']

month_names: ClassVar[List[str]] = ['', 'հունվար', 'փետրվար', 'մարտ', 'ապրիլ', 'մայիս', 'հունիս', 'հուլիս', 'օգոստոս', 'սեպտեմբեր', 'հոկտեմբեր', 'նոյեմբեր', 'դեկտեմբեր']

names: ClassVar[List[str]] = ['hy', 'hy-am']

past: ClassVar[str] = '{0} առաջ'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'օր', 'days': '{0} օր', 'hour': 'ժամ', 'hours': '{0} ժամ', 'minute': 'րոպե', 'minutes': '{0} րոպե', 'month': 'ամիս', 'months': '{0} ամիս', 'now': 'հիմա', 'second': 'վայրկյան', 'seconds': '{0} վայրկյան', 'week': 'շաբաթ', 'weeks': '{0} շաբաթ', 'year': 'տարին', 'years': '{0} տարին'}

class arrow.locales.AustrianLocale

month_names: ClassVar[List[str]] = ['', 'Jänner', 'Februar', 'März', 'April', 'Mai', 'Juni', 'Juli', 'August', 'September', 'Oktober', 'November', 'Dezember']

names: ClassVar[List[str]] = ['de-at']

class arrow.locales.AzerbaijaniLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Ber', 'Çax', 'Çər', 'Cax', 'Cüm', 'Şnb', 'Bzr']

day_names: ClassVar[List[str]] = ['', 'Bazar ertəsi', 'Çərşənbə axşamı', 'Çərşənbə', 'Cümə axşamı', 'Cümə', 'Şənbə', 'Bazar']

future: ClassVar[str] = '{0} sonra'

month_abbreviations: ClassVar[List[str]] = ['', 'Yan', 'Fev', 'Mar', 'Apr', 'May', 'İyn', 'İyl', 'Avq', 'Sen', 'Okt', 'Noy', 'Dek']

month_names: ClassVar[List[str]] = ['', 'Yanvar', 'Fevral', 'Mart', 'Aprel', 'May', 'İyun', 'İyul', 'Avqust', 'Sentyabr', 'Oktyabr', 'Noyabr', 'Dekabr']

names: ClassVar[List[str]] = ['az', 'az-az']

past: ClassVar[str] = '{0} əvvəl'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'bir gün', 'days': '{0} gün', 'hour': 'bir saat', 'hours': '{0} saat', 'minute': 'bir dəqiqə', 'minutes': '{0} dəqiqə', 'month': 'bir ay', 'months': '{0} ay', 'now': 'indi', 'second': 'bir saniyə', 'seconds': '{0} saniyə', 'week': 'bir həftə', 'weeks': '{0} həftə', 'year': 'bir il', 'years': '{0} il'}

class arrow.locales.BasqueLocale

day_abbreviations: ClassVar[List[str]] = ['', 'al', 'ar', 'az', 'og', 'ol', 'lr', 'ig']

day_names: ClassVar[List[str]] = ['', 'astelehena', 'asteartea', 'asteazkena', 'osteguna', 'ostirala', 'larunbata', 'igandea']

future: ClassVar[str] = '{0}'

month_abbreviations: ClassVar[List[str]] = ['', 'urt', 'ots', 'mar', 'api', 'mai', 'eka', 'uzt', 'abu', 'ira', 'urr', 'aza', 'abe']

month_names: ClassVar[List[str]] = ['', 'urtarrilak', 'otsailak', 'martxoak', 'apirilak', 'maiatzak', 'ekainak', 'uztailak', 'abuztuak', 'irailak', 'urriak', 'azaroak', 'abenduak']

names: ClassVar[List[str]] = ['eu', 'eu-eu']

past: ClassVar[str] = 'duela {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'egun bat', 'days': '{0} egun', 'hour': 'ordu bat', 'hours': '{0} ordu', 'minute': 'minutu bat', 'minutes': '{0} minutu', 'month': 'hilabete bat', 'months': '{0} hilabet', 'now': 'Orain', 'second': 'segundo bat', 'seconds': '{0} segundu', 'year': 'urte bat', 'years': '{0} urte'}

class arrow.locales.BelarusianLocale

day_abbreviations: ClassVar[List[str]] = ['', 'пн', 'ат', 'ср', 'чц', 'пт', 'сб', 'нд']

day_names: ClassVar[List[str]] = ['', 'панядзелак', 'аўторак', 'серада', 'чацвер', 'пятніца', 'субота', 'нядзеля']

future: ClassVar[str] = 'праз {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'студ', 'лют', 'сак', 'крас', 'трав', 'чэрв', 'ліп', 'жнів', 'вер', 'каст', 'ліст', 'снеж']

month_names: ClassVar[List[str]] = ['', 'студзеня', 'лютага', 'сакавіка', 'красавіка', 'траўня', 'чэрвеня', 'ліпеня', 'жніўня', 'верасня', 'кастрычніка', 'лістапада', 'снежня']

names: ClassVar[List[str]] = ['be', 'be-by']

past: ClassVar[str] = '{0} таму'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'дзень', 'days': {'dual': '{0} дні', 'plural': '{0} дзён', 'singular': '{0} дзень'}, 'hour': 'гадзіну', 'hours': {'dual': '{0} гадзіны', 'plural': '{0} гадзін', 'singular': '{0} гадзіну'}, 'minute': 'хвіліну', 'minutes': {'dual': '{0} хвіліны', 'plural': '{0} хвілін', 'singular': '{0} хвіліну'}, 'month': 'месяц', 'months': {'dual': '{0} месяцы', 'plural': '{0} месяцаў', 'singular': '{0} месяц'}, 'now': 'зараз', 'second': 'секунду', 'seconds': '{0} некалькі секунд', 'year': 'год', 'years': {'dual': '{0} гады', 'plural': '{0} гадоў', 'singular': '{0} год'}}

class arrow.locales.BengaliLocale

day_abbreviations: ClassVar[List[str]] = ['', 'সোম', 'মঙ্গল', 'বুধ', 'বৃহঃ', 'শুক্র', 'শনি', 'রবি']

day_names: ClassVar[List[str]] = ['', 'সোমবার', 'মঙ্গলবার', 'বুধবার', 'বৃহস্পতিবার', 'শুক্রবার', 'শনিবার', 'রবিবার']

future: ClassVar[str] = '{0} পরে'

meridians: ClassVar[Dict[str, str]] = {'AM': 'সকাল', 'PM': 'বিকাল', 'am': 'সকাল', 'pm': 'বিকাল'}

month_abbreviations: ClassVar[List[str]] = ['', 'জানু', 'ফেব', 'মার্চ', 'এপ্রি', 'মে', 'জুন', 'জুল', 'অগা', 'সেপ্ট', 'অক্টো', 'নভে', 'ডিসে']

month_names: ClassVar[List[str]] = ['', 'জানুয়ারি', 'ফেব্রুয়ারি', 'মার্চ', 'এপ্রিল', 'মে', 'জুন', 'জুলাই', 'আগস্ট', 'সেপ্টেম্বর', 'অক্টোবর', 'নভেম্বর', 'ডিসেম্বর']

names: ClassVar[List[str]] = ['bn', 'bn-bd', 'bn-in']

past: ClassVar[str] = '{0} আগে'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'এক দিন', 'days': '{0} দিন', 'hour': 'এক ঘণ্টা', 'hours': '{0} ঘণ্টা', 'minute': 'এক মিনিট', 'minutes': '{0} মিনিট', 'month': 'এক মাস', 'months': '{0} মাস ', 'now': 'এখন', 'second': 'একটি দ্বিতীয়', 'seconds': '{0} সেকেন্ড', 'year': 'এক বছর', 'years': '{0} বছর'}

class arrow.locales.BrazilianPortugueseLocale

names: ClassVar[List[str]] = ['pt-br']

past: ClassVar[str] = 'faz {0}'

class arrow.locales.BulgarianLocale

day_abbreviations: ClassVar[List[str]] = ['', 'пон', 'вт', 'ср', 'четв', 'пет', 'съб', 'нед']

day_names: ClassVar[List[str]] = ['', 'понеделник', 'вторник', 'сряда', 'четвъртък', 'петък', 'събота', 'неделя']

future: ClassVar[str] = 'напред {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'ян', 'февр', 'март', 'апр', 'май', 'юни', 'юли', 'авг', 'септ', 'окт', 'ноем', 'дек']

month_names: ClassVar[List[str]] = ['', 'януари', 'февруари', 'март', 'април', 'май', 'юни', 'юли', 'август', 'септември', 'октомври', 'ноември', 'декември']

names: ClassVar[List[str]] = ['bg', 'bg-bg']

past: ClassVar[str] = '{0} назад'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'ден', 'days': {'dual': '{0} дни', 'plural': '{0} дни', 'singular': '{0} ден'}, 'hour': 'час', 'hours': {'dual': '{0} часа', 'plural': '{0} часа', 'singular': '{0} час'}, 'minute': 'минута', 'minutes': {'dual': '{0} минути', 'plural': '{0} минути', 'singular': '{0} минута'}, 'month': 'месец', 'months': {'dual': '{0} месеца', 'plural': '{0} месеца', 'singular': '{0} месец'}, 'now': 'сега', 'second': 'секунда', 'seconds': '{0} няколко секунди', 'year': 'година', 'years': {'dual': '{0} години', 'plural': '{0} години', 'singular': '{0} година'}}

class arrow.locales.CatalanLocale

and_word: ClassVar[Optional[str]] = 'i'

day_abbreviations: ClassVar[List[str]] = ['', 'dl.', 'dt.', 'dc.', 'dj.', 'dv.', 'ds.', 'dg.']

day_names: ClassVar[List[str]] = ['', 'dilluns', 'dimarts', 'dimecres', 'dijous', 'divendres', 'dissabte', 'diumenge']

future: ClassVar[str] = 'En {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'gen.', 'febr.', 'març', 'abr.', 'maig', 'juny', 'jul.', 'ag.', 'set.', 'oct.', 'nov.', 'des.']

month_names: ClassVar[List[str]] = ['', 'gener', 'febrer', 'març', 'abril', 'maig', 'juny', 'juliol', 'agost', 'setembre', 'octubre', 'novembre', 'desembre']

names: ClassVar[List[str]] = ['ca', 'ca-es', 'ca-ad', 'ca-fr', 'ca-it']

past: ClassVar[str] = 'Fa {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'un dia', 'days': '{0} dies', 'hour': 'una hora', 'hours': '{0} hores', 'minute': 'un minut', 'minutes': '{0} minuts', 'month': 'un mes', 'months': '{0} mesos', 'now': 'Ara mateix', 'second': 'un segon', 'seconds': '{0} segons', 'year': 'un any', 'years': '{0} anys'}

class arrow.locales.ChineseCNLocale

day_abbreviations: ClassVar[List[str]] = ['', '一', '二', '三', '四', '五', '六', '日']

day_names: ClassVar[List[str]] = ['', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六', '星期日']

future: ClassVar[str] = '{0}后'

month_abbreviations: ClassVar[List[str]] = ['', ' 1', ' 2', ' 3', ' 4', ' 5', ' 6', ' 7', ' 8', ' 9', '10', '11', '12']

month_names: ClassVar[List[str]] = ['', '一月', '二月', '三月', '四月', '五月', '六月', '七月', '八月', '九月', '十月', '十一月', '十二月']

names: ClassVar[List[str]] = ['zh', 'zh-cn']

past: ClassVar[str] = '{0}前'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': '1天', 'days': '{0}天', 'hour': '1小时', 'hours': '{0}小时', 'minute': '1分钟', 'minutes': '{0}分钟', 'month': '1个月', 'months': '{0}个月', 'now': '刚才', 'second': '1秒', 'seconds': '{0}秒', 'week': '1周', 'weeks': '{0}周', 'year': '1年', 'years': '{0}年'}

class arrow.locales.ChineseTWLocale

and_word: ClassVar[Optional[str]] = '和'

day_abbreviations: ClassVar[List[str]] = ['', '一', '二', '三', '四', '五', '六', '日']

day_names: ClassVar[List[str]] = ['', '週一', '週二', '週三', '週四', '週五', '週六', '週日']

future: ClassVar[str] = '{0}後'

month_abbreviations: ClassVar[List[str]] = ['', ' 1', ' 2', ' 3', ' 4', ' 5', ' 6', ' 7', ' 8', ' 9', '10', '11', '12']

month_names: ClassVar[List[str]] = ['', '1月', '2月', '3月', '4月', '5月', '6月', '7月', '8月', '9月', '10月', '11月', '12月']

names: ClassVar[List[str]] = ['zh-tw']

past: ClassVar[str] = '{0}前'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': '1天', 'days': '{0}天', 'hour': '1小時', 'hours': '{0}小時', 'minute': '1分鐘', 'minutes': '{0}分鐘', 'month': '1個月', 'months': '{0}個月', 'now': '剛才', 'second': '1秒', 'seconds': '{0}秒', 'week': '1週', 'weeks': '{0}週', 'year': '1年', 'years': '{0}年'}

class arrow.locales.CroatianLocale

and_word: ClassVar[Optional[str]] = 'i'

day_abbreviations: ClassVar[List[str]] = ['', 'po', 'ut', 'sr', 'če', 'pe', 'su', 'ne']

day_names: ClassVar[List[str]] = ['', 'ponedjeljak', 'utorak', 'srijeda', 'četvrtak', 'petak', 'subota', 'nedjelja']

future: ClassVar[str] = 'za {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'siječ', 'velj', 'ožuj', 'trav', 'svib', 'lip', 'srp', 'kol', 'ruj', 'list', 'stud', 'pros']

month_names: ClassVar[List[str]] = ['', 'siječanj', 'veljača', 'ožujak', 'travanj', 'svibanj', 'lipanj', 'srpanj', 'kolovoz', 'rujan', 'listopad', 'studeni', 'prosinac']

names: ClassVar[List[str]] = ['hr', 'hr-hr']

past: ClassVar[str] = 'prije {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'jedan dan', 'days': {'double': '{0} dana', 'higher': '{0} dana'}, 'hour': 'sat', 'hours': {'double': '{0} sata', 'higher': '{0} sati'}, 'minute': 'minutu', 'minutes': {'double': '{0} minute', 'higher': '{0} minuta'}, 'month': 'mjesec', 'months': {'double': '{0} mjeseca', 'higher': '{0} mjeseci'}, 'now': 'upravo sad', 'second': 'sekundu', 'seconds': {'double': '{0} sekunde', 'higher': '{0} sekundi'}, 'week': 'tjedan', 'weeks': {'double': '{0} tjedna', 'higher': '{0} tjedana'}, 'year': 'godinu', 'years': {'double': '{0} godine', 'higher': '{0} godina'}}

class arrow.locales.CzechLocale

day_abbreviations: ClassVar[List[str]] = ['', 'po', 'út', 'st', 'čt', 'pá', 'so', 'ne']

day_names: ClassVar[List[str]] = ['', 'pondělí', 'úterý', 'středa', 'čtvrtek', 'pátek', 'sobota', 'neděle']

future: ClassVar[str] = 'Za {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'led', 'úno', 'bře', 'dub', 'kvě', 'čvn', 'čvc', 'srp', 'zář', 'říj', 'lis', 'pro']

month_names: ClassVar[List[str]] = ['', 'leden', 'únor', 'březen', 'duben', 'květen', 'červen', 'červenec', 'srpen', 'září', 'říjen', 'listopad', 'prosinec']

names: ClassVar[List[str]] = ['cs', 'cs-cz']

past: ClassVar[str] = 'Před {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': {'future': 'den', 'past': 'dnem'}, 'days': {'future-paucal': '{0} dnů', 'future-singular': '{0} dny', 'past': '{0} dny', 'zero': '{0} dnů'}, 'hour': {'future': 'hodinu', 'past': 'hodinou'}, 'hours': {'future-paucal': '{0} hodin', 'future-singular': '{0} hodiny', 'past': '{0} hodinami', 'zero': '{0} hodin'}, 'minute': {'future': 'minutu', 'past': 'minutou'}, 'minutes': {'future-paucal': '{0} minut', 'future-singular': '{0} minuty', 'past': '{0} minutami', 'zero': '{0} minut'}, 'month': {'future': 'měsíc', 'past': 'měsícem'}, 'months': {'future-paucal': '{0} měsíců', 'future-singular': '{0} měsíce', 'past': '{0} měsíci', 'zero': '{0} měsíců'}, 'now': 'Teď', 'second': {'future': 'vteřina', 'past': 'vteřina'}, 'seconds': {'future-paucal': '{0} sekund', 'future-singular': '{0} sekundy', 'past': '{0} sekundami', 'zero': 'vteřina'}, 'week': {'future': 'týden', 'past': 'týdnem'}, 'weeks': {'future-paucal': '{0} týdnů', 'future-singular': '{0} týdny', 'past': '{0} týdny', 'zero': '{0} týdnů'}, 'year': {'future': 'rok', 'past': 'rokem'}, 'years': {'future-paucal': '{0} let', 'future-singular': '{0} roky', 'past': '{0} lety', 'zero': '{0} let'}}

class arrow.locales.DanishLocale

and_word: ClassVar[Optional[str]] = 'og'

day_abbreviations: ClassVar[List[str]] = ['', 'man', 'tir', 'ons', 'tor', 'fre', 'lør', 'søn']

day_names: ClassVar[List[str]] = ['', 'mandag', 'tirsdag', 'onsdag', 'torsdag', 'fredag', 'lørdag', 'søndag']

future: ClassVar[str] = 'om {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'mar', 'apr', 'maj', 'jun', 'jul', 'aug', 'sep', 'okt', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'januar', 'februar', 'marts', 'april', 'maj', 'juni', 'juli', 'august', 'september', 'oktober', 'november', 'december']

names: ClassVar[List[str]] = ['da', 'da-dk']

past: ClassVar[str] = 'for {0} siden'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'en dag', 'days': '{0} dage', 'hour': 'en time', 'hours': '{0} timer', 'minute': 'et minut', 'minutes': '{0} minutter', 'month': 'en måned', 'months': '{0} måneder', 'now': 'lige nu', 'second': 'et sekund', 'seconds': '{0} sekunder', 'week': 'en uge', 'weeks': '{0} uger', 'year': 'et år', 'years': '{0} år'}

class arrow.locales.DutchLocale

day_abbreviations: ClassVar[List[str]] = ['', 'ma', 'di', 'wo', 'do', 'vr', 'za', 'zo']

day_names: ClassVar[List[str]] = ['', 'maandag', 'dinsdag', 'woensdag', 'donderdag', 'vrijdag', 'zaterdag', 'zondag']

future: ClassVar[str] = 'over {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'mrt', 'apr', 'mei', 'jun', 'jul', 'aug', 'sep', 'okt', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december']

names: ClassVar[List[str]] = ['nl', 'nl-nl']

past: ClassVar[str] = '{0} geleden'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'een dag', 'days': '{0} dagen', 'hour': 'een uur', 'hours': '{0} uur', 'minute': 'een minuut', 'minutes': '{0} minuten', 'month': 'een maand', 'months': '{0} maanden', 'now': 'nu', 'second': 'een seconde', 'seconds': '{0} seconden', 'week': 'een week', 'weeks': '{0} weken', 'year': 'een jaar', 'years': '{0} jaar'}

class arrow.locales.EnglishLocale

and_word: ClassVar[Optional[str]] = 'and'

day_abbreviations: ClassVar[List[str]] = ['', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']

day_names: ClassVar[List[str]] = ['', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday']

describe(timeframe, delta=0, only_distance=False)

Describes a delta within a timeframe in plain language.

Parameters:

timeframe (Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years']) – a string representing a timeframe.
delta (Union[int, float]) – a quantity representing a delta in a timeframe.
only_distance (bool) – return only distance eg: “11 seconds” without “in” or “ago” keywords

Return type:

str

future: ClassVar[str] = 'in {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': 'AM', 'PM': 'PM', 'am': 'am', 'pm': 'pm'}

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']

month_names: ClassVar[List[str]] = ['', 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']

names: ClassVar[List[str]] = ['en', 'en-us', 'en-gb', 'en-au', 'en-be', 'en-jp', 'en-za', 'en-ca', 'en-ph']

ordinal_day_re: ClassVar[str] = '((?P<value>[2-3]?1(?=st)|[2-3]?2(?=nd)|[2-3]?3(?=rd)|[1-3]?[04-9](?=th)|1[1-3](?=th))(st|nd|rd|th))'

past: ClassVar[str] = '{0} ago'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'a day', 'days': '{0} days', 'hour': 'an hour', 'hours': '{0} hours', 'minute': 'a minute', 'minutes': '{0} minutes', 'month': 'a month', 'months': '{0} months', 'now': 'just now', 'quarter': 'a quarter', 'quarters': '{0} quarters', 'second': 'a second', 'seconds': '{0} seconds', 'week': 'a week', 'weeks': '{0} weeks', 'year': 'a year', 'years': '{0} years'}

class arrow.locales.EsperantoLocale

day_abbreviations: ClassVar[List[str]] = ['', 'lun', 'mar', 'mer', 'ĵaŭ', 'ven', 'sab', 'dim']

day_names: ClassVar[List[str]] = ['', 'lundo', 'mardo', 'merkredo', 'ĵaŭdo', 'vendredo', 'sabato', 'dimanĉo']

future: ClassVar[str] = 'post {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': 'ATM', 'PM': 'PTM', 'am': 'atm', 'pm': 'ptm'}

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'mar', 'apr', 'maj', 'jun', 'jul', 'aŭg', 'sep', 'okt', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'januaro', 'februaro', 'marto', 'aprilo', 'majo', 'junio', 'julio', 'aŭgusto', 'septembro', 'oktobro', 'novembro', 'decembro']

names: ClassVar[List[str]] = ['eo', 'eo-xx']

ordinal_day_re: ClassVar[str] = '((?P<value>[1-3]?[0-9](?=a))a)'

past: ClassVar[str] = 'antaŭ {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'unu tago', 'days': '{0} tagoj', 'hour': 'un horo', 'hours': '{0} horoj', 'minute': 'unu minuto', 'minutes': '{0} minutoj', 'month': 'unu monato', 'months': '{0} monatoj', 'now': 'nun', 'second': 'sekundo', 'seconds': '{0} kelkaj sekundoj', 'year': 'unu jaro', 'years': '{0} jaroj'}

class arrow.locales.EstonianLocale

and_word: ClassVar[Optional[str]] = 'ja'

day_abbreviations: ClassVar[List[str]] = ['', 'Esm', 'Teis', 'Kolm', 'Nelj', 'Re', 'Lau', 'Püh']

day_names: ClassVar[List[str]] = ['', 'Esmaspäev', 'Teisipäev', 'Kolmapäev', 'Neljapäev', 'Reede', 'Laupäev', 'Pühapäev']

future: ClassVar[str] = '{0} pärast'

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Veb', 'Mär', 'Apr', 'Mai', 'Jun', 'Jul', 'Aug', 'Sep', 'Okt', 'Nov', 'Dets']

month_names: ClassVar[List[str]] = ['', 'Jaanuar', 'Veebruar', 'Märts', 'Aprill', 'Mai', 'Juuni', 'Juuli', 'August', 'September', 'Oktoober', 'November', 'Detsember']

names: ClassVar[List[str]] = ['ee', 'et']

past: ClassVar[str] = '{0} tagasi'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Mapping[str, str]]] = {'day': {'future': 'ühe päeva', 'past': 'üks päev'}, 'days': {'future': '{0} päeva', 'past': '{0} päeva'}, 'hour': {'future': 'tunni aja', 'past': 'tund aega'}, 'hours': {'future': '{0} tunni', 'past': '{0} tundi'}, 'minute': {'future': 'ühe minuti', 'past': 'üks minut'}, 'minutes': {'future': '{0} minuti', 'past': '{0} minutit'}, 'month': {'future': 'ühe kuu', 'past': 'üks kuu'}, 'months': {'future': '{0} kuu', 'past': '{0} kuud'}, 'now': {'future': 'just nüüd', 'past': 'just nüüd'}, 'second': {'future': 'ühe sekundi', 'past': 'üks sekund'}, 'seconds': {'future': '{0} sekundi', 'past': '{0} sekundit'}, 'year': {'future': 'ühe aasta', 'past': 'üks aasta'}, 'years': {'future': '{0} aasta', 'past': '{0} aastat'}}

class arrow.locales.FarsiLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']

day_names: ClassVar[List[str]] = ['', 'دو شنبه', 'سه شنبه', 'چهارشنبه', 'پنجشنبه', 'جمعه', 'شنبه', 'یکشنبه']

future: ClassVar[str] = 'در {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': 'قبل از ظهر', 'PM': 'بعد از ظهر', 'am': 'قبل از ظهر', 'pm': 'بعد از ظهر'}

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']

month_names: ClassVar[List[str]] = ['', 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']

names: ClassVar[List[str]] = ['fa', 'fa-ir']

past: ClassVar[str] = '{0} قبل'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'یک روز', 'days': '{0} روز', 'hour': 'یک ساعت', 'hours': '{0} ساعت', 'minute': 'یک دقیقه', 'minutes': '{0} دقیقه', 'month': 'یک ماه', 'months': '{0} ماه', 'now': 'اکنون', 'second': 'یک لحظه', 'seconds': '{0} ثانیه', 'year': 'یک سال', 'years': '{0} سال'}

class arrow.locales.FinnishLocale

day_abbreviations: ClassVar[List[str]] = ['', 'ma', 'ti', 'ke', 'to', 'pe', 'la', 'su']

day_names: ClassVar[List[str]] = ['', 'maanantai', 'tiistai', 'keskiviikko', 'torstai', 'perjantai', 'lauantai', 'sunnuntai']

future: ClassVar[str] = '{0} kuluttua'

month_abbreviations: ClassVar[List[str]] = ['', 'tammi', 'helmi', 'maalis', 'huhti', 'touko', 'kesä', 'heinä', 'elo', 'syys', 'loka', 'marras', 'joulu']

month_names: ClassVar[List[str]] = ['', 'tammikuu', 'helmikuu', 'maaliskuu', 'huhtikuu', 'toukokuu', 'kesäkuu', 'heinäkuu', 'elokuu', 'syyskuu', 'lokakuu', 'marraskuu', 'joulukuu']

names: ClassVar[List[str]] = ['fi', 'fi-fi']

past: ClassVar[str] = '{0} sitten'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': {'future': 'päivän', 'past': 'päivä'}, 'days': {'future': '{0} päivän', 'past': '{0} päivää'}, 'hour': {'future': 'tunnin', 'past': 'tunti'}, 'hours': {'future': '{0} tunnin', 'past': '{0} tuntia'}, 'minute': {'future': 'minuutin', 'past': 'minuutti'}, 'minutes': {'future': '{0} minuutin', 'past': '{0} minuuttia'}, 'month': {'future': 'kuukauden', 'past': 'kuukausi'}, 'months': {'future': '{0} kuukauden', 'past': '{0} kuukautta'}, 'now': 'juuri nyt', 'second': {'future': 'sekunnin', 'past': 'sekunti'}, 'seconds': {'future': '{0} sekunnin', 'past': '{0} sekuntia'}, 'week': {'future': 'viikon', 'past': 'viikko'}, 'weeks': {'future': '{0} viikon', 'past': '{0} viikkoa'}, 'year': {'future': 'vuoden', 'past': 'vuosi'}, 'years': {'future': '{0} vuoden', 'past': '{0} vuotta'}}

class arrow.locales.FrenchBaseLocale

and_word: ClassVar[Optional[str]] = 'et'

day_abbreviations: ClassVar[List[str]] = ['', 'lun', 'mar', 'mer', 'jeu', 'ven', 'sam', 'dim']

day_names: ClassVar[List[str]] = ['', 'lundi', 'mardi', 'mercredi', 'jeudi', 'vendredi', 'samedi', 'dimanche']

future: ClassVar[str] = 'dans {0}'

month_names: ClassVar[List[str]] = ['', 'janvier', 'février', 'mars', 'avril', 'mai', 'juin', 'juillet', 'août', 'septembre', 'octobre', 'novembre', 'décembre']

ordinal_day_re: ClassVar[str] = '((?P<value>\\b1(?=er\\b)|[1-3]?[02-9](?=e\\b)|[1-3]1(?=e\\b))(er|e)\\b)'

past: ClassVar[str] = 'il y a {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'un jour', 'days': '{0} jours', 'hour': 'une heure', 'hours': '{0} heures', 'minute': 'une minute', 'minutes': '{0} minutes', 'month': 'un mois', 'months': '{0} mois', 'now': 'maintenant', 'second': 'une seconde', 'seconds': '{0} secondes', 'week': 'une semaine', 'weeks': '{0} semaines', 'year': 'un an', 'years': '{0} ans'}

class arrow.locales.FrenchCanadianLocale

month_abbreviations: ClassVar[List[str]] = ['', 'janv', 'févr', 'mars', 'avr', 'mai', 'juin', 'juill', 'août', 'sept', 'oct', 'nov', 'déc']

names: ClassVar[List[str]] = ['fr-ca']

class arrow.locales.FrenchLocale

month_abbreviations: ClassVar[List[str]] = ['', 'janv', 'févr', 'mars', 'avr', 'mai', 'juin', 'juil', 'août', 'sept', 'oct', 'nov', 'déc']

names: ClassVar[List[str]] = ['fr', 'fr-fr']

class arrow.locales.GeorgianLocale

and_word: ClassVar[Optional[str]] = 'და'

day_abbreviations: ClassVar[List[str]] = ['', 'ორშაბათი', 'სამშაბათი', 'ოთხშაბათი', 'ხუთშაბათი', 'პარასკევი', 'შაბათი', 'კვირა']

day_names: ClassVar[List[str]] = ['', 'ორშაბათი', 'სამშაბათი', 'ოთხშაბათი', 'ხუთშაბათი', 'პარასკევი', 'შაბათი', 'კვირა']

future: ClassVar[str] = '{0} შემდეგ'

month_abbreviations: ClassVar[List[str]] = ['', 'იანვარი', 'თებერვალი', 'მარტი', 'აპრილი', 'მაისი', 'ივნისი', 'ივლისი', 'აგვისტო', 'სექტემბერი', 'ოქტომბერი', 'ნოემბერი', 'დეკემბერი']

month_names: ClassVar[List[str]] = ['', 'იანვარი', 'თებერვალი', 'მარტი', 'აპრილი', 'მაისი', 'ივნისი', 'ივლისი', 'აგვისტო', 'სექტემბერი', 'ოქტომბერი', 'ნოემბერი', 'დეკემბერი']

names: ClassVar[List[str]] = ['ka', 'ka-ge']

past: ClassVar[str] = '{0} წინ'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'დღის', 'days': '{0} დღის', 'hour': 'საათის', 'hours': '{0} საათის', 'minute': 'წუთის', 'minutes': '{0} წუთის', 'month': 'თვის', 'months': '{0} თვის', 'now': 'ახლა', 'second': 'წამის', 'seconds': '{0} წამის', 'week': 'კვირის', 'weeks': '{0} კვირის', 'year': 'წლის', 'years': '{0} წლის'}

class arrow.locales.GermanBaseLocale

and_word: ClassVar[Optional[str]] = 'und'

day_abbreviations: ClassVar[List[str]] = ['', 'Mo', 'Di', 'Mi', 'Do', 'Fr', 'Sa', 'So']

day_names: ClassVar[List[str]] = ['', 'Montag', 'Dienstag', 'Mittwoch', 'Donnerstag', 'Freitag', 'Samstag', 'Sonntag']

describe(timeframe, delta=0, only_distance=False)

Describes a delta within a timeframe in plain language.

Parameters:

timeframe (Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years']) – a string representing a timeframe.
delta (Union[int, float]) – a quantity representing a delta in a timeframe.
only_distance (bool) – return only distance eg: “11 seconds” without “in” or “ago” keywords

Return type:

str

future: ClassVar[str] = 'in {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Feb', 'Mär', 'Apr', 'Mai', 'Jun', 'Jul', 'Aug', 'Sep', 'Okt', 'Nov', 'Dez']

month_names: ClassVar[List[str]] = ['', 'Januar', 'Februar', 'März', 'April', 'Mai', 'Juni', 'Juli', 'August', 'September', 'Oktober', 'November', 'Dezember']

past: ClassVar[str] = 'vor {0}'

timeframes: ClassVar[Dict[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], str]] = {'day': 'einem Tag', 'days': '{0} Tagen', 'hour': 'einer Stunde', 'hours': '{0} Stunden', 'minute': 'einer Minute', 'minutes': '{0} Minuten', 'month': 'einem Monat', 'months': '{0} Monaten', 'now': 'gerade eben', 'second': 'einer Sekunde', 'seconds': '{0} Sekunden', 'week': 'einer Woche', 'weeks': '{0} Wochen', 'year': 'einem Jahr', 'years': '{0} Jahren'}

timeframes_only_distance = {'day': 'ein Tag', 'days': '{0} Tage', 'hour': 'eine Stunde', 'hours': '{0} Stunden', 'minute': 'eine Minute', 'minutes': '{0} Minuten', 'month': 'ein Monat', 'months': '{0} Monate', 'now': 'gerade eben', 'second': 'eine Sekunde', 'seconds': '{0} Sekunden', 'week': 'eine Woche', 'weeks': '{0} Wochen', 'year': 'ein Jahr', 'years': '{0} Jahre'}

class arrow.locales.GermanLocale

names: ClassVar[List[str]] = ['de', 'de-de']

class arrow.locales.GreekLocale

and_word: ClassVar[Optional[str]] = 'και'

day_abbreviations: ClassVar[List[str]] = ['', 'Δευ', 'Τρι', 'Τετ', 'Πεμ', 'Παρ', 'Σαβ', 'Κυρ']

day_names: ClassVar[List[str]] = ['', 'Δευτέρα', 'Τρίτη', 'Τετάρτη', 'Πέμπτη', 'Παρασκευή', 'Σάββατο', 'Κυριακή']

future: ClassVar[str] = 'σε {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'Ιαν', 'Φεβ', 'Μαρ', 'Απρ', 'Μαϊ', 'Ιον', 'Ιολ', 'Αυγ', 'Σεπ', 'Οκτ', 'Νοε', 'Δεκ']

month_names: ClassVar[List[str]] = ['', 'Ιανουαρίου', 'Φεβρουαρίου', 'Μαρτίου', 'Απριλίου', 'Μαΐου', 'Ιουνίου', 'Ιουλίου', 'Αυγούστου', 'Σεπτεμβρίου', 'Οκτωβρίου', 'Νοεμβρίου', 'Δεκεμβρίου']

names: ClassVar[List[str]] = ['el', 'el-gr']

past: ClassVar[str] = '{0} πριν'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'μία μέρα', 'days': '{0} μέρες', 'hour': 'μία ώρα', 'hours': '{0} ώρες', 'minute': 'ένα λεπτό', 'minutes': '{0} λεπτά', 'month': 'ένα μήνα', 'months': '{0} μήνες', 'now': 'τώρα', 'second': 'ένα δεύτερο', 'seconds': '{0} δευτερόλεπτα', 'week': 'μία εβδομάδα', 'weeks': '{0} εβδομάδες', 'year': 'ένα χρόνο', 'years': '{0} χρόνια'}

class arrow.locales.HebrewLocale

and_word: ClassVar[Optional[str]] = 'ו'

day_abbreviations: ClassVar[List[str]] = ['', 'ב׳', 'ג׳', 'ד׳', 'ה׳', 'ו׳', 'ש׳', 'א׳']

day_names: ClassVar[List[str]] = ['', 'שני', 'שלישי', 'רביעי', 'חמישי', 'שישי', 'שבת', 'ראשון']

describe_multi(timeframes, only_distance=False)

Describes a delta within multiple timeframes in plain language. In Hebrew, the and word behaves a bit differently.

Parameters:

timeframes (Sequence[Tuple[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[int, float]]]) – a list of string, quantity pairs each representing a timeframe and delta.
only_distance (bool) – return only distance eg: “2 hours and 11 seconds” without “in” or “ago” keywords

Return type:

str

future: ClassVar[str] = 'בעוד {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': 'לפני הצהריים', 'PM': 'אחרי הצהריים', 'am': 'לפנ"צ', 'pm': 'אחר"צ'}

month_abbreviations: ClassVar[List[str]] = ['', 'ינו׳', 'פבר׳', 'מרץ', 'אפר׳', 'מאי', 'יוני', 'יולי', 'אוג׳', 'ספט׳', 'אוק׳', 'נוב׳', 'דצמ׳']

month_names: ClassVar[List[str]] = ['', 'ינואר', 'פברואר', 'מרץ', 'אפריל', 'מאי', 'יוני', 'יולי', 'אוגוסט', 'ספטמבר', 'אוקטובר', 'נובמבר', 'דצמבר']

names: ClassVar[List[str]] = ['he', 'he-il']

past: ClassVar[str] = 'לפני {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'יום', 'days': {'2': 'יומיים', 'higher': '{0} יום', 'ten': '{0} ימים'}, 'hour': 'שעה', 'hours': {'2': 'שעתיים', 'higher': '{0} שעות', 'ten': '{0} שעות'}, 'minute': 'דקה', 'minutes': '{0} דקות', 'month': 'חודש', 'months': {'2': 'חודשיים', 'higher': '{0} חודשים', 'ten': '{0} חודשים'}, 'now': 'הרגע', 'second': 'שנייה', 'seconds': '{0} שניות', 'week': 'שבוע', 'weeks': {'2': 'שבועיים', 'higher': '{0} שבועות', 'ten': '{0} שבועות'}, 'year': 'שנה', 'years': {'2': 'שנתיים', 'higher': '{0} שנה', 'ten': '{0} שנים'}}

class arrow.locales.HindiLocale

day_abbreviations: ClassVar[List[str]] = ['', 'सोम', 'मंगल', 'बुध', 'गुरुवार', 'शुक्र', 'शनि', 'रवि']

day_names: ClassVar[List[str]] = ['', 'सोमवार', 'मंगलवार', 'बुधवार', 'गुरुवार', 'शुक्रवार', 'शनिवार', 'रविवार']

future: ClassVar[str] = '{0} बाद'

meridians: ClassVar[Dict[str, str]] = {'AM': 'सुबह', 'PM': 'शाम', 'am': 'सुबह', 'pm': 'शाम'}

month_abbreviations: ClassVar[List[str]] = ['', 'जन', 'फ़र', 'मार्च', 'अप्रै', 'मई', 'जून', 'जुलाई', 'आग', 'सित', 'अकत', 'नवे', 'दिस']

month_names: ClassVar[List[str]] = ['', 'जनवरी', 'फरवरी', 'मार्च', 'अप्रैल ', 'मई', 'जून', 'जुलाई', 'अगस्त', 'सितंबर', 'अक्टूबर', 'नवंबर', 'दिसंबर']

names: ClassVar[List[str]] = ['hi', 'hi-in']

past: ClassVar[str] = '{0} पहले'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'एक दिन', 'days': '{0} दिन', 'hour': 'एक घंटा', 'hours': '{0} घंटे', 'minute': 'एक मिनट ', 'minutes': '{0} मिनट ', 'month': 'एक माह ', 'months': '{0} महीने ', 'now': 'अभी', 'second': 'एक पल', 'seconds': '{0} सेकंड्', 'year': 'एक वर्ष ', 'years': '{0} साल '}

class arrow.locales.HongKongLocale

day_abbreviations: ClassVar[List[str]] = ['', '一', '二', '三', '四', '五', '六', '日']

day_names: ClassVar[List[str]] = ['', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六', '星期日']

future: ClassVar[str] = '{0}後'

month_abbreviations: ClassVar[List[str]] = ['', ' 1', ' 2', ' 3', ' 4', ' 5', ' 6', ' 7', ' 8', ' 9', '10', '11', '12']

month_names: ClassVar[List[str]] = ['', '1月', '2月', '3月', '4月', '5月', '6月', '7月', '8月', '9月', '10月', '11月', '12月']

names: ClassVar[List[str]] = ['zh-hk']

past: ClassVar[str] = '{0}前'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': '1天', 'days': '{0}天', 'hour': '1小時', 'hours': '{0}小時', 'minute': '1分鐘', 'minutes': '{0}分鐘', 'month': '1個月', 'months': '{0}個月', 'now': '剛才', 'second': '1秒', 'seconds': '{0}秒', 'week': '1星期', 'weeks': '{0}星期', 'year': '1年', 'years': '{0}年'}

class arrow.locales.HungarianLocale

day_abbreviations: ClassVar[List[str]] = ['', 'hét', 'kedd', 'szer', 'csüt', 'pént', 'szom', 'vas']

day_names: ClassVar[List[str]] = ['', 'hétfő', 'kedd', 'szerda', 'csütörtök', 'péntek', 'szombat', 'vasárnap']

future: ClassVar[str] = '{0} múlva'

meridians: ClassVar[Dict[str, str]] = {'AM': 'DE', 'PM': 'DU', 'am': 'de', 'pm': 'du'}

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'febr', 'márc', 'ápr', 'máj', 'jún', 'júl', 'aug', 'szept', 'okt', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'január', 'február', 'március', 'április', 'május', 'június', 'július', 'augusztus', 'szeptember', 'október', 'november', 'december']

names: ClassVar[List[str]] = ['hu', 'hu-hu']

past: ClassVar[str] = '{0} ezelőtt'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': {'future': 'egy nap', 'past': 'egy nappal'}, 'days': {'future': '{0} nap', 'past': '{0} nappal'}, 'hour': {'future': 'egy óra', 'past': 'egy órával'}, 'hours': {'future': '{0} óra', 'past': '{0} órával'}, 'minute': {'future': 'egy perc', 'past': 'egy perccel'}, 'minutes': {'future': '{0} perc', 'past': '{0} perccel'}, 'month': {'future': 'egy hónap', 'past': 'egy hónappal'}, 'months': {'future': '{0} hónap', 'past': '{0} hónappal'}, 'now': 'éppen most', 'second': {'future': 'egy második', 'past': 'egy második'}, 'seconds': {'future': '{0} pár másodperc', 'past': '{0} másodpercekkel'}, 'week': {'future': 'egy hét', 'past': 'egy héttel'}, 'weeks': {'future': '{0} hét', 'past': '{0} héttel'}, 'year': {'future': 'egy év', 'past': 'egy évvel'}, 'years': {'future': '{0} év', 'past': '{0} évvel'}}

class arrow.locales.IcelandicLocale

day_abbreviations: ClassVar[List[str]] = ['', 'mán', 'þri', 'mið', 'fim', 'fös', 'lau', 'sun']

day_names: ClassVar[List[str]] = ['', 'mánudagur', 'þriðjudagur', 'miðvikudagur', 'fimmtudagur', 'föstudagur', 'laugardagur', 'sunnudagur']

future: ClassVar[str] = 'eftir {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': 'f.h.', 'PM': 'e.h.', 'am': 'f.h.', 'pm': 'e.h.'}

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'mar', 'apr', 'maí', 'jún', 'júl', 'ágú', 'sep', 'okt', 'nóv', 'des']

month_names: ClassVar[List[str]] = ['', 'janúar', 'febrúar', 'mars', 'apríl', 'maí', 'júní', 'júlí', 'ágúst', 'september', 'október', 'nóvember', 'desember']

names: ClassVar[List[str]] = ['is', 'is-is']

past: ClassVar[str] = 'fyrir {0} síðan'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': {'future': 'einn dag', 'past': 'einum degi'}, 'days': {'future': '{0} daga', 'past': '{0} dögum'}, 'hour': {'future': 'einn tíma', 'past': 'einum tíma'}, 'hours': {'future': '{0} tíma', 'past': '{0} tímum'}, 'minute': {'future': 'eina mínútu', 'past': 'einni mínútu'}, 'minutes': {'future': '{0} mínútur', 'past': '{0} mínútum'}, 'month': {'future': 'einn mánuð', 'past': 'einum mánuði'}, 'months': {'future': '{0} mánuði', 'past': '{0} mánuðum'}, 'now': 'rétt í þessu', 'second': {'future': 'sekúndu', 'past': 'sekúndu'}, 'seconds': {'future': 'nokkrar sekúndur', 'past': '{0} nokkrum sekúndum'}, 'year': {'future': 'eitt ár', 'past': 'einu ári'}, 'years': {'future': '{0} ár', 'past': '{0} árum'}}

class arrow.locales.IndonesianLocale

and_word: ClassVar[Optional[str]] = 'dan'

day_abbreviations: ClassVar[List[str]] = ['', 'Senin', 'Selasa', 'Rabu', 'Kamis', 'Jumat', 'Sabtu', 'Minggu']

day_names: ClassVar[List[str]] = ['', 'Senin', 'Selasa', 'Rabu', 'Kamis', 'Jumat', 'Sabtu', 'Minggu']

future: ClassVar[str] = 'dalam {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': '', 'PM': '', 'am': '', 'pm': ''}

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Feb', 'Mar', 'Apr', 'Mei', 'Jun', 'Jul', 'Ags', 'Sept', 'Okt', 'Nov', 'Des']

month_names: ClassVar[List[str]] = ['', 'Januari', 'Februari', 'Maret', 'April', 'Mei', 'Juni', 'Juli', 'Agustus', 'September', 'Oktober', 'November', 'Desember']

names: ClassVar[List[str]] = ['id', 'id-id']

past: ClassVar[str] = '{0} yang lalu'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': '1 hari', 'days': '{0} hari', 'hour': '1 jam', 'hours': '{0} jam', 'minute': '1 menit', 'minutes': '{0} menit', 'month': '1 bulan', 'months': '{0} bulan', 'now': 'baru saja', 'quarter': '1 kuartal', 'quarters': '{0} kuartal', 'second': '1 sebentar', 'seconds': '{0} detik', 'week': '1 minggu', 'weeks': '{0} minggu', 'year': '1 tahun', 'years': '{0} tahun'}

class arrow.locales.ItalianLocale

and_word: ClassVar[Optional[str]] = 'e'

day_abbreviations: ClassVar[List[str]] = ['', 'lun', 'mar', 'mer', 'gio', 'ven', 'sab', 'dom']

day_names: ClassVar[List[str]] = ['', 'lunedì', 'martedì', 'mercoledì', 'giovedì', 'venerdì', 'sabato', 'domenica']

future: ClassVar[str] = 'tra {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'gen', 'feb', 'mar', 'apr', 'mag', 'giu', 'lug', 'ago', 'set', 'ott', 'nov', 'dic']

month_names: ClassVar[List[str]] = ['', 'gennaio', 'febbraio', 'marzo', 'aprile', 'maggio', 'giugno', 'luglio', 'agosto', 'settembre', 'ottobre', 'novembre', 'dicembre']

names: ClassVar[List[str]] = ['it', 'it-it']

ordinal_day_re: ClassVar[str] = '((?P<value>[1-3]?[0-9](?=[ºª]))[ºª])'

past: ClassVar[str] = '{0} fa'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'un giorno', 'days': '{0} giorni', 'hour': "un'ora", 'hours': '{0} ore', 'minute': 'un minuto', 'minutes': '{0} minuti', 'month': 'un mese', 'months': '{0} mesi', 'now': 'adesso', 'second': 'un secondo', 'seconds': '{0} qualche secondo', 'week': 'una settimana', 'weeks': '{0} settimane', 'year': 'un anno', 'years': '{0} anni'}

class arrow.locales.JapaneseLocale

and_word: ClassVar[Optional[str]] = ''

day_abbreviations: ClassVar[List[str]] = ['', '月', '火', '水', '木', '金', '土', '日']

day_names: ClassVar[List[str]] = ['', '月曜日', '火曜日', '水曜日', '木曜日', '金曜日', '土曜日', '日曜日']

future: ClassVar[str] = '{0}後'

month_abbreviations: ClassVar[List[str]] = ['', ' 1', ' 2', ' 3', ' 4', ' 5', ' 6', ' 7', ' 8', ' 9', '10', '11', '12']

month_names: ClassVar[List[str]] = ['', '1月', '2月', '3月', '4月', '5月', '6月', '7月', '8月', '9月', '10月', '11月', '12月']

names: ClassVar[List[str]] = ['ja', 'ja-jp']

past: ClassVar[str] = '{0}前'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': '1日', 'days': '{0}日', 'hour': '1時間', 'hours': '{0}時間', 'minute': '1分', 'minutes': '{0}分', 'month': '1ヶ月', 'months': '{0}ヶ月', 'now': '現在', 'second': '1秒', 'seconds': '{0}秒', 'week': '1週間', 'weeks': '{0}週間', 'year': '1年', 'years': '{0}年'}

class arrow.locales.KazakhLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Дс', 'Сс', 'Ср', 'Бс', 'Жм', 'Сб', 'Жс']

day_names: ClassVar[List[str]] = ['', 'Дүйсембі', 'Сейсенбі', 'Сәрсенбі', 'Бейсенбі', 'Жұма', 'Сенбі', 'Жексенбі']

future: ClassVar[str] = '{0} кейін'

month_abbreviations: ClassVar[List[str]] = ['', 'Қан', 'Ақп', 'Нау', 'Сәу', 'Мам', 'Мау', 'Шіл', 'Там', 'Қыр', 'Қаз', 'Қар', 'Жел']

month_names: ClassVar[List[str]] = ['', 'Қаңтар', 'Ақпан', 'Наурыз', 'Сәуір', 'Мамыр', 'Маусым', 'Шілде', 'Тамыз', 'Қыркүйек', 'Қазан', 'Қараша', 'Желтоқсан']

names: ClassVar[List[str]] = ['kk', 'kk-kz']

past: ClassVar[str] = '{0} бұрын'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'бір күн', 'days': '{0} күн', 'hour': 'бір сағат', 'hours': '{0} сағат', 'minute': 'бір минут', 'minutes': '{0} минут', 'month': 'бір ай', 'months': '{0} ай', 'now': 'қазір', 'second': 'бір секунд', 'seconds': '{0} секунд', 'week': 'бір апта', 'weeks': '{0} апта', 'year': 'бір жыл', 'years': '{0} жыл'}

class arrow.locales.KoreanLocale

day_abbreviations: ClassVar[List[str]] = ['', '월', '화', '수', '목', '금', '토', '일']

day_names: ClassVar[List[str]] = ['', '월요일', '화요일', '수요일', '목요일', '금요일', '토요일', '일요일']

future: ClassVar[str] = '{0} 후'

month_abbreviations: ClassVar[List[str]] = ['', ' 1', ' 2', ' 3', ' 4', ' 5', ' 6', ' 7', ' 8', ' 9', '10', '11', '12']

month_names: ClassVar[List[str]] = ['', '1월', '2월', '3월', '4월', '5월', '6월', '7월', '8월', '9월', '10월', '11월', '12월']

names: ClassVar[List[str]] = ['ko', 'ko-kr']

past: ClassVar[str] = '{0} 전'

special_dayframes = {-3: '그끄제', -2: '그제', -1: '어제', 1: '내일', 2: '모레', 3: '글피', 4: '그글피'}

special_yearframes = {-2: '제작년', -1: '작년', 1: '내년', 2: '내후년'}

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': '하루', 'days': '{0}일', 'hour': '한시간', 'hours': '{0}시간', 'minute': '1분', 'minutes': '{0}분', 'month': '한달', 'months': '{0}개월', 'now': '지금', 'second': '1초', 'seconds': '{0}초', 'week': '1주', 'weeks': '{0}주', 'year': '1년', 'years': '{0}년'}

class arrow.locales.LaotianLocale

BE_OFFSET = 543

day_abbreviations: ClassVar[List[str]] = ['', 'ວັນຈັນ', 'ວັນອັງຄານ', 'ວັນພຸດ', 'ວັນພະຫັດ', 'ວັນ\u200bສຸກ', 'ວັນເສົາ', 'ວັນອາທິດ']

day_names: ClassVar[List[str]] = ['', 'ວັນຈັນ', 'ວັນອັງຄານ', 'ວັນພຸດ', 'ວັນພະຫັດ', 'ວັນ\u200bສຸກ', 'ວັນເສົາ', 'ວັນອາທິດ']

future: ClassVar[str] = 'ໃນ {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'ມັງກອນ', 'ກຸມພາ', 'ມີນາ', 'ເມສາ', 'ພຶດສະພາ', 'ມິຖຸນາ', 'ກໍລະກົດ', 'ສິງຫາ', 'ກັນຍາ', 'ຕຸລາ', 'ພະຈິກ', 'ທັນວາ']

month_names: ClassVar[List[str]] = ['', 'ມັງກອນ', 'ກຸມພາ', 'ມີນາ', 'ເມສາ', 'ພຶດສະພາ', 'ມິຖຸນາ', 'ກໍລະກົດ', 'ສິງຫາ', 'ກັນຍາ', 'ຕຸລາ', 'ພະຈິກ', 'ທັນວາ']

names: ClassVar[List[str]] = ['lo', 'lo-la']

past: ClassVar[str] = '{0} ກ່ອນຫນ້ານີ້'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'ມື້', 'days': '{0} ມື້', 'hour': 'ຊົ່ວໂມງ', 'hours': '{0} ຊົ່ວໂມງ', 'minute': 'ນາທີ', 'minutes': '{0} ນາທີ', 'month': 'ເດືອນ', 'months': '{0} ເດືອນ', 'now': 'ດຽວນີ້', 'second': 'ວິນາທີ', 'seconds': '{0} ວິນາທີ', 'week': 'ອາທິດ', 'weeks': '{0} ອາທິດ', 'year': 'ປີ', 'years': '{0} ປີ'}

year_abbreviation(year)

Lao always use Buddhist Era (BE) which is CE + 543

Return type:: str

year_full(year)

Lao always use Buddhist Era (BE) which is CE + 543

Return type:: str

class arrow.locales.LatinLocale

and_word: ClassVar[Optional[str]] = 'et'

day_abbreviations: ClassVar[List[str]] = ['', 'dies Lunae', 'dies Martis', 'dies Mercurii', 'dies Iovis', 'dies Veneris', 'dies Saturni', 'dies Solis']

day_names: ClassVar[List[str]] = ['', 'dies Lunae', 'dies Martis', 'dies Mercurii', 'dies Iovis', 'dies Veneris', 'dies Saturni', 'dies Solis']

future: ClassVar[str] = 'in {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'Ian', 'Febr', 'Mart', 'Apr', 'Mai', 'Iun', 'Iul', 'Aug', 'Sept', 'Oct', 'Nov', 'Dec']

month_names: ClassVar[List[str]] = ['', 'Ianuarius', 'Februarius', 'Martius', 'Aprilis', 'Maius', 'Iunius', 'Iulius', 'Augustus', 'September', 'October', 'November', 'December']

names: ClassVar[List[str]] = ['la', 'la-va']

past: ClassVar[str] = 'ante {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'diem', 'days': '{0} dies', 'hour': 'horam', 'hours': '{0} horas', 'minute': 'minutam', 'minutes': '{0} minutis', 'month': 'mensem', 'months': '{0} mensis', 'now': 'nunc', 'second': 'secundum', 'seconds': '{0} secundis', 'week': 'hebdomadem', 'weeks': '{0} hebdomades', 'year': 'annum', 'years': '{0} annos'}

class arrow.locales.LatvianLocale

and_word: ClassVar[Optional[str]] = 'un'

day_abbreviations: ClassVar[List[str]] = ['', 'pi', 'ot', 'tr', 'ce', 'pi', 'se', 'sv']

day_names: ClassVar[List[str]] = ['', 'pirmdiena', 'otrdiena', 'trešdiena', 'ceturtdiena', 'piektdiena', 'sestdiena', 'svētdiena']

future: ClassVar[str] = 'pēc {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'marts', 'apr', 'maijs', 'jūnijs', 'jūlijs', 'aug', 'sept', 'okt', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'janvāris', 'februāris', 'marts', 'aprīlis', 'maijs', 'jūnijs', 'jūlijs', 'augusts', 'septembris', 'oktobris', 'novembris', 'decembris']

names: ClassVar[List[str]] = ['lv', 'lv-lv']

past: ClassVar[str] = 'pirms {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'dienas', 'days': '{0} dienām', 'hour': 'stundas', 'hours': '{0} stundām', 'minute': 'minūtes', 'minutes': '{0} minūtēm', 'month': 'mēneša', 'months': '{0} mēnešiem', 'now': 'tagad', 'second': 'sekundes', 'seconds': '{0} sekundēm', 'week': 'nedēļas', 'weeks': '{0} nedēļām', 'year': 'gada', 'years': '{0} gadiem'}

class arrow.locales.LevantArabicLocale

month_abbreviations: ClassVar[List[str]] = ['', 'كانون الثاني', 'شباط', 'آذار', 'نيسان', 'أيار', 'حزيران', 'تموز', 'آب', 'أيلول', 'تشرين الأول', 'تشرين الثاني', 'كانون الأول']

month_names: ClassVar[List[str]] = ['', 'كانون الثاني', 'شباط', 'آذار', 'نيسان', 'أيار', 'حزيران', 'تموز', 'آب', 'أيلول', 'تشرين الأول', 'تشرين الثاني', 'كانون الأول']

names: ClassVar[List[str]] = ['ar-iq', 'ar-jo', 'ar-lb', 'ar-ps', 'ar-sy']

class arrow.locales.LithuanianLocale

and_word: ClassVar[Optional[str]] = 'ir'

day_abbreviations: ClassVar[List[str]] = ['', 'pi', 'an', 'tr', 'ke', 'pe', 'še', 'se']

day_names: ClassVar[List[str]] = ['', 'pirmadienis', 'antradienis', 'trečiadienis', 'ketvirtadienis', 'penktadienis', 'šeštadienis', 'sekmadienis']

future: ClassVar[str] = 'po {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'saus', 'vas', 'kovas', 'bal', 'geg', 'birž', 'liepa', 'rugp', 'rugs', 'spalis', 'lapkr', 'gr']

month_names: ClassVar[List[str]] = ['', 'sausis', 'vasaris', 'kovas', 'balandis', 'gegužė', 'birželis', 'liepa', 'rugpjūtis', 'rugsėjis', 'spalis', 'lapkritis', 'gruodis']

names: ClassVar[List[str]] = ['lt', 'lt-lt']

past: ClassVar[str] = 'prieš {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'dieną', 'days': '{0} dienų', 'hour': 'valandos', 'hours': '{0} valandų', 'minute': 'minutės', 'minutes': '{0} minučių', 'month': 'mėnesio', 'months': '{0} mėnesių', 'now': 'dabar', 'second': 'sekundės', 'seconds': '{0} sekundžių', 'week': 'savaitės', 'weeks': '{0} savaičių', 'year': 'metų', 'years': '{0} metų'}

class arrow.locales.Locale

Represents locale-specific data and functionality.

and_word: ClassVar[Optional[str]] = None

day_abbreviation(day)

Returns the day abbreviation for a specified day of the week.

Parameters:: day (int) – the int day of the week (1-7).
Return type:: str

day_abbreviations: ClassVar[List[str]] = []

day_name(day)

Returns the day name for a specified day of the week.

Parameters:: day (int) – the int day of the week (1-7).
Return type:: str

day_names: ClassVar[List[str]] = []

describe(timeframe, delta=0, only_distance=False)

Describes a delta within a timeframe in plain language.

Parameters:

timeframe (Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years']) – a string representing a timeframe.
delta (Union[float, int]) – a quantity representing a delta in a timeframe.
only_distance (bool) – return only distance eg: “11 seconds” without “in” or “ago” keywords

Return type:

str

describe_multi(timeframes, only_distance=False)

Describes a delta within multiple timeframes in plain language.

Parameters:

timeframes (Sequence[Tuple[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[int, float]]]) – a list of string, quantity pairs each representing a timeframe and delta.
only_distance (bool) – return only distance eg: “2 hours and 11 seconds” without “in” or “ago” keywords

Return type:

str

future: ClassVar[str]

meridian(hour, token)

Returns the meridian indicator for a specified hour and format token.

Parameters:

hour (int) – the int hour of the day.
token (Any) – the format token.

Return type:

Optional[str]

meridians: ClassVar[Dict[str, str]] = {'AM': '', 'PM': '', 'am': '', 'pm': ''}

month_abbreviation(month)

Returns the month abbreviation for a specified month of the year.

Parameters:: month (int) – the int month of the year (1-12).
Return type:: str

month_abbreviations: ClassVar[List[str]] = []

month_name(month)

Returns the month name for a specified month of the year.

Parameters:: month (int) – the int month of the year (1-12).
Return type:: str

month_names: ClassVar[List[str]] = []

month_number(name)

Returns the month number for a month specified by name or abbreviation.

Parameters:: name (str) – the month name or abbreviation.
Return type:: Optional[int]

names: ClassVar[List[str]] = []

ordinal_day_re: ClassVar[str] = '(\\d+)'

ordinal_number(n)

Returns the ordinal format of a given integer

Parameters:: n (int) – an integer
Return type:: str

past: ClassVar[str]

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': '', 'days': '', 'hour': '', 'hours': '', 'minute': '', 'minutes': '', 'month': '', 'months': '', 'now': '', 'quarter': '', 'quarters': '', 'second': '', 'seconds': '', 'week': '', 'weeks': '', 'year': '', 'years': ''}

year_abbreviation(year)

Returns the year for specific locale if available

Parameters:: year (int) – the int year (4-digit)
Return type:: str

year_full(year)

Returns the year for specific locale if available

Parameters:: year (int) – the int year (4-digit)
Return type:: str

class arrow.locales.LuxembourgishLocale

and_word: ClassVar[Optional[str]] = 'an'

day_abbreviations: ClassVar[List[str]] = ['', 'Méi', 'Dën', 'Mët', 'Don', 'Fre', 'Sam', 'Son']

day_names: ClassVar[List[str]] = ['', 'Méindeg', 'Dënschdeg', 'Mëttwoch', 'Donneschdeg', 'Freideg', 'Samschdeg', 'Sonndeg']

describe(timeframe, delta=0, only_distance=False)

Describes a delta within a timeframe in plain language.

Parameters:

timeframe (Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years']) – a string representing a timeframe.
delta (Union[int, float]) – a quantity representing a delta in a timeframe.
only_distance (bool) – return only distance eg: “11 seconds” without “in” or “ago” keywords

Return type:

str

future: ClassVar[str] = 'an {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Feb', 'Mäe', 'Abr', 'Mee', 'Jun', 'Jul', 'Aug', 'Sep', 'Okt', 'Nov', 'Dez']

month_names: ClassVar[List[str]] = ['', 'Januar', 'Februar', 'Mäerz', 'Abrëll', 'Mee', 'Juni', 'Juli', 'August', 'September', 'Oktouber', 'November', 'Dezember']

names: ClassVar[List[str]] = ['lb', 'lb-lu']

past: ClassVar[str] = 'virun {0}'

timeframes: ClassVar[Dict[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], str]] = {'day': 'engem Dag', 'days': '{0} Deeg', 'hour': 'enger Stonn', 'hours': '{0} Stonnen', 'minute': 'enger Minutt', 'minutes': '{0} Minutten', 'month': 'engem Mount', 'months': '{0} Méint', 'now': 'just elo', 'second': 'enger Sekonn', 'seconds': '{0} Sekonnen', 'week': 'enger Woch', 'weeks': '{0} Wochen', 'year': 'engem Joer', 'years': '{0} Jahren'}

timeframes_only_distance = {'day': 'een Dag', 'days': '{0} Deeg', 'hour': 'eng Stonn', 'hours': '{0} Stonnen', 'minute': 'eng Minutt', 'minutes': '{0} Minutten', 'month': 'ee Mount', 'months': '{0} Méint', 'now': 'just elo', 'second': 'eng Sekonn', 'seconds': '{0} Sekonnen', 'week': 'eng Woch', 'weeks': '{0} Wochen', 'year': 'ee Joer', 'years': '{0} Joer'}

class arrow.locales.MacedonianLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Пон', 'Вт', 'Сре', 'Чет', 'Пет', 'Саб', 'Нед']

day_names: ClassVar[List[str]] = ['', 'Понеделник', 'Вторник', 'Среда', 'Четврток', 'Петок', 'Сабота', 'Недела']

future: ClassVar[str] = 'за {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': 'претпладне', 'PM': 'попладне', 'am': 'дп', 'pm': 'пп'}

month_abbreviations: ClassVar[List[str]] = ['', 'Јан', 'Фев', 'Мар', 'Апр', 'Мај', 'Јун', 'Јул', 'Авг', 'Септ', 'Окт', 'Ноем', 'Декем']

month_names: ClassVar[List[str]] = ['', 'Јануари', 'Февруари', 'Март', 'Април', 'Мај', 'Јуни', 'Јули', 'Август', 'Септември', 'Октомври', 'Ноември', 'Декември']

names: ClassVar[List[str]] = ['mk', 'mk-mk']

past: ClassVar[str] = 'пред {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'еден ден', 'days': {'dual': '{0} дена', 'plural': '{0} дена', 'singular': '{0} ден'}, 'hour': 'еден саат', 'hours': {'dual': '{0} саати', 'plural': '{0} саати', 'singular': '{0} саат'}, 'minute': 'една минута', 'minutes': {'dual': '{0} минути', 'plural': '{0} минути', 'singular': '{0} минута'}, 'month': 'еден месец', 'months': {'dual': '{0} месеци', 'plural': '{0} месеци', 'singular': '{0} месец'}, 'now': 'сега', 'second': 'една секунда', 'seconds': {'dual': '{0} секунди', 'plural': '{0} секунди', 'singular': '{0} секунда'}, 'week': 'една недела', 'weeks': {'dual': '{0} недели', 'plural': '{0} недели', 'singular': '{0} недела'}, 'year': 'една година', 'years': {'dual': '{0} години', 'plural': '{0} години', 'singular': '{0} година'}}

class arrow.locales.MalayLocale

and_word: ClassVar[Optional[str]] = 'dan'

day_abbreviations: ClassVar[List[str]] = ['', 'Isnin', 'Selasa', 'Rabu', 'Khamis', 'Jumaat', 'Sabtu', 'Ahad']

day_names: ClassVar[List[str]] = ['', 'Isnin', 'Selasa', 'Rabu', 'Khamis', 'Jumaat', 'Sabtu', 'Ahad']

future: ClassVar[str] = 'dalam {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'Jan.', 'Feb.', 'Mac', 'Apr.', 'Mei', 'Jun', 'Julai', 'Og.', 'Sept.', 'Okt.', 'Nov.', 'Dis.']

month_names: ClassVar[List[str]] = ['', 'Januari', 'Februari', 'Mac', 'April', 'Mei', 'Jun', 'Julai', 'Ogos', 'September', 'Oktober', 'November', 'Disember']

names: ClassVar[List[str]] = ['ms', 'ms-my', 'ms-bn']

past: ClassVar[str] = '{0} yang lalu'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'hari', 'days': '{0} hari', 'hour': 'jam', 'hours': '{0} jam', 'minute': 'minit', 'minutes': '{0} minit', 'month': 'bulan', 'months': '{0} bulan', 'now': 'sekarang', 'second': 'saat', 'seconds': '{0} saat', 'week': 'minggu', 'weeks': '{0} minggu', 'year': 'tahun', 'years': '{0} tahun'}

class arrow.locales.MalayalamLocale

day_abbreviations: ClassVar[List[str]] = ['', 'തിങ്കള്\u200d', 'ചൊവ്വ', 'ബുധന്\u200d', 'വ്യാഴം', 'വെള്ളി', 'ശനി', 'ഞായര്\u200d']

day_names: ClassVar[List[str]] = ['', 'തിങ്കള്\u200d', 'ചൊവ്വ', 'ബുധന്\u200d', 'വ്യാഴം', 'വെള്ളി', 'ശനി', 'ഞായര്\u200d']

future: ClassVar[str] = '{0} ശേഷം'

meridians: ClassVar[Dict[str, str]] = {'AM': 'രാവിലെ', 'PM': 'ഉച്ചക്ക് ശേഷം', 'am': 'രാവിലെ', 'pm': 'ഉച്ചക്ക് ശേഷം'}

month_abbreviations: ClassVar[List[str]] = ['', 'ജനു', 'ഫെബ് ', 'മാർ', 'ഏപ്രിൽ', 'മേയ്', 'ജൂണ്\u200d', 'ജൂലൈ', 'ഓഗസ്റ', 'സെപ്റ്റ', 'ഒക്ടോ', 'നവം', 'ഡിസം']

month_names: ClassVar[List[str]] = ['', 'ജനുവരി', 'ഫെബ്രുവരി', 'മാർച്ച്\u200c', 'ഏപ്രിൽ ', 'മെയ്\u200c ', 'ജൂണ്\u200d', 'ജൂലൈ', 'ഓഗസ്റ്റ്\u200c', 'സെപ്റ്റംബർ', 'ഒക്ടോബർ', 'നവംബർ', 'ഡിസംബർ']

names: ClassVar[List[str]] = ['ml']

past: ClassVar[str] = '{0} മുമ്പ്'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'ഒരു ദിവസം ', 'days': '{0} ദിവസം ', 'hour': 'ഒരു മണിക്കൂർ', 'hours': '{0} മണിക്കൂർ', 'minute': 'ഒരു മിനിറ്റ്', 'minutes': '{0} മിനിറ്റ്', 'month': 'ഒരു മാസം ', 'months': '{0} മാസം ', 'now': 'ഇപ്പോൾ', 'second': 'ഒരു നിമിഷം', 'seconds': '{0} സെക്കന്റ്\u200c', 'year': 'ഒരു വർഷം ', 'years': '{0} വർഷം '}

class arrow.locales.MalteseLocale

and_word: ClassVar[Optional[str]] = 'u'

day_abbreviations: ClassVar[List[str]] = ['', 'T', 'TL', 'E', 'Ħ', 'Ġ', 'S', 'Ħ']

day_names: ClassVar[List[str]] = ['', 'It-Tnejn', 'It-Tlieta', 'L-Erbgħa', 'Il-Ħamis', 'Il-Ġimgħa', 'Is-Sibt', 'Il-Ħadd']

future: ClassVar[str] = 'fi {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Fr', 'Mar', 'Apr', 'Mejju', 'Ġun', 'Lul', 'Aw', 'Sett', 'Ott', 'Nov', 'Diċ']

month_names: ClassVar[List[str]] = ['', 'Jannar', 'Frar', 'Marzu', 'April', 'Mejju', 'Ġunju', 'Lulju', 'Awwissu', 'Settembru', 'Ottubru', 'Novembru', 'Diċembru']

names: ClassVar[List[str]] = ['mt', 'mt-mt']

past: ClassVar[str] = '{0} ilu'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'jum', 'days': {'dual': '{0} jumejn', 'plural': '{0} ijiem'}, 'hour': 'siegħa', 'hours': {'dual': '{0} sagħtejn', 'plural': '{0} sigħat'}, 'minute': 'minuta', 'minutes': '{0} minuti', 'month': 'xahar', 'months': {'dual': '{0} xahrejn', 'plural': '{0} xhur'}, 'now': 'issa', 'second': 'sekonda', 'seconds': '{0} sekondi', 'week': 'ġimgħa', 'weeks': {'dual': '{0} ġimagħtejn', 'plural': '{0} ġimgħat'}, 'year': 'sena', 'years': {'dual': '{0} sentejn', 'plural': '{0} snin'}}

class arrow.locales.MarathiLocale

day_abbreviations: ClassVar[List[str]] = ['', 'सोम', 'मंगळ', 'बुध', 'गुरु', 'शुक्र', 'शनि', 'रवि']

day_names: ClassVar[List[str]] = ['', 'सोमवार', 'मंगळवार', 'बुधवार', 'गुरुवार', 'शुक्रवार', 'शनिवार', 'रविवार']

future: ClassVar[str] = '{0} नंतर'

meridians: ClassVar[Dict[str, str]] = {'AM': 'सकाळ', 'PM': 'संध्याकाळ', 'am': 'सकाळ', 'pm': 'संध्याकाळ'}

month_abbreviations: ClassVar[List[str]] = ['', 'जान', 'फेब्रु', 'मार्च', 'एप्रि', 'मे', 'जून', 'जुलै', 'अॉग', 'सप्टें', 'अॉक्टो', 'नोव्हें', 'डिसें']

month_names: ClassVar[List[str]] = ['', 'जानेवारी', 'फेब्रुवारी', 'मार्च', 'एप्रिल', 'मे', 'जून', 'जुलै', 'अॉगस्ट', 'सप्टेंबर', 'अॉक्टोबर', 'नोव्हेंबर', 'डिसेंबर']

names: ClassVar[List[str]] = ['mr']

past: ClassVar[str] = '{0} आधी'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'एक दिवस', 'days': '{0} दिवस', 'hour': 'एक तास', 'hours': '{0} तास', 'minute': 'एक मिनिट ', 'minutes': '{0} मिनिट ', 'month': 'एक महिना ', 'months': '{0} महिने ', 'now': 'सद्य', 'second': 'एक सेकंद', 'seconds': '{0} सेकंद', 'year': 'एक वर्ष ', 'years': '{0} वर्ष '}

class arrow.locales.MauritaniaArabicLocale

month_abbreviations: ClassVar[List[str]] = ['', 'يناير', 'فبراير', 'مارس', 'إبريل', 'مايو', 'يونيو', 'يوليو', 'أغشت', 'شتمبر', 'أكتوبر', 'نوفمبر', 'دجمبر']

month_names: ClassVar[List[str]] = ['', 'يناير', 'فبراير', 'مارس', 'إبريل', 'مايو', 'يونيو', 'يوليو', 'أغشت', 'شتمبر', 'أكتوبر', 'نوفمبر', 'دجمبر']

names: ClassVar[List[str]] = ['ar-mr']

class arrow.locales.MoroccoArabicLocale

month_abbreviations: ClassVar[List[str]] = ['', 'يناير', 'فبراير', 'مارس', 'أبريل', 'ماي', 'يونيو', 'يوليوز', 'غشت', 'شتنبر', 'أكتوبر', 'نونبر', 'دجنبر']

month_names: ClassVar[List[str]] = ['', 'يناير', 'فبراير', 'مارس', 'أبريل', 'ماي', 'يونيو', 'يوليوز', 'غشت', 'شتنبر', 'أكتوبر', 'نونبر', 'دجنبر']

names: ClassVar[List[str]] = ['ar-ma']

class arrow.locales.NepaliLocale

day_abbreviations: ClassVar[List[str]] = ['', 'सोम', 'मंगल', 'बुध', 'बिहि', 'शुक्र', 'शनि', 'आइत']

day_names: ClassVar[List[str]] = ['', 'सोमवार', 'मंगलवार', 'बुधवार', 'बिहिवार', 'शुक्रवार', 'शनिवार', 'आइतवार']

future: ClassVar[str] = '{0} पछी'

meridians: ClassVar[Dict[str, str]] = {'AM': 'पूर्वाह्न', 'PM': 'अपरान्ह', 'am': 'पूर्वाह्न', 'pm': 'अपरान्ह'}

month_abbreviations: ClassVar[List[str]] = ['', 'जन', 'फेब', 'मार्च', 'एप्रील', 'मे', 'जुन', 'जुलाई', 'अग', 'सेप', 'अक्ट', 'नोव', 'डिस']

month_names: ClassVar[List[str]] = ['', 'जनवरी', 'फेब्रुअरी', 'मार्च', 'एप्रील', 'मे', 'जुन', 'जुलाई', 'अगष्ट', 'सेप्टेम्बर', 'अक्टोबर', 'नोवेम्बर', 'डिसेम्बर']

names: ClassVar[List[str]] = ['ne', 'ne-np']

past: ClassVar[str] = '{0} पहिले'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'एक दिन', 'days': '{0} दिन', 'hour': 'एक घण्टा', 'hours': '{0} घण्टा', 'minute': 'मिनेट', 'minutes': '{0} मिनेट', 'month': 'एक महिना', 'months': '{0} महिना', 'now': 'अहिले', 'second': 'एक सेकेन्ड', 'seconds': '{0} सेकण्ड', 'year': 'एक बर्ष', 'years': '{0} बर्ष'}

class arrow.locales.NewNorwegianLocale

day_abbreviations: ClassVar[List[str]] = ['', 'må', 'ty', 'on', 'to', 'fr', 'la', 'su']

day_names: ClassVar[List[str]] = ['', 'måndag', 'tysdag', 'onsdag', 'torsdag', 'fredag', 'laurdag', 'sundag']

future: ClassVar[str] = 'om {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'mar', 'apr', 'mai', 'jun', 'jul', 'aug', 'sep', 'okt', 'nov', 'des']

month_names: ClassVar[List[str]] = ['', 'januar', 'februar', 'mars', 'april', 'mai', 'juni', 'juli', 'august', 'september', 'oktober', 'november', 'desember']

names: ClassVar[List[str]] = ['nn', 'nn-no']

past: ClassVar[str] = 'for {0} sidan'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'ein dag', 'days': '{0} dagar', 'hour': 'ein time', 'hours': '{0} timar', 'minute': 'eitt minutt', 'minutes': '{0} minutt', 'month': 'ein månad', 'months': '{0} månader', 'now': 'no nettopp', 'second': 'eitt sekund', 'seconds': '{0} sekund', 'week': 'ei veke', 'weeks': '{0} veker', 'year': 'eitt år', 'years': '{0} år'}

class arrow.locales.NorwegianLocale

day_abbreviations: ClassVar[List[str]] = ['', 'ma', 'ti', 'on', 'to', 'fr', 'lø', 'sø']

day_names: ClassVar[List[str]] = ['', 'mandag', 'tirsdag', 'onsdag', 'torsdag', 'fredag', 'lørdag', 'søndag']

future: ClassVar[str] = 'om {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'mar', 'apr', 'mai', 'jun', 'jul', 'aug', 'sep', 'okt', 'nov', 'des']

month_names: ClassVar[List[str]] = ['', 'januar', 'februar', 'mars', 'april', 'mai', 'juni', 'juli', 'august', 'september', 'oktober', 'november', 'desember']

names: ClassVar[List[str]] = ['nb', 'nb-no']

past: ClassVar[str] = 'for {0} siden'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'en dag', 'days': '{0} dager', 'hour': 'en time', 'hours': '{0} timer', 'minute': 'ett minutt', 'minutes': '{0} minutter', 'month': 'en måned', 'months': '{0} måneder', 'now': 'nå nettopp', 'second': 'ett sekund', 'seconds': '{0} sekunder', 'week': 'en uke', 'weeks': '{0} uker', 'year': 'ett år', 'years': '{0} år'}

class arrow.locales.OdiaLocale

day_abbreviations: ClassVar[List[str]] = ['', 'ସୋମ', 'ମଙ୍ଗଳ', 'ବୁଧ', 'ଗୁରୁ', 'ଶୁକ୍ର', 'ଶନି', 'ରବି']

day_names: ClassVar[List[str]] = ['', 'ସୋମବାର', 'ମଙ୍ଗଳବାର', 'ବୁଧବାର', 'ଗୁରୁବାର', 'ଶୁକ୍ରବାର', 'ଶନିବାର', 'ରବିବାର']

future: ClassVar[str] = '{0} ପରେ'

meridians: ClassVar[Dict[str, str]] = {'AM': 'ପୂର୍ବାହ୍ନ', 'PM': 'ଅପରାହ୍ନ', 'am': 'ପୂର୍ବାହ୍ନ', 'pm': 'ଅପରାହ୍ନ'}

month_abbreviations: ClassVar[List[str]] = ['', 'ଜାନୁ', 'ଫେବୃ', 'ମାର୍ଚ୍ଚ୍', 'ଅପ୍ରେ', 'ମଇ', 'ଜୁନ୍', 'ଜୁଲା', 'ଅଗ', 'ସେପ୍ଟେ', 'ଅକ୍ଟୋ', 'ନଭେ', 'ଡିସେ']

month_names: ClassVar[List[str]] = ['', 'ଜାନୁଆରୀ', 'ଫେବୃଆରୀ', 'ମାର୍ଚ୍ଚ୍', 'ଅପ୍ରେଲ', 'ମଇ', 'ଜୁନ୍', 'ଜୁଲାଇ', 'ଅଗଷ୍ଟ', 'ସେପ୍ଟେମ୍ବର', 'ଅକ୍ଟୋବର୍', 'ନଭେମ୍ବର୍', 'ଡିସେମ୍ବର୍']

names: ClassVar[List[str]] = ['or', 'or-in']

past: ClassVar[str] = '{0} ପୂର୍ବେ'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'ଏକ ଦିନ', 'days': '{0} ଦିନ', 'hour': 'ଏକ ଘଣ୍ଟା', 'hours': '{0} ଘଣ୍ଟା', 'minute': 'ଏକ ମିନଟ', 'minutes': '{0} ମିନଟ', 'month': 'ଏକ ମାସ', 'months': '{0} ମାସ ', 'now': 'ବର୍ତ୍ତମାନ', 'second': 'ଏକ ସେକେଣ୍ଡ', 'seconds': '{0} ସେକେଣ୍ଡ', 'year': 'ଏକ ବର୍ଷ', 'years': '{0} ବର୍ଷ'}

class arrow.locales.PolishLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Pn', 'Wt', 'Śr', 'Czw', 'Pt', 'So', 'Nd']

day_names: ClassVar[List[str]] = ['', 'poniedziałek', 'wtorek', 'środa', 'czwartek', 'piątek', 'sobota', 'niedziela']

future: ClassVar[str] = 'za {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'sty', 'lut', 'mar', 'kwi', 'maj', 'cze', 'lip', 'sie', 'wrz', 'paź', 'lis', 'gru']

month_names: ClassVar[List[str]] = ['', 'styczeń', 'luty', 'marzec', 'kwiecień', 'maj', 'czerwiec', 'lipiec', 'sierpień', 'wrzesień', 'październik', 'listopad', 'grudzień']

names: ClassVar[List[str]] = ['pl', 'pl-pl']

past: ClassVar[str] = '{0} temu'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'dzień', 'days': '{0} dni', 'hour': 'godzinę', 'hours': {'dual': '{0} godziny', 'plural': '{0} godzin', 'singular': '{0} godzin'}, 'minute': 'minutę', 'minutes': {'dual': '{0} minuty', 'plural': '{0} minut', 'singular': '{0} minut'}, 'month': 'miesiąc', 'months': {'dual': '{0} miesiące', 'plural': '{0} miesięcy', 'singular': '{0} miesięcy'}, 'now': 'teraz', 'second': 'sekundę', 'seconds': {'dual': '{0} sekundy', 'plural': '{0} sekund', 'singular': '{0} sekund'}, 'week': 'tydzień', 'weeks': {'dual': '{0} tygodnie', 'plural': '{0} tygodni', 'singular': '{0} tygodni'}, 'year': 'rok', 'years': {'dual': '{0} lata', 'plural': '{0} lat', 'singular': '{0} lat'}}

class arrow.locales.PortugueseLocale

and_word: ClassVar[Optional[str]] = 'e'

day_abbreviations: ClassVar[List[str]] = ['', 'Seg', 'Ter', 'Qua', 'Qui', 'Sex', 'Sab', 'Dom']

day_names: ClassVar[List[str]] = ['', 'Segunda-feira', 'Terça-feira', 'Quarta-feira', 'Quinta-feira', 'Sexta-feira', 'Sábado', 'Domingo']

future: ClassVar[str] = 'em {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Fev', 'Mar', 'Abr', 'Mai', 'Jun', 'Jul', 'Ago', 'Set', 'Out', 'Nov', 'Dez']

month_names: ClassVar[List[str]] = ['', 'Janeiro', 'Fevereiro', 'Março', 'Abril', 'Maio', 'Junho', 'Julho', 'Agosto', 'Setembro', 'Outubro', 'Novembro', 'Dezembro']

names: ClassVar[List[str]] = ['pt', 'pt-pt']

past: ClassVar[str] = 'há {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'um dia', 'days': '{0} dias', 'hour': 'uma hora', 'hours': '{0} horas', 'minute': 'um minuto', 'minutes': '{0} minutos', 'month': 'um mês', 'months': '{0} meses', 'now': 'agora', 'second': 'um segundo', 'seconds': '{0} segundos', 'week': 'uma semana', 'weeks': '{0} semanas', 'year': 'um ano', 'years': '{0} anos'}

class arrow.locales.RomanianLocale

and_word: ClassVar[Optional[str]] = 'și'

day_abbreviations: ClassVar[List[str]] = ['', 'Lun', 'Mar', 'Mie', 'Joi', 'Vin', 'Sâm', 'Dum']

day_names: ClassVar[List[str]] = ['', 'luni', 'marți', 'miercuri', 'joi', 'vineri', 'sâmbătă', 'duminică']

future: ClassVar[str] = 'peste {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'ian', 'febr', 'mart', 'apr', 'mai', 'iun', 'iul', 'aug', 'sept', 'oct', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'ianuarie', 'februarie', 'martie', 'aprilie', 'mai', 'iunie', 'iulie', 'august', 'septembrie', 'octombrie', 'noiembrie', 'decembrie']

names: ClassVar[List[str]] = ['ro', 'ro-ro']

past: ClassVar[str] = '{0} în urmă'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'o zi', 'days': '{0} zile', 'hour': 'o oră', 'hours': '{0} ore', 'minute': 'un minut', 'minutes': '{0} minute', 'month': 'o lună', 'months': '{0} luni', 'now': 'acum', 'second': 'o secunda', 'seconds': '{0} câteva secunde', 'year': 'un an', 'years': '{0} ani'}

class arrow.locales.RomanshLocale

day_abbreviations: ClassVar[List[str]] = ['', 'gli', 'ma', 'me', 'gie', 've', 'so', 'du']

day_names: ClassVar[List[str]] = ['', 'glindesdi', 'mardi', 'mesemna', 'gievgia', 'venderdi', 'sonda', 'dumengia']

future: ClassVar[str] = 'en {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'schan', 'fav', 'mars', 'avr', 'matg', 'zer', 'fan', 'avu', 'set', 'oct', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'schaner', 'favrer', 'mars', 'avrigl', 'matg', 'zercladur', 'fanadur', 'avust', 'settember', 'october', 'november', 'december']

names: ClassVar[List[str]] = ['rm', 'rm-ch']

past: ClassVar[str] = 'avant {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'in di', 'days': '{0} dis', 'hour': "in'ura", 'hours': '{0} ura', 'minute': 'ina minuta', 'minutes': '{0} minutas', 'month': 'in mais', 'months': '{0} mais', 'now': 'en quest mument', 'second': 'in secunda', 'seconds': '{0} secundas', 'week': "in'emna", 'weeks': '{0} emnas', 'year': 'in onn', 'years': '{0} onns'}

class arrow.locales.RussianLocale

day_abbreviations: ClassVar[List[str]] = ['', 'пн', 'вт', 'ср', 'чт', 'пт', 'сб', 'вс']

day_names: ClassVar[List[str]] = ['', 'понедельник', 'вторник', 'среда', 'четверг', 'пятница', 'суббота', 'воскресенье']

future: ClassVar[str] = 'через {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'янв', 'фев', 'мар', 'апр', 'май', 'июн', 'июл', 'авг', 'сен', 'окт', 'ноя', 'дек']

month_names: ClassVar[List[str]] = ['', 'января', 'февраля', 'марта', 'апреля', 'мая', 'июня', 'июля', 'августа', 'сентября', 'октября', 'ноября', 'декабря']

names: ClassVar[List[str]] = ['ru', 'ru-ru']

past: ClassVar[str] = '{0} назад'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'день', 'days': {'dual': '{0} дня', 'plural': '{0} дней', 'singular': '{0} день'}, 'hour': 'час', 'hours': {'dual': '{0} часа', 'plural': '{0} часов', 'singular': '{0} час'}, 'minute': 'минуту', 'minutes': {'dual': '{0} минуты', 'plural': '{0} минут', 'singular': '{0} минуту'}, 'month': 'месяц', 'months': {'dual': '{0} месяца', 'plural': '{0} месяцев', 'singular': '{0} месяц'}, 'now': 'сейчас', 'quarter': 'квартал', 'quarters': {'dual': '{0} квартала', 'plural': '{0} кварталов', 'singular': '{0} квартал'}, 'second': 'секунда', 'seconds': {'dual': '{0} секунды', 'plural': '{0} секунд', 'singular': '{0} секунду'}, 'week': 'неделю', 'weeks': {'dual': '{0} недели', 'plural': '{0} недель', 'singular': '{0} неделю'}, 'year': 'год', 'years': {'dual': '{0} года', 'plural': '{0} лет', 'singular': '{0} год'}}

class arrow.locales.SamiLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Mánnodat', 'Disdat', 'Gaskavahkku', 'Duorastat', 'Bearjadat', 'Lávvordat', 'Sotnabeaivi']

day_names: ClassVar[List[str]] = ['', 'Mánnodat', 'Disdat', 'Gaskavahkku', 'Duorastat', 'Bearjadat', 'Lávvordat', 'Sotnabeaivi']

future: ClassVar[str] = '{0} '

month_abbreviations: ClassVar[List[str]] = ['', 'Ođđajagimánnu', 'Guovvamánnu', 'Njukčamánnu', 'Cuoŋománnu', 'Miessemánnu', 'Geassemánnu', 'Suoidnemánnu', 'Borgemánnu', 'Čakčamánnu', 'Golggotmánnu', 'Skábmamánnu', 'Juovlamánnu']

month_names: ClassVar[List[str]] = ['', 'Ođđajagimánnu', 'Guovvamánnu', 'Njukčamánnu', 'Cuoŋománnu', 'Miessemánnu', 'Geassemánnu', 'Suoidnemánnu', 'Borgemánnu', 'Čakčamánnu', 'Golggotmánnu', 'Skábmamánnu', 'Juovlamánnu']

names: ClassVar[List[str]] = ['se', 'se-fi', 'se-no', 'se-se']

past: ClassVar[str] = '{0} dassái'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'beaivvi', 'days': '{0} beaivvi', 'hour': 'diimmu', 'hours': '{0} diimmu', 'minute': 'minuhta', 'minutes': '{0} minuhta', 'month': 'mánu', 'months': '{0} mánu', 'now': 'dál', 'second': 'sekunda', 'seconds': '{0} sekundda', 'week': 'vahku', 'weeks': '{0} vahku', 'year': 'jagi', 'years': '{0} jagi'}

class arrow.locales.SerbianLocale

and_word: ClassVar[Optional[str]] = 'i'

day_abbreviations: ClassVar[List[str]] = ['', 'po', 'ut', 'sr', 'če', 'pe', 'su', 'ne']

day_names: ClassVar[List[str]] = ['', 'ponedeljak', 'utorak', 'sreda', 'četvrtak', 'petak', 'subota', 'nedelja']

future: ClassVar[str] = 'za {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'mar', 'apr', 'maj', 'jun', 'jul', 'avg', 'sep', 'okt', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'januar', 'februar', 'mart', 'april', 'maj', 'jun', 'jul', 'avgust', 'septembar', 'oktobar', 'novembar', 'decembar']

names: ClassVar[List[str]] = ['sr', 'sr-rs', 'sr-sp']

past: ClassVar[str] = 'pre {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'dan', 'days': {'double': '{0} dana', 'higher': '{0} dana'}, 'hour': 'sat', 'hours': {'double': '{0} sata', 'higher': '{0} sati'}, 'minute': 'minutu', 'minutes': {'double': '{0} minute', 'higher': '{0} minuta'}, 'month': 'mesec', 'months': {'double': '{0} meseca', 'higher': '{0} meseci'}, 'now': 'sada', 'second': 'sekundu', 'seconds': {'double': '{0} sekunde', 'higher': '{0} sekundi'}, 'week': 'nedelju', 'weeks': {'double': '{0} nedelje', 'higher': '{0} nedelja'}, 'year': 'godinu', 'years': {'double': '{0} godine', 'higher': '{0} godina'}}

class arrow.locales.SinhalaLocale

and_word: ClassVar[Optional[str]] = 'සහ'

day_abbreviations: ClassVar[List[str]] = ['', 'සදුද', 'බදා', 'බදා', 'සිකු', 'සෙන', 'අ', 'ඉරිදා']

day_names: ClassVar[List[str]] = ['', 'සදුදා', 'අඟහරැවදා', 'බදාදා', 'බ්\u200dරහස්\u200dපතින්\u200dදා', 'සිකුරාදා', 'සෙනසුරාදා', 'ඉරිදා']

describe(timeframe, delta=1, only_distance=False)

Describes a delta within a timeframe in plain language.

Parameters:

timeframe (Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years']) – a string representing a timeframe.
delta (Union[float, int]) – a quantity representing a delta in a timeframe.
only_distance (bool) – return only distance eg: “11 seconds” without “in” or “ago” keywords

Return type:

str

future: ClassVar[str] = '{0}'

month_abbreviations: ClassVar[List[str]] = ['', 'ජන', 'පෙබ', 'මාර්', 'අප්\u200dරේ', 'මැයි', 'ජුනි', 'ජූලි', 'අගෝ', 'සැප්', 'ඔක්', 'නොවැ', 'දෙසැ']

month_names: ClassVar[List[str]] = ['', 'ජනවාරි', 'පෙබරවාරි', 'මාර්තු', 'අප්\u200dරේල්', 'මැයි', 'ජූනි', 'ජූලි', 'අගෝස්තු', 'සැප්තැම්බර්', 'ඔක්තෝබර්', 'නොවැම්බර්', 'දෙසැම්බර්']

names: ClassVar[List[str]] = ['si', 'si-lk']

past: ClassVar[str] = '{0}ට පෙර'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': {'future': 'දිනකට', 'past': 'දිනක'}, 'days': {'future': 'දින {0} කින්', 'past': 'දින {0} ක'}, 'hour': {'future': 'පැයකින්', 'past': 'පැයක'}, 'hours': {'future': 'පැය {0} කින්', 'past': 'පැය {0} ක'}, 'minute': {'future': 'විනාඩියකින්', 'past': 'විනාඩියක'}, 'minutes': {'future': 'මිනිත්තු {0} කින්', 'past': 'විනාඩි {0} ක'}, 'month': {'future': 'එය මාසය තුළ', 'past': 'මාසයක'}, 'months': {'future': 'මාස {0} කින්', 'past': 'මාස {0} ක'}, 'now': 'දැන්', 'second': {'future': 'තත්පරයකින්', 'past': 'තත්පරයක'}, 'seconds': {'future': 'තත්පර {0} කින්', 'past': 'තත්පර {0} ක'}, 'week': {'future': 'සතියකින්', 'past': 'සතියක'}, 'weeks': {'future': 'සති {0} කින්', 'past': 'සති {0} ක'}, 'year': {'future': 'වසරක් තුළ', 'past': 'වසරක'}, 'years': {'future': 'අවුරුදු {0} තුළ', 'past': 'අවුරුදු {0} ක'}}

timeframes_only_distance = {'day': 'දවසක්', 'days': 'දවස් {0}', 'hour': 'පැයක්', 'hours': 'පැය {0}', 'minute': 'මිනිත්තුවක්', 'minutes': 'විනාඩි {0}', 'month': 'මාසයක්', 'months': 'මාස {0}', 'second': 'තත්පරයක්', 'seconds': 'තත්පර {0}', 'week': 'සතියක්', 'weeks': 'සති {0}', 'year': 'අවුරුද්දක්', 'years': 'අවුරුදු {0}'}

class arrow.locales.SlavicBaseLocale

class arrow.locales.SlovakLocale

and_word: ClassVar[Optional[str]] = 'a'

day_abbreviations: ClassVar[List[str]] = ['', 'po', 'ut', 'st', 'št', 'pi', 'so', 'ne']

day_names: ClassVar[List[str]] = ['', 'pondelok', 'utorok', 'streda', 'štvrtok', 'piatok', 'sobota', 'nedeľa']

future: ClassVar[str] = 'O {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'mar', 'apr', 'máj', 'jún', 'júl', 'aug', 'sep', 'okt', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'január', 'február', 'marec', 'apríl', 'máj', 'jún', 'júl', 'august', 'september', 'október', 'november', 'december']

names: ClassVar[List[str]] = ['sk', 'sk-sk']

past: ClassVar[str] = 'Pred {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': {'future': 'deň', 'past': 'dňom'}, 'days': {'future-paucal': '{0} dní', 'future-singular': '{0} dni', 'past': '{0} dňami', 'zero': '{0} dní'}, 'hour': {'future': 'hodinu', 'past': 'hodinou'}, 'hours': {'future-paucal': '{0} hodín', 'future-singular': '{0} hodiny', 'past': '{0} hodinami', 'zero': '{0} hodín'}, 'minute': {'future': 'minútu', 'past': 'minútou'}, 'minutes': {'future-paucal': '{0} minút', 'future-singular': '{0} minúty', 'past': '{0} minútami', 'zero': '{0} minút'}, 'month': {'future': 'mesiac', 'past': 'mesiacom'}, 'months': {'future-paucal': '{0} mesiacov', 'future-singular': '{0} mesiace', 'past': '{0} mesiacmi', 'zero': '{0} mesiacov'}, 'now': 'Teraz', 'second': {'future': 'sekundu', 'past': 'sekundou'}, 'seconds': {'future-paucal': '{0} sekúnd', 'future-singular': '{0} sekundy', 'past': '{0} sekundami', 'zero': '{0} sekúnd'}, 'week': {'future': 'týždeň', 'past': 'týždňom'}, 'weeks': {'future-paucal': '{0} týždňov', 'future-singular': '{0} týždne', 'past': '{0} týždňami', 'zero': '{0} týždňov'}, 'year': {'future': 'rok', 'past': 'rokom'}, 'years': {'future-paucal': '{0} rokov', 'future-singular': '{0} roky', 'past': '{0} rokmi', 'zero': '{0} rokov'}}

class arrow.locales.SlovenianLocale

and_word: ClassVar[Optional[str]] = 'in'

day_abbreviations: ClassVar[List[str]] = ['', 'Pon', 'Tor', 'Sre', 'Čet', 'Pet', 'Sob', 'Ned']

day_names: ClassVar[List[str]] = ['', 'Ponedeljek', 'Torek', 'Sreda', 'Četrtek', 'Petek', 'Sobota', 'Nedelja']

future: ClassVar[str] = 'čez {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': '', 'PM': '', 'am': '', 'pm': ''}

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Feb', 'Mar', 'Apr', 'Maj', 'Jun', 'Jul', 'Avg', 'Sep', 'Okt', 'Nov', 'Dec']

month_names: ClassVar[List[str]] = ['', 'Januar', 'Februar', 'Marec', 'April', 'Maj', 'Junij', 'Julij', 'Avgust', 'September', 'Oktober', 'November', 'December']

names: ClassVar[List[str]] = ['sl', 'sl-si']

past: ClassVar[str] = 'pred {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'dan', 'days': '{0} dni', 'hour': 'uro', 'hours': '{0} ur', 'minute': 'minuta', 'minutes': '{0} minutami', 'month': 'mesec', 'months': '{0} mesecev', 'now': 'zdaj', 'second': 'sekundo', 'seconds': '{0} sekund', 'year': 'leto', 'years': '{0} let'}

class arrow.locales.SpanishLocale

and_word: ClassVar[Optional[str]] = 'y'

day_abbreviations: ClassVar[List[str]] = ['', 'lun', 'mar', 'mie', 'jue', 'vie', 'sab', 'dom']

day_names: ClassVar[List[str]] = ['', 'lunes', 'martes', 'miércoles', 'jueves', 'viernes', 'sábado', 'domingo']

future: ClassVar[str] = 'en {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': 'AM', 'PM': 'PM', 'am': 'am', 'pm': 'pm'}

month_abbreviations: ClassVar[List[str]] = ['', 'ene', 'feb', 'mar', 'abr', 'may', 'jun', 'jul', 'ago', 'sep', 'oct', 'nov', 'dic']

month_names: ClassVar[List[str]] = ['', 'enero', 'febrero', 'marzo', 'abril', 'mayo', 'junio', 'julio', 'agosto', 'septiembre', 'octubre', 'noviembre', 'diciembre']

names: ClassVar[List[str]] = ['es', 'es-es']

ordinal_day_re: ClassVar[str] = '((?P<value>[1-3]?[0-9](?=[ºª]))[ºª])'

past: ClassVar[str] = 'hace {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'un día', 'days': '{0} días', 'hour': 'una hora', 'hours': '{0} horas', 'minute': 'un minuto', 'minutes': '{0} minutos', 'month': 'un mes', 'months': '{0} meses', 'now': 'ahora', 'second': 'un segundo', 'seconds': '{0} segundos', 'week': 'una semana', 'weeks': '{0} semanas', 'year': 'un año', 'years': '{0} años'}

class arrow.locales.SwahiliLocale

and_word: ClassVar[Optional[str]] = 'na'

day_abbreviations: ClassVar[List[str]] = ['', 'Jumatatu', 'Jumanne', 'Jumatano', 'Alhamisi', 'Ijumaa', 'Jumamosi', 'Jumapili']

day_names: ClassVar[List[str]] = ['', 'Jumatatu', 'Jumanne', 'Jumatano', 'Alhamisi', 'Ijumaa', 'Jumamosi', 'Jumapili']

future: ClassVar[str] = 'muda wa {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': 'ASU', 'PM': 'MCH', 'am': 'asu', 'pm': 'mch'}

month_abbreviations: ClassVar[List[str]] = ['', 'Jan', 'Feb', 'Mac', 'Apr', 'Mei', 'Jun', 'Jul', 'Ago', 'Sep', 'Okt', 'Nov', 'Des']

month_names: ClassVar[List[str]] = ['', 'Januari', 'Februari', 'Machi', 'Aprili', 'Mei', 'Juni', 'Julai', 'Agosti', 'Septemba', 'Oktoba', 'Novemba', 'Desemba']

names: ClassVar[List[str]] = ['sw', 'sw-ke', 'sw-tz']

past: ClassVar[str] = '{0} iliyopita'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'siku moja', 'days': 'siku {0}', 'hour': 'saa moja', 'hours': 'saa {0}', 'minute': 'dakika moja', 'minutes': 'dakika {0}', 'month': 'mwezi moja', 'months': 'miezi {0}', 'now': 'sasa hivi', 'second': 'sekunde', 'seconds': 'sekunde {0}', 'week': 'wiki moja', 'weeks': 'wiki {0}', 'year': 'mwaka moja', 'years': 'miaka {0}'}

class arrow.locales.SwedishLocale

and_word: ClassVar[Optional[str]] = 'och'

day_abbreviations: ClassVar[List[str]] = ['', 'mån', 'tis', 'ons', 'tor', 'fre', 'lör', 'sön']

day_names: ClassVar[List[str]] = ['', 'måndag', 'tisdag', 'onsdag', 'torsdag', 'fredag', 'lördag', 'söndag']

future: ClassVar[str] = 'om {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'jan', 'feb', 'mar', 'apr', 'maj', 'jun', 'jul', 'aug', 'sep', 'okt', 'nov', 'dec']

month_names: ClassVar[List[str]] = ['', 'januari', 'februari', 'mars', 'april', 'maj', 'juni', 'juli', 'augusti', 'september', 'oktober', 'november', 'december']

names: ClassVar[List[str]] = ['sv', 'sv-se']

past: ClassVar[str] = 'för {0} sen'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'en dag', 'days': '{0} dagar', 'hour': 'en timme', 'hours': '{0} timmar', 'minute': 'en minut', 'minutes': '{0} minuter', 'month': 'en månad', 'months': '{0} månader', 'now': 'just nu', 'second': 'en sekund', 'seconds': '{0} sekunder', 'week': 'en vecka', 'weeks': '{0} veckor', 'year': 'ett år', 'years': '{0} år'}

class arrow.locales.SwissLocale

names: ClassVar[List[str]] = ['de-ch']

class arrow.locales.TagalogLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Lun', 'Mar', 'Miy', 'Huw', 'Biy', 'Sab', 'Lin']

day_names: ClassVar[List[str]] = ['', 'Lunes', 'Martes', 'Miyerkules', 'Huwebes', 'Biyernes', 'Sabado', 'Linggo']

future: ClassVar[str] = '{0} mula ngayon'

meridians: ClassVar[Dict[str, str]] = {'AM': 'ng umaga', 'PM': 'ng hapon', 'am': 'nu', 'pm': 'nh'}

month_abbreviations: ClassVar[List[str]] = ['', 'Ene', 'Peb', 'Mar', 'Abr', 'May', 'Hun', 'Hul', 'Ago', 'Set', 'Okt', 'Nob', 'Dis']

month_names: ClassVar[List[str]] = ['', 'Enero', 'Pebrero', 'Marso', 'Abril', 'Mayo', 'Hunyo', 'Hulyo', 'Agosto', 'Setyembre', 'Oktubre', 'Nobyembre', 'Disyembre']

names: ClassVar[List[str]] = ['tl', 'tl-ph']

past: ClassVar[str] = 'nakaraang {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'isang araw', 'days': '{0} araw', 'hour': 'isang oras', 'hours': '{0} oras', 'minute': 'isang minuto', 'minutes': '{0} minuto', 'month': 'isang buwan', 'months': '{0} buwan', 'now': 'ngayon lang', 'second': 'isang segundo', 'seconds': '{0} segundo', 'week': 'isang linggo', 'weeks': '{0} linggo', 'year': 'isang taon', 'years': '{0} taon'}

class arrow.locales.TamilLocale

day_abbreviations: ClassVar[List[str]] = ['', 'திங்கட்', 'செவ்வாய்', 'புதன்', 'வியாழன்', 'வெள்ளி', 'சனி', 'ஞாயிறு']

day_names: ClassVar[List[str]] = ['', 'திங்கட்கிழமை', 'செவ்வாய்க்கிழமை', 'புதன்கிழமை', 'வியாழக்கிழமை', 'வெள்ளிக்கிழமை', 'சனிக்கிழமை', 'ஞாயிற்றுக்கிழமை']

future: ClassVar[str] = 'இல் {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'ஜன', 'பிப்', 'மார்', 'ஏப்', 'மே', 'ஜூன்', 'ஜூலை', 'ஆக', 'செப்', 'அக்', 'நவ', 'டிச']

month_names: ClassVar[List[str]] = ['', 'சித்திரை', 'வைகாசி', 'ஆனி', 'ஆடி', 'ஆவணி', 'புரட்டாசி', 'ஐப்பசி', 'கார்த்திகை', 'மார்கழி', 'தை', 'மாசி', 'பங்குனி']

names: ClassVar[List[str]] = ['ta', 'ta-in', 'ta-lk']

past: ClassVar[str] = '{0} நேரத்திற்கு முன்பு'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'ஒரு நாள்', 'days': '{0} நாட்கள்', 'hour': 'ஒரு மணி', 'hours': '{0} மணிநேரம்', 'minute': 'ஒரு நிமிடம்', 'minutes': '{0} நிமிடங்கள்', 'month': 'ஒரு மாதம்', 'months': '{0} மாதங்கள்', 'now': 'இப்போது', 'second': 'ஒரு இரண்டாவது', 'seconds': '{0} விநாடிகள்', 'week': 'ஒரு வாரம்', 'weeks': '{0} வாரங்கள்', 'year': 'ஒரு ஆண்டு', 'years': '{0} ஆண்டுகள்'}

class arrow.locales.ThaiLocale

BE_OFFSET = 543

day_abbreviations: ClassVar[List[str]] = ['', 'จ', 'อ', 'พ', 'พฤ', 'ศ', 'ส', 'อา']

day_names: ClassVar[List[str]] = ['', 'จันทร์', 'อังคาร', 'พุธ', 'พฤหัสบดี', 'ศุกร์', 'เสาร์', 'อาทิตย์']

future: ClassVar[str] = 'ในอีก {0}'

meridians: ClassVar[Dict[str, str]] = {'AM': 'AM', 'PM': 'PM', 'am': 'am', 'pm': 'pm'}

month_abbreviations: ClassVar[List[str]] = ['', 'ม.ค.', 'ก.พ.', 'มี.ค.', 'เม.ย.', 'พ.ค.', 'มิ.ย.', 'ก.ค.', 'ส.ค.', 'ก.ย.', 'ต.ค.', 'พ.ย.', 'ธ.ค.']

month_names: ClassVar[List[str]] = ['', 'มกราคม', 'กุมภาพันธ์', 'มีนาคม', 'เมษายน', 'พฤษภาคม', 'มิถุนายน', 'กรกฎาคม', 'สิงหาคม', 'กันยายน', 'ตุลาคม', 'พฤศจิกายน', 'ธันวาคม']

names: ClassVar[List[str]] = ['th', 'th-th']

past: ClassVar[str] = '{0} ที่ผ่านมา'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': '1 วัน', 'days': '{0} วัน', 'hour': '1 ชั่วโมง', 'hours': '{0} ชั่วโมง', 'minute': '1 นาที', 'minutes': '{0} นาที', 'month': '1 เดือน', 'months': '{0} เดือน', 'now': 'ขณะนี้', 'second': 'วินาที', 'seconds': '{0} ไม่กี่วินาที', 'year': '1 ปี', 'years': '{0} ปี'}

year_abbreviation(year)

Thai always use Buddhist Era (BE) which is CE + 543

Return type:: str

year_full(year)

Thai always use Buddhist Era (BE) which is CE + 543

Return type:: str

class arrow.locales.TurkishLocale

and_word: ClassVar[Optional[str]] = 've'

day_abbreviations: ClassVar[List[str]] = ['', 'Pzt', 'Sal', 'Çar', 'Per', 'Cum', 'Cmt', 'Paz']

day_names: ClassVar[List[str]] = ['', 'Pazartesi', 'Salı', 'Çarşamba', 'Perşembe', 'Cuma', 'Cumartesi', 'Pazar']

future: ClassVar[str] = '{0} sonra'

meridians: ClassVar[Dict[str, str]] = {'AM': 'ÖÖ', 'PM': 'ÖS', 'am': 'öö', 'pm': 'ös'}

month_abbreviations: ClassVar[List[str]] = ['', 'Oca', 'Şub', 'Mar', 'Nis', 'May', 'Haz', 'Tem', 'Ağu', 'Eyl', 'Eki', 'Kas', 'Ara']

month_names: ClassVar[List[str]] = ['', 'Ocak', 'Şubat', 'Mart', 'Nisan', 'Mayıs', 'Haziran', 'Temmuz', 'Ağustos', 'Eylül', 'Ekim', 'Kasım', 'Aralık']

names: ClassVar[List[str]] = ['tr', 'tr-tr']

past: ClassVar[str] = '{0} önce'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'bir gün', 'days': '{0} gün', 'hour': 'bir saat', 'hours': '{0} saat', 'minute': 'bir dakika', 'minutes': '{0} dakika', 'month': 'bir ay', 'months': '{0} ay', 'now': 'şimdi', 'second': 'bir saniye', 'seconds': '{0} saniye', 'week': 'bir hafta', 'weeks': '{0} hafta', 'year': 'bir yıl', 'years': '{0} yıl'}

class arrow.locales.UkrainianLocale

day_abbreviations: ClassVar[List[str]] = ['', 'пн', 'вт', 'ср', 'чт', 'пт', 'сб', 'нд']

day_names: ClassVar[List[str]] = ['', 'понеділок', 'вівторок', 'середа', 'четвер', 'п’ятниця', 'субота', 'неділя']

future: ClassVar[str] = 'за {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'січ', 'лют', 'бер', 'квіт', 'трав', 'черв', 'лип', 'серп', 'вер', 'жовт', 'лист', 'груд']

month_names: ClassVar[List[str]] = ['', 'січня', 'лютого', 'березня', 'квітня', 'травня', 'червня', 'липня', 'серпня', 'вересня', 'жовтня', 'листопада', 'грудня']

names: ClassVar[List[str]] = ['ua', 'uk', 'uk-ua']

past: ClassVar[str] = '{0} тому'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': 'день', 'days': {'dual': '{0} дні', 'plural': '{0} днів', 'singular': '{0} день'}, 'hour': 'годину', 'hours': {'dual': '{0} години', 'plural': '{0} годин', 'singular': '{0} годину'}, 'minute': 'хвилину', 'minutes': {'dual': '{0} хвилини', 'plural': '{0} хвилин', 'singular': '{0} хвилину'}, 'month': 'місяць', 'months': {'dual': '{0} місяці', 'plural': '{0} місяців', 'singular': '{0} місяць'}, 'now': 'зараз', 'second': 'секунда', 'seconds': '{0} кілька секунд', 'year': 'рік', 'years': {'dual': '{0} роки', 'plural': '{0} років', 'singular': '{0} рік'}}

class arrow.locales.UrduLocale

and_word: ClassVar[Optional[str]] = 'اور'

day_abbreviations: ClassVar[List[str]] = ['', 'سوموار', 'منگل', 'بدھ', 'جمعرات', 'جمعہ', 'ہفتہ', 'اتوار']

day_names: ClassVar[List[str]] = ['', 'سوموار', 'منگل', 'بدھ', 'جمعرات', 'جمعہ', 'ہفتہ', 'اتوار']

future: ClassVar[str] = 'میں {0}'

month_abbreviations: ClassVar[List[str]] = ['', 'جنوری', 'فروری', 'مارچ', 'اپریل', 'مئی', 'جون', 'جولائی', 'اگست', 'ستمبر', 'اکتوبر', 'نومبر', 'دسمبر']

month_names: ClassVar[List[str]] = ['', 'جنوری', 'فروری', 'مارچ', 'اپریل', 'مئی', 'جون', 'جولائی', 'اگست', 'ستمبر', 'اکتوبر', 'نومبر', 'دسمبر']

names: ClassVar[List[str]] = ['ur', 'ur-pk']

past: ClassVar[str] = 'پہلے {0}'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'ایک دن', 'days': '{0} دن', 'hour': 'ایک گھنٹے', 'hours': '{0} گھنٹے', 'minute': 'ایک منٹ', 'minutes': '{0} منٹ', 'month': 'ایک مہینہ', 'months': '{0} ماہ', 'now': 'ابھی', 'second': 'ایک سیکنڈ', 'seconds': '{0} سیکنڈ', 'week': 'ایک ہفتے', 'weeks': '{0} ہفتے', 'year': 'ایک سال', 'years': '{0} سال'}

class arrow.locales.UzbekLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Dush', 'Sesh', 'Chor', 'Pay', 'Jum', 'Shan', 'Yak']

day_names: ClassVar[List[str]] = ['', 'Dushanba', 'Seshanba', 'Chorshanba', 'Payshanba', 'Juma', 'Shanba', 'Yakshanba']

future: ClassVar[str] = '{0}dan keyin'

month_abbreviations: ClassVar[List[str]] = ['', 'Yan', 'Fev', 'Mar', 'Apr', 'May', 'Iyn', 'Iyl', 'Avg', 'Sen', 'Okt', 'Noy', 'Dek']

month_names: ClassVar[List[str]] = ['', 'Yanvar', 'Fevral', 'Mart', 'Aprel', 'May', 'Iyun', 'Iyul', 'Avgust', 'Sentyabr', 'Oktyabr', 'Noyabr', 'Dekabr']

names: ClassVar[List[str]] = ['uz', 'uz-uz']

past: ClassVar[str] = '{0}dan avval'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'bir kun', 'days': '{0} kun', 'hour': 'bir soat', 'hours': '{0} soat', 'minute': 'bir daqiqa', 'minutes': '{0} daqiqa', 'month': 'bir oy', 'months': '{0} oy', 'now': 'hozir', 'second': 'bir soniya', 'seconds': '{0} soniya', 'week': 'bir hafta', 'weeks': '{0} hafta', 'year': 'bir yil', 'years': '{0} yil'}

class arrow.locales.VietnameseLocale

day_abbreviations: ClassVar[List[str]] = ['', 'Thứ 2', 'Thứ 3', 'Thứ 4', 'Thứ 5', 'Thứ 6', 'Thứ 7', 'CN']

day_names: ClassVar[List[str]] = ['', 'Thứ Hai', 'Thứ Ba', 'Thứ Tư', 'Thứ Năm', 'Thứ Sáu', 'Thứ Bảy', 'Chủ Nhật']

future: ClassVar[str] = '{0} nữa'

month_abbreviations: ClassVar[List[str]] = ['', 'Tháng 1', 'Tháng 2', 'Tháng 3', 'Tháng 4', 'Tháng 5', 'Tháng 6', 'Tháng 7', 'Tháng 8', 'Tháng 9', 'Tháng 10', 'Tháng 11', 'Tháng 12']

month_names: ClassVar[List[str]] = ['', 'Tháng Một', 'Tháng Hai', 'Tháng Ba', 'Tháng Tư', 'Tháng Năm', 'Tháng Sáu', 'Tháng Bảy', 'Tháng Tám', 'Tháng Chín', 'Tháng Mười', 'Tháng Mười Một', 'Tháng Mười Hai']

names: ClassVar[List[str]] = ['vi', 'vi-vn']

past: ClassVar[str] = '{0} trước'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]]]] = {'day': 'một ngày', 'days': '{0} ngày', 'hour': 'một giờ', 'hours': '{0} giờ', 'minute': 'một phút', 'minutes': '{0} phút', 'month': 'một tháng', 'months': '{0} tháng', 'now': 'hiện tại', 'second': 'một giây', 'seconds': '{0} giây', 'week': 'một tuần', 'weeks': '{0} tuần', 'year': 'một năm', 'years': '{0} năm'}

class arrow.locales.ZuluLocale

and_word: ClassVar[Optional[str]] = 'futhi'

day_abbreviations: ClassVar[List[str]] = ['', 'uMsombuluko', 'uLwesibili', 'uLwesithathu', 'uLwesine', 'uLwesihlanu', 'uMgqibelo', 'iSonto']

day_names: ClassVar[List[str]] = ['', 'uMsombuluko', 'uLwesibili', 'uLwesithathu', 'uLwesine', 'uLwesihlanu', 'uMgqibelo', 'iSonto']

future: ClassVar[str] = '{0} '

month_abbreviations: ClassVar[List[str]] = ['', 'uMasingane', 'uNhlolanja', 'uNdasa', 'UMbasa', 'UNhlaba', 'UNhlangulana', 'uNtulikazi', 'UNcwaba', 'uMandulo', 'uMfumfu', 'uLwezi', 'uZibandlela']

month_names: ClassVar[List[str]] = ['', 'uMasingane', 'uNhlolanja', 'uNdasa', 'UMbasa', 'UNhlaba', 'UNhlangulana', 'uNtulikazi', 'UNcwaba', 'uMandulo', 'uMfumfu', 'uLwezi', 'uZibandlela']

names: ClassVar[List[str]] = ['zu', 'zu-za']

past: ClassVar[str] = '{0} edlule'

timeframes: ClassVar[Mapping[Literal['now', 'second', 'seconds', 'minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'], Union[str, Mapping[str, str]]]] = {'day': {'future': 'ngosuku', 'past': 'usuku'}, 'days': {'future': '{0} ezinsukwini', 'past': '{0} izinsuku'}, 'hour': {'future': 'ngehora', 'past': 'ihora'}, 'hours': {'future': '{0} emahoreni', 'past': '{0} amahora'}, 'minute': {'future': 'ngomzuzu', 'past': 'umzuzu'}, 'minutes': {'future': '{0} ngemizuzu', 'past': '{0} imizuzu'}, 'month': {'future': 'ngenyanga', 'past': 'inyanga'}, 'months': {'future': '{0} ezinyangeni', 'past': '{0} izinyanga'}, 'now': 'manje', 'second': {'future': 'ngomzuzwana', 'past': 'umzuzwana'}, 'seconds': {'future': '{0} ngemizuzwana', 'past': '{0} imizuzwana'}, 'week': {'future': 'ngesonto', 'past': 'isonto'}, 'weeks': {'future': '{0} emasontweni', 'past': '{0} amasonto'}, 'year': {'future': 'ngonyak', 'past': 'unyaka'}, 'years': {'future': '{0} eminyakeni', 'past': '{0} iminyaka'}}

arrow.locales.get_locale(name)

Returns an appropriate Locale corresponding to an input locale name.

Parameters:: name (str) – the name of the locale.
Return type:: Locale

arrow.locales.get_locale_by_class_name(name)

Returns an appropriate Locale corresponding to an locale class name.

Parameters:: name (str) – the name of the locale class.
Return type:: Locale

API Guide

arrow.arrow

arrow.factory

arrow.api

arrow.locale

`arrow.arrow`

`arrow.factory`

`arrow.api`

`arrow.locale`