Home » Documentation » Filters » randomize replace_args pprint match to_json filesizeformat if menu_trail reversed without_embedded_media show_media is_visible is_a replace random chunk twitter rand escape_ical force_escape utc is_undefined add_year add_month add_week sub_year sub_week sub_month sub_day add_day element in_past in_future truncate vsplit_in timesince yesno urlencode upper tail rjust nthtail member make_list lower ljust group_by linebreaksbr length_is length last join slugify stringify striptags split_in is_defined default_if_undefined default_if_none default format_price format_number format_integer escape unescape fix_ampersands first escapexml escapejs date date_range center capfirst ne_day eq_day insert append

date

Format a date and time.

Formats a date or datetime according to the format specified in the argument.

The date should be a tuple {Y,M,D} and the datetime should be a tuple {{Y,M,D},{H,I,S}}.  Dates and datetimes are always assumed to be in local time.

An example:

{{ mydate|date:"Y-m-d" }}

When mydate is {2009,6,1} this gives “2009-06-01” as output.

See also the timesince filter to display a human readable relative time like "10 hours ago".

Date uses the same format as PHP's date function with some extensions and some omissions.

All supported formatting characters are listed below:

Character	Description	Example output
a	“a.m.” or “p.m.” (note that this follows Associated Press style and adds periods)	“a.m.”
A	Uppercase “AM” or “PM”	“AM”
b	Month, textual, in three lowercase characters.	“jan”
c	ISO-8601 date format	“2004-02-12T15:19:21+00:00”
d	Day of the month in two digits with leading zeros, i.e. “01” to “31”	“01”
D	Day of the week, textual, three letters of which the first one uppercase.	“Mon”, “Fri”
f	If minutes is zero then show only the hour, otherwise the hour and the minutes. Hours are shown using the “g” format character.	“2”, “3:01”
F	Month, textual, full english name with first character in uppercase.	“January”
g	12 Hour format without leading zero, i.e. “1” to “12”.	“1”
G	24 Hour format without leading zero, i.e. “0” to “23”	“0”, “15”
h	12 Hour format with leading zero, i.e. “01” to “12”	“01”
H	24 Hour format with leading zero, i.e. “00” to “23”	“00”, “15”
i	Minutes with leading zero, i.e. “00” to “59”	“00”, “46”
j	Day of the month without leading zeros, i.e. “1” to “31”	“1”, “28”
l	(lowercase L) Day of the week, textual, full english name with first character in uppercase.	“Monday”, “Friday”
L	Boolean for whether the year is a leap year.  Returns the string “True” or “False”.	"True", "False"
m	Month with leading zeros, i.e. “01” to “12”	“01”, “12”
M	Month, textual, in three characters, first character in uppercase.	“Jan”
n	Month without leading zeros, i.e. “1” to “12”	“1”, “12”
N	Month abbreviation in Associated Press style. March, April, June and July are shown in full. September as “Sept.” and all other months as three letter abbreviations with a full stop appended.	“Jan.”, “June”, “Sept.”, “Dec.”
O	Difference to Greenwich Mean Time (GMT).	“+0200”
P	Time in 12 hour format with minutes and “a.m.” or “p.m.” appended. Minutes are left off if they are zero, and the strings “midnight” or “noon” if appropriate.	“1 a.m.”, “noon”, “1:30 a.m.”, “12:30 p.m.”
r	RFC 2822 formatted date.	“Thu, 21 Dec 2000 16:01:07 +0200”
S	English ordinal suffix for the day of the month, 2 characters; i.e. “st”, “nd”, “rd” or “th”	“st”, “nd”
t	Number of days in the given month, i.e. “28” to “31”	“30”
U	Seconds since the Unix epoch of January 1, 00:00:00 GMT.	1254911050
w	Day of the week, numeric.  0 For sunday to 6 for saturday.	“0”, “6”
W	ISO-8601 week number of the year, starting on mondays.	“22”
y	Year in two digits.	“01”, “99”
Y	Year in four digits.	“1999”, “2010”
z	Day of the year, i.e. 1 to 366.	“361”