format.date¶

Formats an object implementing \DateTimeInterface.

Possible date/time formats can be found in the PHP documentation: https://www.php.net/manual/datetime.format.php

Examples¶

Defaults¶

<f:format.date>{dateObject}</f:format.date>

1980-12-13 Depending on the current date.

Custom date format¶

<f:format.date format="H:i">{dateObject}</f:format.date>

01:23 Depending on the current time.

Relative date with given time¶

<f:format.date format="Y" base="{dateObject}">-1 year</f:format.date>

2016 Assuming dateObject is in 2017.

strtotime string¶

<f:format.date format="d.m.Y - H:i:s">+1 week 2 days 4 hours 2 seconds</f:format.date>

13.12.1980 - 21:03:42 Depending on the current time, see https://www.php.net/manual/function.strtotime.php.

Localized dates using strftime date format¶

<f:format.date format="%d. %B %Y">{dateObject}</f:format.date>

13. Dezember 1980 Depending on the current date and defined locale. In the example you see the 1980-12-13 in a german locale.

Localized dates using ICU-based date and time formatting¶

<f:format.date pattern="dd. MMMM yyyy" locale="de-DE">{dateObject}</f:format.date>

13. Dezember 1980 Depending on the current date. In the example you see the 1980-12-13 in a german locale.

Localized dates using default formatting patterns¶

<f:format.date pattern="FULL" locale="fr-FR">{dateObject}</f:format.date>

jeudi 9 mars 2023 21:40:49 temps universel coordonn Depending on the current date and operating system setting. In the example you see the 2023-03-09 in a french locale.

Inline notation¶

{f:format.date(date: dateObject)}

1980-12-13 Depending on the value of {dateObject}.

Inline notation (2nd variant)¶

{dateObject -> f:format.date()}

1980-12-13 Depending on the value of {dateObject}.

Arguments¶

date¶

DataType: mixed
Required: false
Description: Either an object implementing DateTimeInterface or a string that is accepted by DateTime constructor

format¶

DataType: string
Required: false
Description: Format String which is taken to format the Date/Time

pattern¶

DataType: string
Required: false
Description: Format date based on unicode ICO format pattern given see https://unicode-org.github.io/icu/userguide/format_parse/datetime/#datetime-format-syntax. If both "pattern" and "format" arguments are given, pattern will be used.

locale¶

DataType: string
Required: false
Description: A locale format such as "nl-NL" to format the date in a specific locale, if none given, uses the current locale of the current request. Only works when pattern argument is given

base¶

DataType: mixed
Required: false
Description: A base time (an object implementing DateTimeInterface or a string) used if $date is a relative date specification. Defaults to current time.