Text of pypi.org › project › python-dateutil as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

python-dateutil · PyPI

Skip to main content python-dateutil 4.0.0 Extensions to the standard Python datetime module pip install python-dateutil dateutil - powerful extensions to datetime The dateutil module provides powerful extensions to the standard datetime module, available in Python. Installation dateutil can be installed from PyPI using pip (note that the package name is different from the importable name): pip install python-dateutil Download dateutil is available on PyPI https://pypi.org/project/python-dateutil/ The documentation is hosted at: https://dateutil.readthedocs.io/en/stable/ Code The code and issue tracker are hosted on GitHub: https://github.com/dateutil/dateutil/ Features Computing of relative deltas (next month, next year, next Monday, last week of month, etc); Computing of relative deltas between two given date and/or datetime objects; Computing of dates based on very flexible recurrence rules, using a superset of the iCalendar specification.

Parsing of RFC strings is supported as well. Generic parsing of dates in almost any string format; Timezone (tzinfo) implementations for tzfile(5) format files (/etc/localtime, /usr/share/zoneinfo, etc), TZ environment string (in all known formats), iCalendar format files, given ranges (with help from relative deltas), local machine timezone, fixed offset timezone, UTC timezone, and Windows registry-based time zones. Internal up-to-date world timezone information based on Olson’s database.

Computing of Easter Sunday dates for any given year, using Western, Orthodox or Julian algorithms; A comprehensive test suite. Quick example Here’s a snapshot, just to give an idea about the power of the package. For more examples, look at the documentation. Suppose you want to know how much time is left, in years/months/days/etc, before the next easter happening on a year with a Friday 13th in August, and you want to get today’s date out of the “date” unix system command.

Here is the code: >>> from dateutil.relativedelta import * >>> from dateutil.easter import * >>> from dateutil.rrule import * >>> from dateutil.parser import * >>> from datetime import * >>> now = parse ( "Sat Oct 11 17:13:46 UTC 2003" ) >>> today = now . date () >>> year = rrule ( YEARLY , dtstart = now , bymonth = 8 , bymonthday = 13 , byweekday = FR )[ 0 ] . year >>> rdelta = relativedelta ( easter ( year ), today ) >>> print ( "Today is: %s " % today ) Today is : 2003 - 10 - 11 >>> print ( "Year with next Aug 13th on a Friday is: %s " % year ) Year with next Aug 13 th on a Friday is : 2004 >>> print ( "How far is the Easter of that year: %s " % rdelta ) How far is the Easter of that year : relativedelta ( months =+ 6 ) >>> print ( "And the Easter of that year is: %s " % ( today + rdelta )) And the Easter of that year is : 2004 - 04 - 11 Being exactly 6 months ahead was really a coincidence :) Contributing We welcome many types of contributions - bug reports, pull requests (code, infrastructure or documentation fixes).

For more information about how to contribute to the project, see the CONTRIBUTING.md file in the repository. Author The dateutil module was written by Gustavo Niemeyer < gustavo @ niemeyer . net > in 2003. It is maintained by: Gustavo Niemeyer < gustavo @ niemeyer . net > 2003-2011 Tomi Pieviläinen < tomi . pievilainen @ iki . fi > 2012-2014 Yaron de Leeuw < me @ jarondl . net > 2014-2016 Paul Ganssle < paul @ ganssle . io > 2015- Starting with version 2.4.1 and running until 2.8.2, all source and binary distributions will be signed by a PGP key that has, at the very least, been signed by the key which made the previous release.

A table of release signing keys can be found below: Releases Signing key fingerprint 2.4.1-2.8.2 6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB New releases may have signed tags, but binary and source distributions uploaded to PyPI will no longer have GPG signatures attached. License All contributions after December 1, 2017 released under dual license - either Apache 2.0 License or the BSD 3-Clause License . Contributions before December 1, 2017 - except those those explicitly relicensed - are released only under the BSD 3-Clause License.

Project links Data verified by PyPI on Nov 1, 2026 Data provided by the project maintainers, verified at the time the release was uploaded to PyPI. Homepage Source Documentation Key dates PyPI data Data sourced directly from PyPI's database. Released: Nov 1, 2026 Latest release 4 maintainers PyPI data Data sourced directly from PyPI's database. dateutilbot jarondl pganssle +1 more tpievila Credits Author: Gustavo Niemeyer Maintainer: Paul Ganssle GitHub Statistics Data verified by PyPI on Nov 1, 2026 The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload.

Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified. Repository Stars: Forks: Open issues: Open PRs: Provenance Data verified by PyPI on Nov 1, 2026 Data provided by the project maintainers and verified by PyPI at the time of upload. Full provenance Both files in this release have provenance metadata. View provenance details License expression BSD-3-Clause View SPDX License List Requires Python >=3.11 Classifiers Development Status 5 - Production/Stable Intended Audience Developers Programming Language Python Python :: 3 Python :: 3.11 Python :: 3.12 Python :: 3.13 Python :: 3.14 Python :: 3.15 Python :: Free Threading :: 2 - Beta Python :: Implementation :: CPython Python :: Implementation :: PyPy Topic Software Development :: Libraries Metadata Project links Data verified by PyPI on Nov 1, 2026 Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Homepage Source Documentation Key dates PyPI data Data sourced directly from PyPI's database. Released: Nov 1, 2026 Latest release 4 maintainers PyPI data Data sourced directly from PyPI's database. dateutilbot jarondl pganssle +1 more tpievila Credits Author: Gustavo Niemeyer Maintainer: Paul Ganssle GitHub Statistics Data verified by PyPI on Nov 1, 2026 The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload.

Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified. Repository Stars: Forks: Open issues: Open PRs: Provenance Data verified by PyPI on Nov 1, 2026 Data provided by the project maintainers and verified by PyPI at the time of upload. Full provenance Both files in this release have provenance metadata. View provenance details License expression BSD-3-Clause View SPDX License List Requires Python >=3.11 Classifiers Development Status 5 - Production/Stable Intended Audience Developers Programming Language Python Python :: 3 Python :: 3.11 Python :: 3.12 Python :: 3.13 Python :: 3.14 Python :: 3.15 Python :: Free Threading :: 2 - Beta Python :: Implementation :: CPython Python :: Implementation :: PyPy Topic Software Development :: Libraries Release files for python-dateutil 4.0.0 For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation .

Source distribution (sdist) Source distribution for python-dateutil 4.0.0 File Size Uploaded Provenance Actions python_dateutil-4.0.0.tar.gz 250.4 kB Nov 1, 2026 With provenance Details for python_dateutil-4.0.0.tar.gz Built distribution (wheel) Table of built distributions (wheels) for python-dateutil 4.0.0 File Interpreter ABI Platform Actions Reset python_dateutil-4.0.0-py3-none-any.whl 92.9 kB Nov 1, 2026 With provenance Python 3 none any Details for python_dateutil-4.0.0-py3-none-any.whl Total release size: 343.3 kB Release files / python_dateutil-4.0.0.tar.gz Download URL python_dateutil-4.0.0.tar.gz Size 250.4 kB Tags Source SHA-256 checksum How to use checksums d7295ff14fdc0f92f662100bfb6c551d160ca090f2939f1ec5b9794265c03f06 BLAKE2b-256 checksum How to use checksums 1839b3927f3616f

The rest of this page is on the live site.