Functions to parse datetimes from strings, using a specified pattern, or produce a string from a datetime.
See https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/text/SimpleDateFormat.html for all pattern possibilities.
parseDateTime[UTC]
Takes a string and tries to parse it. If it fails and a default value is specified, it returns the default value. Otherwise, an error is raised. The function parseDateTime uses the user’s timezone and parseDateTimeUTC uses the UTC calendar.
Input parameters
- a date Type: String
- a format Type: String
- a default value (optional) Type: Date and time
Output
The parsed date, or the default value if a date could not be parsed. Type: Date and time
parseDateTime('2015-05-21', 'yyyy-MM-dd')
returns
The date May 21st, 2015\. The time will be 12 o'clock at night because it is not specified.
parseDateTime('noDateTime', 'dd-MM-yyyy', dateTime(2007))
returns
'Mon Jan 01 00:00:00 CET 2007'
formatDateTime[UTC]
Converts the datetime to a string, formatted according to the format parameter. Without the format parameter, a standard format is used. The function formatDateTime uses the users calendar and formatDateTimeUTC uses the UTC calendar.
Input parameters
- a date Type: Date and time
- a format (optional) Type: String
Output
A formatted representation of the datetime. Type: String
formatDateTime($object/Date1,'EEE, d MMM yyyy HH:mm:ss Z')
returns:
'Sun, 8 Jun 2008 10:12:01 +0200'
To get ‘1987-12-31T23:59:00’, you need to concatenate two formatDateTime[UTC] functions:
formatDateTime($object/Date1,'yyyy-MM-dd') + 'T' + formatDateTime($object/Date1,'HH:mm:ss')
formatTime[UTC]
Converts the time part of datetime to a string in a standard format. formatTime uses the users calendar and formatTimeUTC uses the UTC calendar.
Input parameters
- a date Type: Date and time
Output
A formatted representation of the time part of the datetime value. Type: String
formatTime(dateTime(1974, 7, 2, 9, 50, 10))
returns:
'9:50 AM'
formatDate[UTC]
Converts the date part of datetime to a string in a standard format. formatDate uses the users calendar and formatDateUTC uses the UTC calendar.
Input parameters
- a date Type: Date and time
Output
A formatted representation of the date part of the datetime value. Type: String
formatDate(dateTime(1974, 7, 2, 9, 50, 10))
returns:
'7/2/74'