Skip to main content

Parse human-readable date/time text.

Project description


Parse human-readable date/time strings.

Python 2.7 or greater is required for parsedatetime version 1.0 or greater.

Downloads Travis CI Codecov Requirements Status


You can install parsedatetime using:

pip install parsedatetime

Running Tests

From the source directory:

make test

To run tests on several python versions, type tox:

$ tox
[... tox creates a virtualenv for every python version and runs tests inside of each]
py27: commands succeeded
py35: commands succeeded

This assumes that you have python2.7, python3.5, etc in PATH.

Using parsedatetime

An example of how to use parsedatetime:

import parsedatetime

cal = parsedatetime.Calendar()


To get it to a Python datetime object:

from datetime import datetime
from time import mktime

time_struct, parse_status = cal.parse("tomorrow")

Parse datetime with timezone support (using pytz package):

import parsedatetime
import pytz
from pytz import timezone

cal = parsedatetime.Calendar()

datetime_obj, _ = cal.parseDT(datetimeString="tomorrow", tzinfo=timezone("US/Pacific"))

More detailed examples can be found in the examples directory.


The generated documentation is included by default in the docs directory and can also be viewed online at

The docs can be generated by running:

make docs


The Calendar class has a member property named ptc which is created during the class init method to be an instance of parsedatetime_consts.CalendarConstants().


The code in parsedatetime has been implemented over the years in many different languages (C, Clipper, Delphi) as part of different custom/proprietary systems I’ve worked on. Sadly the previous code is not “open” in any sense of that word.

When I went to work for Open Source Applications Foundation and realized that the Chandler project could benefit from my experience with parsing of date/time text I decided to start from scratch and implement the code using Python and make it truly open.

After working on the initial concept and creating something that could be shown to the Chandler folks the code has now evolved to it’s current state with the help the Chandler folks, most especially Darshana.

Project details

Download files

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

Files for parsedatetime, version 2.1
Filename, size File type Python version Upload date Hashes
Filename, size parsedatetime-2.1-py2-none-any.whl (37.8 kB) File type Wheel Python version 2.6 Upload date Hashes View hashes
Filename, size parsedatetime-2.1.tar.gz (56.3 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page