iso_8601¶

Note

This module requires ciso8601, which pip users can install with the jnrbase[iso_8601] requirement.

Functions¶

Duration support¶

jnrbase.iso_8601.parse_delta(__string)[source]¶

Parse ISO-8601 duration string.

Parameters: __string (str) – Duration string to parse
Return type: timedelta
Returns: Parsed delta object

jnrbase.iso_8601.format_delta(__timedelta)[source]¶

Format ISO-8601 duration string.

Parameters: __timedelta (timedelta) – Duration to process
Return type: str
Returns: ISO-8601 representation of duration

Timestamp support¶

jnrbase.iso_8601.parse_datetime(__string)[source]¶

Parse ISO-8601 datetime string.

Parameters: __string (str) – Datetime string to parse
Return type: datetime
Returns: Parsed datetime object

jnrbase.iso_8601.format_datetime(__datetime)[source]¶

Format ISO-8601 datetime string.

Parameters: __datetime (datetime) – Datetime to process
Return type: str
Returns: ISO-8601 compatible string

Examples¶

>>> delta = 'PT02H07M43S'
>>> parse_delta(delta)
datetime.timedelta(seconds=7663)
>>> format_delta(parse_delta(delta)) == delta
True
>>> timestamp = '2016-12-01T13:02:26Z'
>>> parse_datetime(timestamp)
datetime.datetime(2016, 12, 1, 13, 2, 26, tzinfo=datetime.timezone.utc)
>>> format_datetime(parse_datetime(timestamp)) == timestamp
True