Skip to main content

Convert a future date to a human-friendly english format

Project description


Python utility to write future dates in a human-friendly way.


This packages is on PyPi, so assuming you have setup tools installed, it’s just a matter of doing

pip install humanfuture

Humanizing Your Future

The humanize function in humanfuture is the one you want. Just pass in a datetime object for sometime in the future and it should spit out a nice english string.

If you need to get out relative futures from some time other than now, you can pass in a reference datetime as the second arguement.

Dealing with Your Past

Two exceptions could be thrown by this module, a humanfuture.NegativeDeltaError, or a humanfuture.UnformattableError. The second one should never actually occur. Please let me know if you ever come across it. But the first one you need to watch out for.

This module’s scope is restricted to future times, so it throws that humanfuture.NegativeDeltaError if you give it a futures past. To avoid this, either check your futures before submitting, or if you’re unsure, put the conversion in a try/catch block and deal with it there.


Although this is a completely new module, some inspiration was taken from the lovely (humanize)[] module.

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 HumanFuture, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size HumanFuture-0.1.1.tar.gz (2.6 kB) File type Source Python version None Upload date Hashes View

Supported by

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