digyter / timeago

:hourglass: A very simple python library, used to format datetime with `*** time ago` statement. eg: "3 hours ago".

timeago

A very simple python lib, used to format datetime with *** time ago statement. Javascript version here. timeago.js.

Such as:

just now
12 seconds ago
3 minutes ago
2 hours ago
24 days ago
6 months ago
2 years ago

in 12 seconds
in 3 minutes
in 2 hours
in 24 days
in 6 months
in 2 years

or Chinese locale statement.

Install

pip install timeago

Usage & Example

# -*- coding: utf-8 -*-
import timeago, datetime

now = datetime.datetime.now() + datetime.timedelta(seconds = 60 * 3.4)

date = datetime.datetime.now()

# locale
print (timeago.format(date, now, 'zh_CN')) # will print `3分钟前`

# input datetime
print (timeago.format(date, now)) # will print 3 minutes ago

# input timedelta
print (timeago.format(datetime.timedelta(seconds = 60 * 3.4))) # will print 3 minutes ago

# input date, auto add time(0, 0, 0)
print (timeago.format(datetime.date(2016, 5, 27), now))

# input datetime formated string
print (timeago.format('2016-05-27 12:12:03', '2016-05-27 12:12:12')) # will print just now

# inverse two parameters
print (timeago.format('2016-05-27 12:12:12', '2016-05-27 12:12:03')) # will print a while

Method & Parameter

only one API format.

Three parameters of method format:

• date: the parameter which will be formated, must be instance of datetime / timedelta or datetime formated string.
• now: reference time, must be instance of datetime or datetime formated string.
• locale: the locale code, only zh_CN / en supported, default en. Other locale, you can pull request.

Localization

1. foke the project
2. add locale.py file in the locales folder.
3. pull a request.