Skip to content
If Django Humanize were a little more human.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
danatime
tests
.gitignore
.travis.yml
LICENSE
MANIFEST.in
README.md
runtests.py
setup.cfg
setup.py
tox.ini

README.md

Django Dana Time Build Status

Short, readable datetime filters.

Install

$ pip install django-dana-time

Usage

{% load danatime %}

{{ datetime_instance|danatime:"previous year format" }}

Formatting

Examples are shown with en translation/formatting and no arguments to the template tag.

timedelta danatime
0 seconds now
1 second a second ago
2 - 60 seconds 2 - 60 seconds ago
1 minute a minute ago
2 - 60 minutes 2 - 60 minutes ago
1 hour an hour ago
2 - 6 hours 2 - 6 hours ago
6 - 24 hours, same day 4:26 p.m.
6 - 24 hours, yesterday 4:26 p.m. yesterday
> 24 hours, same year Aug 10
previous year 8/10/2012

Internationalization Notes

All values are internationalized and localized by default using Django's internationalization and localization support.

6 - 24 hours (same day/yesterday)

Uses defaultfilters.time, which defaults to the localized settings.TIME_FORMAT.

Example: In en, TIME_FORMAT = 'P'.

> 24 hours, same year

Uses defaultfilters.date with an argument of 'MONTH_DAY_FORMAT', the localized settings.MONTH_DAY_FORMAT.

Example: In en, MONTH_DAY_FORMAT = 'F j'.

previous year

Uses defaultfilters.date with an argument of 'n/j/Y'.

Example: 10 August 2012 is formatted as 8/10/2012.

Override this by passing an optional argument with a format to the filter tag.

previous year format examples:

Pass None to use the default, localized settings.DATE_FORMAT:

{{ mytime|danatime:None }}

Pass SHORT_DATE_FORMAT to use the localized settings.SHORT_DATE_FORMAT:

{{ mytime|danatime:"SHORT_DATE_FORMAT" }}

Pass a format string like "F j, Y" to use a custom format:

{{ mytime|danatime:"F j, Y" }}

This particular format yields August 8, 2012.

See Django's available format strings for help.

Testing

Build Status

Tested with all combinations of the latest versions of Python 2.7 and 3.4 with Django 1.7, 1.8, and 1.9.

After installing Django, run the tests with:

$ python runtests.py

Install tox and run tox to test in all environments. This is what the CI does.

You can’t perform that action at this time.