WhenWasThat

Python module for returning a human readable value for the time between two specified datetime objects. Inspired by whenWasThat() function from BMC Discovery.

Properties

Property	Details
microseconds	Output the total number of microseconds between two datetime objects
seconds	Output the total number of seconds between two datetime objects
minutes	Output the total number of minutes between two datetime objects
hours	Output the total number of hours between two datetime objects
days	Output the total number of days between two datetime objects
weeks	Output the total number of weeks between two datetime objects
months	Output the total number of months between two datetime objects
years	Output the total number of years between two datetime objects
natural	Output an approximate number of seconds, minutes, hours, days, weeks, months or years between two datetime objects

Usage Examples

Retrieve number of days between two dates

>>>importdatetimeasdt>>>fromWhenWasThatimportwhen>>>first_date=dt.datetime(2006, 10, 27, 11, 59, 32, 343001)
>>>last_date=dt.datetime(2016, 9, 30, 20, 21, 43, 561783)
>>>when(first_date,last_date).days3626.348740958125

Output a natural approximation of the time between two dates

>>>first_date=dt.datetime(2006, 10, 27, 11, 59, 32, 343001)
>>>last_date=dt.datetime(2016, 9, 30, 20, 21, 43, 561783)
>>>when(first_date,last_date).naturalApproximately9.9yearsago

Last date is not required (module will calculate from datetime.now())

>>>time_then=dt.datetime(2020, 3, 23, 0, 1, 1, 1)
>>>when(time_then).weeks75.20358385298611>>>when(time_then).naturalApproximately17.5monthsago

How many days since the Titanic sunk?

>>>dt.datetime.now()
datetime.datetime(2021, 8, 31, 10, 20, 59, 979468)
>>>titanic=dt.datetime(1912, 4, 15, 2, 20, 0, 0)
>>>print("The Titanic sunk %s days ago."%round(when(titanic).days))
TheTitanicsunk39950daysago.

Releases

Version	Summary	Known Issues	Fixed
Alpha-0.0.1	Alpha release.
0.1.0	Released to PyPi
0.1.1	Released to PyPI with pytest-based test suite and bug fixes

 | |