Skip to main content

View datetime in different time zones.

Project description


PyPI Build Status License: MIT

View datetime in different time zones.

Given a time zone and datetime, tzview can find the datetime at other time zones.

The time zone names are those as specified in the Olsen time zone database (tz).

tzview merely leverages pytz package to get the job done.


You need Python>=3.6 to use tzview.

It can be installed from PyPI with pip using

pip install tzview



The string 'local' can be used to specify the local time zone. This is the source time zone by default.

The string 'now' can be used to specify the local datetime. This is the source datetime by default.

Command line usage

To get the current time at Tokyo relative to your computer's current time and time zone, use

python3 -m tzview Asia/Tokyo

to get something like

2020-05-24 09:16:05.281238+09:00 : Asia/Tokyo

You could provide source datetime using --dt option and source time zone with --from-tz option. Like

python3 -m tzview --dt "2020-03-23 11:32:34" --from-tz Asia/Tokyo Europe/Oslo Asia/Istanbul

to get an output like

2020-03-23 03:32:34+01:00 : Europe/Oslo
2020-03-23 05:32:34+03:00 : Asia/Istanbul

Use python3 -m tzview --help for more.

Usage as module

The tzview() function can be used. It accepts the extension name as string.

Return value would be a list of timezone aware datetimes.

For example,

>>> from tzview import tzview
>>> t(['Europe/Oslo'])
[datetime.datetime(2020, 5, 24, 12, 6, 14, 272335, tzinfo=<DstTzInfo 'Europe/Oslo' CEST+2:00:00 DST>)]

>>> t(['Europe/Athens', 'Asia/Singapore'])
[datetime.datetime(2020, 5, 24, 13, 11, 7, 32042, tzinfo=<DstTzInfo 'Europe/Athens' EEST+3:00:00 DST>), datetime.datetime(2020, 5, 24, 18, 11, 7, 32042, tzinfo=<DstTzInfo 'Asia/Singapore' +08+8:00:00 STD>)]


It is useful to figure meeting times when you got to attend meeting at a different time zone.

Or when calling a friend at another timezone to figure out the time of the day there.

That's what I use it for. :-)

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 tzview, version 0.3
Filename, size File type Python version Upload date Hashes
Filename, size tzview-0.3-py3-none-any.whl (5.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size tzview-0.3.tar.gz (4.2 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