Metadata-Version: 2.1
Name: CityTime
Version: 1.0.0
Summary: A tool for comparing time between different locations/timezones
Home-page: https://github.com/tweyter/CityTime
Author: Thorsten Weyter
Author-email: tweyter@gmail.com
Maintainer: Thorsten Weyter
Maintainer-email: tweyter@gmail.com
License: MIT
Keywords: time datetime olson timezone
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Utilities
Requires-Dist: pytz

CityTime
########

.. image:: https://img.shields.io/codecov/c/github/tweyter/CityTime.svg
    :target: https://codecov.io/gh/tweyter/CityTime

.. image:: https://travis-ci.org/tweyter/CityTime.svg
    :alt: CityTime Build status
    :target: https://travis-ci.org/tweyter/CityTime

Thanks:
/u/phira

The CityTime object is my solution for the headache of time zones and daylight savings time.  It takes
the local time and the local time zone, and translates the time into UTC.  The time can then be reproduced
in various formats and also incremented forward and back while still adjusting for daylight savings time.

CityTime is a tool for comparing the time in two different cities. For example, let's say it is 5pm in New York
and 4pm in Chicago. CityTime will take both of those times and time zones, convert them to UTC, and by comparing
the two CityTime objects, will tell you if they are the same time or not (in this case, they are).

Let's say it's 8pm in Tokyo on November 1 (UTC + 9), and 7am in New York on the same date (UTC - 4). If you
create a CityTime object for each city, and compare the two, it will show that they are the same. However,
if you tried the same thing on November 3 (after Daylight Savings Time ends), they will be different,
because Japan does not follow Daylight Savings Time.

CityTime handles cases like those mentioned above by converting the input local time to UTC, while storing
the Olson Database time zone, rather than just using a UTC offset. This way, local differences in the start
and end of Daylight Savings Time are accounted for.

A CityTime object can be instantiated using a datetime.datetime object, an ISO8601 string, or another
CityTime object. If instantiated using an ISO8601 string, the time used must be UTC, it will not work
with a localized time.

