1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
# timeago
A very simple python lib, used to format datetime with `*** time ago` statement. Javascript version here. [timeago.js](https://github.com/hustcc/timeago.js).
[](https://travis-ci.org/hustcc/timeago) [](https://pypi.python.org/pypi/timeago) [](https://pypi.python.org/pypi/timeago)
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
```sh
pip install timeago
```
## Usage & Example
```py
# -*- 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 formatted 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 formatted, must be instance of `datetime` / `timedelta` or datetime formatted string.
- **`now`**: reference time, must be instance of `datetime` or datetime formatted string.
- **`locale`**: the locale code, default `en`.
## Locale
At the time we're speaking, [following locale](src/timeago/locales) are available:
- `ar`
- `bg`
- `ca`
- `da`
- `de`
- `el`
- `en`
- `en_short`
- `es`
- `eu`
- `fa_IR`
- `fi`
- `fr`
- `gl`
- `guj_IN`
- `he`
- `hu`
- `in_BG`
- `in_HI`
- `in_ID`
- `is`
- `it`
- `ja`
- `ko`
- `lt`
- `ml`
- `my`
- `nb_NO`
- `nl`
- `nn_NO`
- `pl`
- `pt_BR`
- `pt_PT`
- `ro`
- `ru`
- `sk`
- `sv_SE`
- `ta`
- `th`
- `tr`
- `uk`
- `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 (both in MD and in RST) to keep it updated (**alphabetically**).
4. Add test case following the [english model](/test/testcase.py#L50)
5. Create the Pull Request.
### Notes
For complicated plurals, you can take example on the PL :flag-pl: locale [here](src/timeago/locales/pl.py)
|
