Date and Time Formatters
The date formatter takes as a first parameter a valid JavaScript Date object, ISO 8601 date
string or a valid date and time strings.
As a second parameter it takes an object, which defines the format options.
The third optional parameter is a string representing a custom locale code. If no locale is given the
current user locale is used.
Underneath for the date formatter we use sap.ui.core.format.DateFormat and the second parameter
options is passed unchanged to the getDateTimeInstance.
The options and locale parameters are optional and can be omitted. If only
options is omitted
the locale will be shifted in its place.
format.dateTime(date, options?, locale?)
| Param | Type | Required | Description | Since |
|---|---|---|---|---|
| date | JS Date | Yes | Any valid value, that can construct JavaScript Date object. | 1.74 |
| options | object | No | Formatting options. | 1.74 |
| locale | string | No | A string representing the locale code | 1.74 |
| Returns | ||||
| string | The formatted date. | 1.74 |
The date parameter can come from different places including
{parameters>/TODAY_ISO}}, {parameters>/NOW_ISO}},
data binding, Date.now() and many more.
Examples
A card with a dateTime formatter using expression binding for today with
{pattern: 'MMMM d, y'} as format options
"sap.card": {
"type": "List",
"header": {
"title": "Order status {= format.dateTime(Date.now(), {pattern: 'MMMM d, y'}) }"
}
}
Try it Out