Formatting Dates in Twig
The date
filter in Twig allows you to format dates in any number of formats. The general format is:
{{ date_time_variable | date("FORMAT_STRING", "OPTIONAL_TIMEZONE") }}
An example of reformatting an Order "created at" time:
{{ order.created_at | date("m/d/Y g:i:sA") }}
If you need to change the default timezone that is being displayed you can pass the timezone argument to the date
filter.
{{ order.created_at | date("m/d/Y g:i:sA", "America/New_York") }}
You can view a list of valid timezones at the bottom of this article.
The date filter accepts a date formatter string. The various format characters you can use are detailed below:
Character | Description | Examples |
---|---|---|
Day Formats |
|
|
d |
Day of the month, 2 digits with leading zeros | 01 to 31 |
D |
A textual representation of a day, three letters | Mon through Sun |
j |
Day of the month without leading zeros | 1 to 31 |
l (lowercase 'L') |
A full textual representation of the day of the week | Sunday through Saturday |
N |
ISO-8601 numeric representation of the day of the week | 1 (for Monday) through 7 (for Sunday) |
S |
English ordinal suffix for the day of the month, 2 characters | st , nd , rd or th . Works well with j |
w |
Numeric representation of the day of the week | 0 (for Sunday) through 6 (for Saturday) |
z |
The day of the year (starting from 0) | 0 through 365 |
Week Formats |
|
|
W |
ISO-8601 week number of year, weeks starting on Monday | Example: 42 (the 42nd week in the year) |
Month Formats | |
|
F |
A full textual representation of a month, such as January or March | January through December |
m |
Numeric representation of a month, with leading zeros | 01 through 12 |
M |
A short textual representation of a month, three letters | Jan through Dec |
n |
Numeric representation of a month, without leading zeros | 1 through 12 |
t |
Number of days in the given month | 28 through 31 |
Year Formats |
|
|
L |
Whether it's a leap year | 1 if it is a leap year, 0 otherwise. |
o |
ISO-8601 week-numbering year. This has the same value as Y , except that if the ISO week number ( W ) belongs to the previous or next year, that year is used instead. |
Examples: 1999 or 2003 |
Y |
A full numeric representation of a year, 4 digits | Examples: 1999 or 2003 |
y |
A two digit representation of a year | Examples: 99 or 03 |
Time Formats |
|
|
a |
Lowercase Ante meridiem and Post meridiem | am or pm |
A |
Uppercase Ante meridiem and Post meridiem | AM or PM |
B |
Swatch Internet time | 000 through 999 |
g |
12-hour format of an hour without leading zeros | 1 through 12 |
G |
24-hour format of an hour without leading zeros | 0 through 23 |
h |
12-hour format of an hour with leading zeros | 01 through 12 |
H |
24-hour format of an hour with leading zeros | 00 through 23 |
i |
Minutes with leading zeros | 00 to 59 |
s |
Seconds with leading zeros | 00 through 59 |
Timezone Format |
|
|
e |
Timezone | Examples: UTC , GMT , Atlantic/Azores |
I (capital i) |
Whether or not the date is in daylight saving time | 1 if Daylight Saving Time, 0 otherwise. |
O |
Difference to Greenwich time (GMT) without colon between hours and minutes | Example: +0200 |
P |
Difference to Greenwich time (GMT) with colon between hours and minutes | Example: +02:00 |
T |
Timezone abbreviation | Examples: EST , MDT ... |
Z |
Timezone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive. | -43200 through 50400 |
Automatic Formats |
|
|
c |
ISO 8601 date | 2004-02-12T15:19:21+00:00 |
r |
» RFC 2822 formatted date | Example: Thu, 21 Dec 2000 16:01:07 +0200 |
U |
Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT) | Example: 1592504096 |
Valid Timezones
America
America/Adak | America/Anchorage | America/Anguilla |
America/Antigua | America/Araguaina | America/Argentina/Buenos_Aires |
America/Argentina/Catamarca | America/Argentina/ComodRivadavia | America/Argentina/Cordoba |
America/Argentina/Jujuy | America/Argentina/La_Rioja | America/Argentina/Mendoza |
America/Argentina/Rio_Gallegos | America/Argentina/Salta | America/Argentina/San_Juan |
America/Argentina/San_Luis | America/Argentina/Tucuman | America/Argentina/Ushuaia |
America/Aruba | America/Asuncion | America/Atikokan |
America/Atka | America/Bahia | America/Bahia_Banderas |
America/Barbados | America/Belem | America/Belize |
America/Blanc-Sablon | America/Boa_Vista | America/Bogota |
America/Boise | America/Buenos_Aires | America/Cambridge_Bay |
America/Campo_Grande | America/Cancun | America/Caracas |
America/Catamarca | America/Cayenne | America/Cayman |
America/Chicago | America/Chihuahua | America/Coral_Harbour |
America/Cordoba | America/Costa_Rica | America/Creston |
America/Cuiaba | America/Curacao | America/Danmarkshavn |
America/Dawson | America/Dawson_Creek | America/Denver |
America/Detroit | America/Dominica | America/Edmonton |
America/Eirunepe | America/El_Salvador | America/Ensenada |
America/Fort_Wayne | America/Fortaleza | America/Glace_Bay |
America/Godthab | America/Goose_Bay | America/Grand_Turk |
America/Grenada | America/Guadeloupe | America/Guatemala |
America/Guayaquil | America/Guyana | America/Halifax |
America/Havana | America/Hermosillo | America/Indiana/Indianapolis |
America/Indiana/Knox | America/Indiana/Marengo | America/Indiana/Petersburg |
America/Indiana/Tell_City | America/Indiana/Vevay | America/Indiana/Vincennes |
America/Indiana/Winamac | America/Indianapolis | America/Inuvik |
America/Iqaluit | America/Jamaica | America/Jujuy |
America/Juneau | America/Kentucky/Louisville | America/Kentucky/Monticello |
America/Knox_IN | America/Kralendijk | America/La_Paz |
America/Lima | America/Los_Angeles | America/Louisville |
America/Lower_Princes | America/Maceio | America/Managua |
America/Manaus | America/Marigot | America/Martinique |
America/Matamoros | America/Mazatlan | America/Mendoza |
America/Menominee | America/Merida | America/Metlakatla |
America/Mexico_City | America/Miquelon | America/Moncton |
America/Monterrey | America/Montevideo | America/Montreal |
America/Montserrat | America/Nassau | America/New_York |
America/Nipigon | America/Nome | America/Noronha |
America/North_Dakota/Beulah | America/North_Dakota/Center | America/North_Dakota/New_Salem |
America/Ojinaga | America/Panama | America/Pangnirtung |
America/Paramaribo | America/Phoenix | America/Port-au-Prince |
America/Port_of_Spain | America/Porto_Acre | America/Porto_Velho |
America/Puerto_Rico | America/Rainy_River | America/Rankin_Inlet |
America/Recife | America/Regina | America/Resolute |
America/Rio_Branco | America/Rosario | America/Santa_Isabel |
America/Santarem | America/Santiago | America/Santo_Domingo |
America/Sao_Paulo | America/Scoresbysund | America/Shiprock |
America/Sitka | America/St_Barthelemy | America/St_Johns |
America/St_Kitts | America/St_Lucia | America/St_Thomas |
America/St_Vincent | America/Swift_Current | America/Tegucigalpa |
America/Thule | America/Thunder_Bay | America/Tijuana |
America/Toronto | America/Tortola | America/Vancouver |
America/Virgin | America/Whitehorse | America/Winnipeg |
America/Yakutat | America/Yellowknife |
Europe
Europe/Amsterdam | Europe/Andorra | Europe/Athens | Europe/Belfast | Europe/Belgrade |
Europe/Berlin | Europe/Bratislava | Europe/Brussels | Europe/Bucharest | Europe/Budapest |
Europe/Busingen | Europe/Chisinau | Europe/Copenhagen | Europe/Dublin | Europe/Gibraltar |
Europe/Guernsey | Europe/Helsinki | Europe/Isle_of_Man | Europe/Istanbul | Europe/Jersey |
Europe/Kaliningrad | Europe/Kiev | Europe/Lisbon | Europe/Ljubljana | Europe/London |
Europe/Luxembourg | Europe/Madrid | Europe/Malta | Europe/Mariehamn | Europe/Minsk |
Europe/Monaco | Europe/Moscow | Europe/Nicosia | Europe/Oslo | Europe/Paris |
Europe/Podgorica | Europe/Prague | Europe/Riga | Europe/Rome | Europe/Samara |
Europe/San_Marino | Europe/Sarajevo | Europe/Simferopol | Europe/Skopje | Europe/Sofia |
Europe/Stockholm | Europe/Tallinn | Europe/Tirane | Europe/Tiraspol | Europe/Uzhgorod |
Europe/Vaduz | Europe/Vatican | Europe/Vienna | Europe/Vilnius | Europe/Volgograd |
Europe/Warsaw | Europe/Zagreb | Europe/Zaporozhye | Europe/Zurich |
Australia
Australia/ACT | Australia/Adelaide | Australia/Brisbane | Australia/Broken_Hill | Australia/Canberra |
Australia/Currie | Australia/Darwin | Australia/Eucla | Australia/Hobart | Australia/LHI |
Australia/Lindeman | Australia/Lord_Howe | Australia/Melbourne | Australia/North | Australia/NSW |
Australia/Perth | Australia/Queensland | Australia/South | Australia/Sydney | Australia/Tasmania |
Australia/Victoria | Australia/West | Australia/Yancowinna |
Asia
Asia/Aden | Asia/Almaty | Asia/Amman | Asia/Anadyr | Asia/Aqtau |
Asia/Aqtobe | Asia/Ashgabat | Asia/Ashkhabad | Asia/Baghdad | Asia/Bahrain |
Asia/Baku | Asia/Bangkok | Asia/Beirut | Asia/Bishkek | Asia/Brunei |
Asia/Calcutta | Asia/Choibalsan | Asia/Chongqing | Asia/Chungking | Asia/Colombo |
Asia/Dacca | Asia/Damascus | Asia/Dhaka | Asia/Dili | Asia/Dubai |
Asia/Dushanbe | Asia/Gaza | Asia/Harbin | Asia/Hebron | Asia/Ho_Chi_Minh |
Asia/Hong_Kong | Asia/Hovd | Asia/Irkutsk | Asia/Istanbul | Asia/Jakarta |
Asia/Jayapura | Asia/Jerusalem | Asia/Kabul | Asia/Kamchatka | Asia/Karachi |
Asia/Kashgar | Asia/Kathmandu | Asia/Katmandu | Asia/Khandyga | Asia/Kolkata |
Asia/Krasnoyarsk | Asia/Kuala_Lumpur | Asia/Kuching | Asia/Kuwait | Asia/Macao |
Asia/Macau | Asia/Magadan | Asia/Makassar | Asia/Manila | Asia/Muscat |
Asia/Nicosia | Asia/Novokuznetsk | Asia/Novosibirsk | Asia/Omsk | Asia/Oral |
Asia/Phnom_Penh | Asia/Pontianak | Asia/Pyongyang | Asia/Qatar | Asia/Qyzylorda |
Asia/Rangoon | Asia/Riyadh | Asia/Saigon | Asia/Sakhalin | Asia/Samarkand |
Asia/Seoul | Asia/Shanghai | Asia/Singapore | Asia/Taipei | Asia/Tashkent |
Asia/Tbilisi | Asia/Tehran | Asia/Tel_Aviv | Asia/Thimbu | Asia/Thimphu |
Asia/Tokyo | Asia/Ujung_Pandang | Asia/Ulaanbaatar | Asia/Ulan_Bator | Asia/Urumqi |
Asia/Ust-Nera | Asia/Vientiane | Asia/Vladivostok | Asia/Yakutsk | Asia/Yekaterinburg |
Asia/Yerevan |
Africa
Africa/Abidjan | Africa/Accra | Africa/Addis_Ababa | Africa/Algiers | Africa/Asmara |
Africa/Asmera | Africa/Bamako | Africa/Bangui | Africa/Banjul | Africa/Bissau |
Africa/Blantyre | Africa/Brazzaville | Africa/Bujumbura | Africa/Cairo | Africa/Casablanca |
Africa/Ceuta | Africa/Conakry | Africa/Dakar | Africa/Dar_es_Salaam | Africa/Djibouti |
Africa/Douala | Africa/El_Aaiun | Africa/Freetown | Africa/Gaborone | Africa/Harare |
Africa/Johannesburg | Africa/Juba | Africa/Kampala | Africa/Khartoum | Africa/Kigali |
Africa/Kinshasa | Africa/Lagos | Africa/Libreville | Africa/Lome | Africa/Luanda |
Africa/Lubumbashi | Africa/Lusaka | Africa/Malabo | Africa/Maputo | Africa/Maseru |
Africa/Mbabane | Africa/Mogadishu | Africa/Monrovia | Africa/Nairobi | Africa/Ndjamena |
Africa/Niamey | Africa/Nouakchott | Africa/Ouagadougou | Africa/Porto-Novo | Africa/Sao_Tome |
Africa/Timbuktu | Africa/Tripoli | Africa/Tunis | Africa/Windhoek |
Antarctica
Antarctica/Casey | Antarctica/Davis | Antarctica/DumontDUrville | Antarctica/Macquarie | Antarctica/Mawson |
Antarctica/McMurdo | Antarctica/Palmer | Antarctica/Rothera | Antarctica/South_Pole | Antarctica/Syowa |
Antarctica/Vostok |
Arctic
Arctic/Longyearbyen |
Atlantic
Atlantic/Azores | Atlantic/Bermuda | Atlantic/Canary | Atlantic/Cape_Verde | Atlantic/Faeroe |
Atlantic/Faroe | Atlantic/Jan_Mayen | Atlantic/Madeira | Atlantic/Reykjavik | Atlantic/South_Georgia |
Atlantic/St_Helena | Atlantic/Stanley |
Indian
Indian/Antananarivo | Indian/Chagos | Indian/Christmas | Indian/Cocos | Indian/Comoro |
Indian/Kerguelen | Indian/Mahe | Indian/Maldives | Indian/Mauritius | Indian/Mayotte |
Indian/Reunion |
Pacific
Pacific/Apia | Pacific/Auckland | Pacific/Chatham | Pacific/Chuuk | Pacific/Easter |
Pacific/Efate | Pacific/Enderbury | Pacific/Fakaofo | Pacific/Fiji | Pacific/Funafuti |
Pacific/Galapagos | Pacific/Gambier | Pacific/Guadalcanal | Pacific/Guam | Pacific/Honolulu |
Pacific/Johnston | Pacific/Kiritimati | Pacific/Kosrae | Pacific/Kwajalein | Pacific/Majuro |
Pacific/Marquesas | Pacific/Midway | Pacific/Nauru | Pacific/Niue | Pacific/Norfolk |
Pacific/Noumea | Pacific/Pago_Pago | Pacific/Palau | Pacific/Pitcairn | Pacific/Pohnpei |
Pacific/Ponape | Pacific/Port_Moresby | Pacific/Rarotonga | Pacific/Saipan | Pacific/Samoa |
Pacific/Tahiti | Pacific/Tarawa | Pacific/Tongatapu | Pacific/Truk | Pacific/Wake |
Pacific/Wallis | Pacific/Yap |