Metadata-Version: 2.1
Name: cs.dateutils
Version: 20230210
Summary: A few conveniences to do with dates and times.
Home-page: https://bitbucket.org/cameron_simpson/css/commits/all
Author: Cameron Simpson
Author-email: Cameron Simpson <cs@cskk.id.au>
License: GNU General Public License v3 or later (GPLv3+)
Project-URL: URL, https://bitbucket.org/cameron_simpson/css/commits/all
Keywords: date,time,datetime,python,python3
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Description-Content-Type: text/markdown

A few conveniences to do with dates and times.

*Latest release 20230210*:
* Drop Python 2 support.
* Make timezones mandatory where previously they were assumed.

There are some other PyPI modules providing richer date handling
than the stdlib `datetime` module.
This module mostly contains conveniences used in my other code;
you're welcome to it, but it does not pretend to be large or complete.

## Function `datetime2unixtime(dt)`

Convert a timezone aware `datetime` to a UNIX timestamp.

## Function `isodate(when=None, dashed=True)`

Return a date in ISO8601 YYYY-MM-DD format, or YYYYMMDD if not `dashed`.

Modern Pythons have a `datetime.isoformat` method, you use that.

## Function `localdate2unixtime(d)`

Convert a localtime `date` into a UNIX timestamp.

## Class `tzinfoHHMM(datetime.tzinfo)`

tzinfo class based on +HHMM / -HHMM strings.

## Function `unixtime2datetime(unixtime, *, tz: datetime.tzinfo)`

Convert a a UNIX timestamp to a `datetime` in the timezone `tz`.

## Class `UNIXTimeMixin`

A mixin for classes with a `.unixtime` attribute,
a `float` storing a UNIX timestamp.

# Release Log



*Release 20230210*:
* Drop Python 2 support.
* Make timezones mandatory where previously they were assumed.

*Release 20210306*:
Initial release, used by cs.sqltags.
