From c5f67d070d7124f18bc2f0e4b729ce46e34244f2 Mon Sep 17 00:00:00 2001 From: Bas Stottelaar Date: Tue, 27 Jan 2015 22:02:21 +0100 Subject: [PATCH] Upgraded tzlocal to 1.1.2 --- lib/tzlocal/README.rst | 80 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 lib/tzlocal/README.rst diff --git a/lib/tzlocal/README.rst b/lib/tzlocal/README.rst new file mode 100644 index 00000000..09e9bfe8 --- /dev/null +++ b/lib/tzlocal/README.rst @@ -0,0 +1,80 @@ +tzlocal +======= + +This Python module returns a `tzinfo` object with the local timezone information under Unix and Win-32. +It requires `pytz`, and returns `pytz` `tzinfo` objects. + +This module attempts to fix a glaring hole in `pytz`, that there is no way to +get the local timezone information, unless you know the zoneinfo name, and +under several Linux distros that's hard or impossible to figure out. + +Also, with Windows different timezone system using pytz isn't of much use +unless you separately configure the zoneinfo timezone name. + +With `tzlocal` you only need to call `get_localzone()` and you will get a +`tzinfo` object with the local time zone info. On some Unices you will still +not get to know what the timezone name is, but you don't need that when you +have the tzinfo file. However, if the timezone name is readily available it +will be used. + + +Supported systems +----------------- + +These are the systems that are in theory supported: + + * Windows 2000 and later + + * Any unix-like system with a /etc/localtime or /usr/local/etc/localtime + +If you have one of the above systems and it does not work, it's a bug. +Please report it. + + +Usage +----- + +Load the local timezone: + + >>> from tzlocal import get_localzone + >>> tz = get_localzone() + >>> tz + + +Create a local datetime: + + >>> from datetime import datetime + >>> dt = tz.localize(datetime.now()) + >>> dt + datetime.datetime(2012, 9, 11, 14, 43, 42, 518871, tzinfo=) + +Lookup another timezone with `pytz`: + + >>> import pytz + >>> eastern = pytz.timezone('US/Eastern') + +Convert the datetime: + + >>> dt.astimezone(eastern) + datetime.datetime(2012, 9, 11, 8, 43, 42, 518871, tzinfo=) + + +Maintainer +---------- + +* Lennart Regebro, regebro@gmail.com + +Contributors +------------ + +* Marc Van Olmen +* Benjamen Meyer +* Manuel Ebert +* Xiaokun Zhu + +(Sorry if I forgot someone) + +License +------- + +* CC0 1.0 Universal http://creativecommons.org/publicdomain/zero/1.0/