51b63aa576
called human which works on datetime objects instead of timedelta objects. Updated README to document new function usage.
72 lines
1.3 KiB
Text
72 lines
1.3 KiB
Text
How to install
|
|
===================
|
|
|
|
easy_install ago
|
|
|
|
|
|
How to use
|
|
==================
|
|
|
|
The ago module comes with three functions:
|
|
|
|
#. human
|
|
#. delta2human
|
|
#. delta2dict
|
|
|
|
You really only need to worry about *human*::
|
|
|
|
from ago import human, delta2human, delta2dict
|
|
|
|
from datetime import datetime
|
|
|
|
# pretend this was stored in database
|
|
d1 = datetime(
|
|
year = 2010,
|
|
month=5,
|
|
day=4,
|
|
hour=6,
|
|
minute=54,
|
|
second=33,
|
|
microsecond=4000
|
|
)
|
|
|
|
# to find out how long ago, use the human function
|
|
print 'Created ' + human( d1 ) + ' ago.'
|
|
|
|
# optionally pass a precision
|
|
print 'Created ' + human( d1, 3 ) + ' ago.'
|
|
print 'Created ' + human( d1, 6 ) + ' ago.'
|
|
|
|
Now we will document how to use delta2human and delta2dict::
|
|
|
|
# pretend we already have a timedelta object
|
|
|
|
# subtract two datetime objects for a timedelta object
|
|
d2 = datetime.now()
|
|
delta = d2 - d1
|
|
|
|
# display a human readable timedelta from a timedelta
|
|
print 'Created ' + delta2human( delta ) + ' ago.'
|
|
|
|
# create a dictionary out of the timedelta
|
|
delta_dict = delta2dict( delta )
|
|
print delta_dict
|
|
|
|
|
|
How do I thank you?
|
|
==========================
|
|
|
|
You should follow me on twitter http://twitter.com/russellbal
|
|
|
|
|
|
License
|
|
=========================
|
|
|
|
Public Domain
|
|
|
|
|
|
|
|
Public Revision Control
|
|
==============================
|
|
|
|
https://bitbucket.org/russellballestrini/ago
|