Skip to main content

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

Project description

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

Build Status PyPi Status Python Versions

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

For other languages see below.

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, default en.

Locale

At the time we’re speaking, following locale are available:

  • bg

  • ca

  • da

  • de

  • el

  • en

  • en_short

  • es

  • eu

  • fa_IR

  • fi

  • fr

  • gl

  • he

  • hu

  • in_BG

  • in_HI

  • in_ID

  • it

  • ja

  • ko

  • ml

  • my

  • nb_NO

  • nl

  • nn_NO

  • pl

  • pt_BR

  • ru

  • sv_SE

  • ta

  • th

  • tr

  • vi

  • zh_CN

  • zh_TW

Localization

  1. Fork the project

  2. Create a locale python script called [name_of_your_locale].py following the existing other locales.

  3. Add the name of your locale in the Readme to keep it updated (alphabetically).

  4. Add test case following the english model

  5. Create the Pull Request.

Notes

For complicated plurals, you can take example on the PL (Polish) locale here

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

timeago-1.0.9.tar.gz (22.2 kB view hashes)

Uploaded Source

Built Distribution

timeago-1.0.9-py3-none-any.whl (24.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page