Description
A small Python 3 library containing some handy tools for handling time, especially when it comes to interfacing with those pesky humans.
Chronyk alternatives and similar packages
Based on the "Date and Time" category.
Alternatively, view Chronyk alternatives based on common mentions on social networks and blogs.
-
when.py
Providing user-friendly functions to help perform common date and time actions. -
PyTime
PyTime is an easy-use Python module which aims to operate date/time/datetime by string.
Updating dependencies is time-consuming.
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of Chronyk or a related project?
Popular Comparisons
README
Chronyk
A small Python 3 library containing some handy tools for handling time, especially when it comes to interfacing with those pesky humans.
Features
- Parsing human-written strings ("10 minutes ago", "10. April 2015", "2014-02-15"...)
- Relative time string creation ("in 2 hours", "5 hours ago")
- Various input formats
- Easy to use
Installation
$ pip install chronyk
Usage
Basic:
>>> from chronyk import Chronyk
>>> t = Chronyk(1410531179.0)
>>> t = Chronyk("May 2nd, 2016 12:51 am")
>>> t = Chronyk("yesterday")
>>> t = Chronyk("21. 8. 1976 23:18")
>>> t = Chronyk("2 days and 30 hours ago")
>>> t.ctime()
'Tue Sep 9 05:59:39 2014'
>>> t.timestamp()
1410235179.0
>>> t.timestring()
'2014-09-09 05:59:39'
>>> t.timestring("%Y-%m-%d")
'2014-09-09'
>>> t.relativestring()
'3 days ago'
>>> t.date()
datetime.date(2014, 9, 9)
>>> t.datetime()
datetime.datetime(2014, 9, 9, 5, 59, 39)
Input validation:
import sys
import chronyk
timestr = input("Please enter the date you were born: ")
try:
date = chronyk.Chronyk(timestr, allowfuture=False)
except chronyk.DateRangeError:
print("Yeah, right.")
sys.exit(1)
except ValueError:
print("Failed to parse birthdate.")
sys.exit(1)
else:
print("You were born {}".format(date.relativestring()))
Timezones:
By default, the Chronyk constructor uses local time, and every method by default uses whatever was passed to the constructor as well.
Almost all methods, however, have a timezone keyargument that you can use to define your local offset from UTC in seconds (positive for west, negative for east).
If you want to use a certain timezone for more than one method, you can also change the timezone
instance attribute itself:
>>> t = Chronyk("4 hours ago", timezone=0) # using UTC
>>> t.ctime()
'Tue Sep 9 10:53:42 2014'
>>> t.timezone = -3600 # changes to CET (UTC+1)
>>> t.relativeTime()
'5 hours ago'
>>> t.ctime()
'Tue Sep 9 09:53:42 2014'
This uses the local relative time and returns a time string relative to current UTC:
>>> t = Chronyk("4 hours ago")
>>> t.relativestring(timezone=0)
'3 hours ago'
This uses a UTC timestamp and returns a time string relative to local time:
>>> t = Chronyk(1410524713.69, timezone=0)
>>> t.relativestring(timezone=chronyk.LOCALTZ)
'2 hours ago'
*Note that all licence references and agreements mentioned in the Chronyk README section above
are relevant to that project's source code only.