Skip to main content

New date and time classes

Project description

datetime2 Build Status

The datetime2 module provides similar features to those given by the standard datetime module, adding the capability of constructing and representing date and time in many formats. Additionally, it removes a few limits that the original package has.

datetime2 is a one-man, free-time work. Project is hosted at GitHub, please follow the source code link on the right to see the latest version of this page (e.g. for an updated release map).

Current and future releases


  • 0.9.2 and 0.9.3: Reorganization of documentation


  • 0.9.4: Implementation of WesternTimeDelta
  • 1.0: Implementation of DateTime, first production release
  • 1.1: Implementation of Julian and Hebrew calendars

Project objectives

  • Decoupling between operations on date and time objects and their representation.
  • Access to different calendars, for input parsing and output formatting.
  • Access to different time representations, also for input and output.
  • Infinite precision in converting between different time representations.
  • Ability to dynamically register new formatting classes.
  • Internationalization.
  • Implementation of the part of the Unicode Locale Database concerned with dates and times.
  • Interface with other Python modules or inclusion of their functionalities in submodules.

These objectives are very long term ones, which I am setting because I think it is important to establish a direction for the project.


Datetime2 is distributed under the terms of the new BSD license. You are free to use it for commercial or non-commercial projects with little or no restriction, all I ask is that:

  • Redistributions of the code, in whole or part, retain the original copyright notice and license text.
  • You do not claim my endorsement of any derived product.

For a complete text of the license see the LICENSE.txt file in the source distribution.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

datetime2-0.9.2.tar.gz (12.9 kB view hashes)

Uploaded source

Built Distribution

datetime2-0.9.2-py3-none-any.whl (16.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page