Skip to main content

Timezone Converter

Compare a full day of your local timezone with foreign ones


integration status deployment status pre-commit.ci status python version latest release code style

$ timezone-converter tijuana --zone $ timezone-converter tijuana new_york
comparison between two timezones with zone info comparison between three timezones

Motivation

When working with people that are not in your local timezone, the available resources are the usual webpages that only show one hour at a time, which is pretty inconvenient.

With this package you can quickly compare a full day of your timezone against foreign ones.

Installation

pip install -U timezone-converter

Usage

timezone-converter <timezone> [<timezone> ...]

Useful flags:

timezone-converter tijuana new_york --zone
timezone-converter tijuana new_york --order
timezone-converter tijuana --single 14
timezone-converter --search york
timezone-converter --list tbd

Docker

docker run --rm -t bledy/timezone-converter <timezone> [<timezone> ...]

Features

Comparison between multiple timezones

Multiple timezones can be provided to get a side-by-side comparison. Short timezone names such as new_york are supported, as are canonical timezone paths such as America/New_York.

Current hour highlighting

The row containing the current hour will be highlighted.

Zone abbreviations

Using the --zone argument, each column header will include the timezone abbreviation for that day, such as PST or CEST.

Ordered columns

Using the --order argument, timezone columns will be sorted by their offset difference from your local timezone.

Output a single hour

Using the --single argument, you can output a single hour. If you don't provide a value, the current hour will be displayed.

Search for a timezone

Using the --search argument, you can fuzzy-search for available timezone names.

List of available timezones

Using the --list argument, you can see a pretty list of available timezones, by groups, and sorted alphabetically. You can optionally provide letters to filter the groups that are shown.

$ timezone-converter --list

list of available timezones

License

This project is licensed under the terms of the MIT license.

Metadata

Release files for timezone-converter 0.16.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for timezone-converter 0.16.1
File Size Uploaded
timezone_converter-0.16.1.tar.gz 7.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for timezone-converter 0.16.1
File Interpreter ABI Platform
timezone_converter-0.16.1-py3-none-any.whl Python 3 none any Details

Total release size: 17.0 kB

Release files / timezone_converter-0.16.1.tar.gz

Download URL timezone_converter-0.16.1.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
75b545fdaad51e2ba0836f59edcab694c5f1fccc07d00a292533aca3344ceacd
BLAKE2b-256 checksum
How to use checksums
48f7db27c8a8bbf1a40915d912494acc34d2794d3d22d546e7313e931a64c5f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 1, 2026.

Transparency log

Release files / timezone_converter-0.16.1-py3-none-any.whl

Download URL timezone_converter-0.16.1-py3-none-any.whl
Size 9.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c27a77bc8001ba15cbb3c60169c95b447f4f49449549d44eb74c22461c476e27
BLAKE2b-256 checksum
How to use checksums
b01198637c3284a8563633d302ba841c1cf55b287613a93dd7266d50a8ea1a74
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 1, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.16.1 This release

2 release files

0.15.0

2 release files

0.14.0

2 release files

0.13.0

2 release files

0.12.1

2 release files

0.12.0

2 release files

0.11.0

2 release files

0.10.0

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.3.4

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page