---
id: isodate
version: "0.7.2"
license: Copyright (c) 2021, Hugo van Kemenade and contributors Copyright (c) 2009-2018, Gerhard Weis and contributors Copyright (c) 2009, Gerhard Weis All rights reserved. Redistribution and use in source… (full text in the JSON record)
license_treatment: permissive
maintenance: dormant
---

# isodate — An ISO 8601 date/time/duration parser and formatter

License: permissive · Maintenance: dormant · Popularity: top 1,000 on PyPI

## Install

pip install isodate
uv add isodate
poetry add isodate

## Description

ISO 8601 date/time parser
=========================

.. image:: https://travis-ci.org/gweis/isodate.svg?branch=master
    :target: https://travis-ci.org/gweis/isodate
    :alt: Travis-CI
.. image:: https://coveralls.io/repos/gweis/isodate/badge.svg?branch=master
    :target: https://coveralls.io/r/gweis/isodate?branch=master
    :alt: Coveralls
.. image:: https://img.shields.io/pypi/v/isodate.svg
    :target: https://pypi.python.org/pypi/isodate/
    :alt: Latest Version
.. image:: https://img.shields.io/pypi/l/isodate.svg
    :target: https://pypi.python.org/pypi/isodate/
    :alt: License


This module implements ISO 8601 date, time and duration parsing.
The implementation follows ISO8601:2004 standard, and implements only
date/time representations mentioned in the standard. If something is not
mentioned there, then it is treated as non existent, and not as an allowed
option.

For instance, ISO8601:2004 never mentions 2 digit years. So, it is not
intended by this module to support 2 digit years. (while it may still
be valid as ISO date, because it is not explicitly forbidden.)
Another example is, when no time zone information is given for a time,
then it should be interpreted...

## AI interpretation — verify before relying

Parses and formats ISO 8601 date, time, duration, and timezone strings into Python standard types like date, datetime, timedelta, and a custom Duration class for year/month precision.

Verdict: Stable, lightweight ISO 8601 parser with zero dependencies and broad Python version support. No known vulnerabilities. Dormant maintenance is typical for a mature, feature-complete library; suitable for production use where ISO date/time parsing is needed.

[View on SkillFed](https://skillfed.io/packages/isodate) · [View on PyPI](https://pypi.org/project/isodate/)