django.contrib.humanize¶A set of Django template filters useful for adding a “human touch” to data.
To activate these filters, add 'django.contrib.humanize' to your
INSTALLED_APPS setting. Once you’ve done that, use
{% load humanize %} in a template, and you’ll have access to the following
filters.
apnumber¶For numbers 1-9, returns the number spelled out. Otherwise, returns the number. This follows Associated Press style.
Examples:
1 becomes one.
2 becomes two.
10 becomes 10.
You can pass in either an integer or a string representation of an integer.
intcomma¶Converts an integer or float (or a string representation of either) to a string containing commas every three digits.
Examples:
4500 becomes 4,500.
4500.2 becomes 4,500.2.
45000 becomes 45,000.
450000 becomes 450,000.
4500000 becomes 4,500,000.
Format localization will be respected if enabled,
e.g. with the 'de' language:
45000 becomes '45.000'.
450000 becomes '450.000'.
intword¶Converts a large integer (or a string representation of an integer) to a
friendly text representation. Translates 1.0 as a singular phrase and all
other numeric values as plural, this may be incorrect for some languages. Works
best for numbers over 1 million.
Examples:
1000000 becomes 1.0 million.
1200000 becomes 1.2 million.
1200000000 becomes 1.2 billion.
-1200000000 becomes -1.2 billion.
Values up to 10^100 (Googol) are supported.
Format localization will be respected if enabled,
e.g. with the 'de' language:
1000000 becomes '1,0 Million'.
1200000 becomes '1,2 Millionen'.
1200000000 becomes '1,2 Milliarden'.
-1200000000 becomes '-1,2 Milliarden'.
naturalday¶For dates that are the current day or within one day, return “today”, “tomorrow” or “yesterday”, as appropriate. Otherwise, format the date using the passed in format string.
Argument: Date formatting string as described in the date tag.
Examples (when ‘today’ is 17 Feb 2007):
16 Feb 2007 becomes yesterday.
17 Feb 2007 becomes today.
18 Feb 2007 becomes tomorrow.
Any other day is formatted according to given argument or the
DATE_FORMAT setting if no argument is given.
naturaltime¶For datetime values, returns a string representing how many seconds,
minutes or hours ago it was – falling back to the timesince
format if the value is more than a day old. In case the datetime value is in
the future the return value will automatically use an appropriate phrase.
Examples (when ‘now’ is 17 Feb 2007 16:30:00):
17 Feb 2007 16:30:00 becomes now.
17 Feb 2007 16:29:31 becomes 29 seconds ago.
17 Feb 2007 16:29:00 becomes a minute ago.
17 Feb 2007 16:25:35 becomes 4 minutes ago.
17 Feb 2007 15:30:29 becomes 59 minutes ago.
17 Feb 2007 15:30:01 becomes 59 minutes ago.
17 Feb 2007 15:30:00 becomes an hour ago.
17 Feb 2007 13:31:29 becomes 2 hours ago.
16 Feb 2007 13:31:29 becomes 1 day, 2 hours ago.
16 Feb 2007 13:30:01 becomes 1 day, 2 hours ago.
16 Feb 2007 13:30:00 becomes 1 day, 3 hours ago.
17 Feb 2007 16:30:30 becomes 30 seconds from now.
17 Feb 2007 16:30:29 becomes 29 seconds from now.
17 Feb 2007 16:31:00 becomes a minute from now.
17 Feb 2007 16:34:35 becomes 4 minutes from now.
17 Feb 2007 17:30:29 becomes an hour from now.
17 Feb 2007 18:31:29 becomes 2 hours from now.
18 Feb 2007 16:31:29 becomes 1 day from now.
26 Feb 2007 18:31:29 becomes 1 week, 2 days from now.
ordinal¶Converts an integer to its ordinal as a string.
Examples:
1 becomes 1st.
2 becomes 2nd.
3 becomes 3rd.
You can pass in either an integer or a string representation of an integer.
Dec 25, 2023