Skip to main content

Democritus functions for working with timezones.

Project description

Democritus Timezones

PyPI CI Lint codecov The Democritus Project uses semver version 2.0.0 The Democritus Project uses black to format code License: LGPL v3

Democritus functions[1] for working with timezones.

[1] Democritus functions are simple, effective, modular, well-tested, and well-documented Python functions.

We use d8s (pronounced "dee-eights") as an abbreviation for democritus (you can read more about this here).


pip install d8s-timezones


You import the library like:

from d8s_timezones import *

Once imported, you can use any of the functions listed below.


  • def pytz_timezone_object(timezone_name: str):
        """Create a pytz timezone object for the given timezone_name."""
  • def pytz_country_names():
        """Get a dictionary with countries's ISO 3166 country code as keys and the country name as the value."""
  • def pytz_country_timezones():
        """Get a dictionary with countries's names as keys and the timezones as values."""
  • def timezones_names():
        """Get a list of all timezones."""
  • def timezone_utc_offset(timezone_name: str, date):
        """Find how many hours the given timezone is off from UTC."""
  • def timezone_abbreviation(timezone_name: str, date):
        """Find the abbreviation for the given timezone_name."""
  • def country_timezone_abbreviation(country_name: str, date):
        """Find the abbreviation for the given country_name."""
  • def country_code_timezone_abbreviation(iso_3166_country_code: str, date):
        """Find the abbreviation for the given iso_3166_country_code."""
  • def country_code_timezones(iso_3166_country_code):
        """Find the timezones for the country with the given iso_3166_country_code."""
  • def country_timezones(country_name):
        """Find the timezones for the given country."""
  • def timezone_countries(timezone_name):
        """Find countries in the given timezone_name."""


👋  If you want to get involved in this project, we have some short, helpful guides below:

If you have any questions or there is anything we did not cover, please raise an issue and we'll be happy to help.


This package was created with Cookiecutter and Floyd Hightower's Python project template.

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

d8s_timezones-0.5.0.tar.gz (26.5 kB view hashes)

Uploaded source

Built Distribution

d8s_timezones-0.5.0-py2.py3-none-any.whl (21.8 kB view hashes)

Uploaded py2 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