kennethreitz/maya
1
0
Fork 0
mirror of https://github.com/kennethreitz/maya.git synced 2026-06-05 23:00:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update README.rst

Browse Source
This commit is contained in:
Kenneth Reitz
2016-12-18 02:07:46 -05:00
committed by GitHub
parent 764cc49c53
commit e265f12206
1 changed files with 9 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.rst
+9 -4
View File
@@ -2,7 +2,11 @@ Maya: Datetime for Humans™
==========================
Datetimes are very frustrating to work with in Python, especially when dealing
with different locales on different systems. This library exists to make the simple things easier, while admitting that time is an illusion (timezones doubly so), and should be interacted with via an API for humans (not machines).
with different locales on different systems. This library exists to make the
simple things **much** easier, while admitting that time is an illusion
(timezones doubly so).
Datetimes should be interacted with via an API written for humans.
The Usage
---------
@@ -50,11 +54,12 @@ Just playing with an API here:
Timezones fit more in here somewhere...
Notes
-----
- All timezone algebra will behave identically on all machines, regardless of system locale.
- Complete symmetric import and export of both ISO 8601 and RFC 2822 datetime stamps.
- Fantastic parsing of both dates written for/by humans and machines (``maya.when()`` vs ``maya.parse()``).
- Support for human slang, both import and export (e.g. `an hour ago`).
- This library is based around epoch time, but dates before Jan 1 1970 are indeed supported, via negative integers.
- Don't panic, and always carry a towel.