<g:formatDate format="yyyy-MM-dd" date="${date}"/>
formatDate
Purpose
Formats java.util.Date
, java.time.LocalDate
, and java.time.LocalDateTime
instances using the patterns defined by the {javase}java.base/java/text/SimpleDateFormat.html[SimpleDateFormat] class.
Examples
<g:formatDate date="${date}" type="datetime" style="MEDIUM"/>
<g:formatDate date="${date}" type="datetime" style="LONG" timeStyle="SHORT"/>
<g:formatDate date="${date}" type="time" style="SHORT"/>
Description
Attributes
-
date
(required) - The date object to format. It could be the instance ofjava.util.Date
,java.time.LocalDate
,java.time.LocalDateTime
. -
format
(optional) - The formatting pattern to use for the date, see {javase}java.base/java/text/SimpleDateFormat.html[SimpleDateFormat] -
formatName
(optional) - Look upformat
from the default MessageSource / ResourceBundle (i18n/*.properties file) with this key. Ifformat
andformatName
are empty,format
is looked up with ‘default.date.format’ key. Defaults to 'yyyy-MM-dd HH:mm:ss z' if the key not specified -
type
(optional) - The type of format to use for the date / time.format
orformatName
aren’t used whentype
is specified. Possible values: 'date' - shows only date part, 'time' - shows only time part, 'both'/'datetime' - shows date and time -
timeZone
(optional) - Sets the time zone for formatting. See {javase}java.base/java/util/TimeZone.html[TimeZone] class. -
locale
(optional) - Force the locale for formatting. -
style
(optional) - Use default date/time formatting of the country specified by the locale. Possible values: SHORT (default), MEDIUM, LONG, FULL . See {javase}java.base/java/text/DateFormat.html[DateFormat] for explanation. -
dateStyle
(optional) - Set separatestyle
for the date part. -
timeStyle
(optional) - Set separatestyle
for the time part.
While using java.time.LocalDate as the date value please specify the format attribute as the default (yyyy-MM-dd HH:mm:ss z) would fail to format because java.time.LocalDate does not have any time format.
|