Robust date-time formatter with implicit time-zone conversion, wraps datetime and pytz
Project description
date-time-handler
Robust date-time formatter with implicit time-zone conversion, wraps datetime and pytz
Out of the box solution for quick and easy proto-type building
- Uses Python3 standard library time and datetime
- Requires pytz and dateutil to be installed:
$ pip3 install pytz
$ pip3 install python-dateutil
- date_time_handler package contains class DateTimeHandler with methods that convert timestamp format and time-zone
- By default, DateTimeHandler performs timezone-naive timestamp format conversion (handy for quick display formatting)
- For implicit timezone conversion:
- set destination tz with kwarg
time_zone = 'region/local'
at instantiation - then kwarg
start_tz = 'region/local'
when converting timestamp format
- set destination tz with kwarg
- All methods take 'timestamp' in any format: int/float, tuple/struct, formatted_string, and even datetime obj
examples
for time-zone agnostic format conversion
>>> dt_format = DateTimeHandler(date_format = "%Y/%m/%d", clock_format = "%H:%M:%S")
>>> timestring = dt_format.timestring(timestamp)
>>> timetuple = dt_format.timetuple(timestamp)
>>> datestamp = dt_format.datestamp(timestamp)
for time-zone conversion, set destination tz at instantiation
>>> dt_format = DateTimeHandler(time_zone = 'US/Pacific')
# specify starting timezone when converting timestamp #
>>> local_timestring = dt_format.timestring(utc_timestamp, start_tz = 'UTC')
>>> local_timetuple = dt_format.timetuple(utc_timestamp, start_tz = 'UTC')
so-called 'date' methods return the given timestamp's date @ 00:00:00
>>> local_datestring = dt_format.datestring(utc_timestamp, start_tz = 'UTC')
>>> local_datetuple = dt_format.datetuple(utc_timestamp, start_tz = 'UTC')
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for date_time_handler-0.0.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3382808ebd2ee6059d46656cc20d72c2172ec9850075ada6e3e2be7d271ef9a0 |
|
MD5 | 651a8f741bb9c865531d914a089ee018 |
|
BLAKE2b-256 | 31b2fc608ab96774d3831443be6c60ffce1222d2fa973b5da96c76e57a268191 |
Close
Hashes for date_time_handler-0.0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3122e0b928fd600d0a95e0746aa60376de88c1d5b2eb36b524f96247b3bedc64 |
|
MD5 | 854c0d4eceaefc2939d43ff7d0e84e4e |
|
BLAKE2b-256 | fee6937c558a2a69ce35dabce6b8f60a3de1bf082dc62c9db589fb7890856e5f |