Format.date ViewHelper <f:format.date>
ViewHelper to format an object implementing \Date into human-readable output.
Go to the source code of this ViewHelper: Format\DateViewHelper.php (GitHub).
Table of contents
Examples
Defaults
<f:format.date>{dateObject}</f:format.date>1980-12-13Depending on the current date.
Custom date format
<f:format.date format="H:i">{dateObject}</f:format.date>01:23Depending on the current time.
Relative date with given time
<f:format.date format="Y" base="{dateObject}">-1 year</f:format.date>2016Assuming 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:42Depending 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 1980Depending 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 1980Depending 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-13Depending on the value of {date.
Inline notation (2nd variant)
{dateObject -> f:format.date()}1980-12-13Depending on the value of {date.
Arguments of the <f:format.date> ViewHelper
base
-
- Type
- mixed
A base time (an object implementing DateTimeInterface or a string) used if $date is a relative date specification. Defaults to current time.
date
-
- Type
- mixed
Either an object implementing DateTimeInterface or a string that is accepted by DateTime constructor
format
-
- Type
- string
- Default
- ''
Format String which is taken to format the Date/Time
locale
-
- Type
- string
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
pattern
-
- Type
- string
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.