Skip to main content

Description

Convert datetime field to ISO-8601 string or a custom date time format.

Syntax

ToString(Datetime_field) ToString(Datetime_field, formatString)

Arguments

datetime_field - datetime expression. formatString - format of the custom string. See below for formatting information.

Format strings

SymbolMeaningPresentationExamples
GeratextAD
Ccentury of era (>=0)number20
Yyear of era (>=0)year1996
xweekyearyear1996
wweek of weekyearnumber27
eday of weeknumber2
Eday of weektextTuesday; Tue
yyearyear1996
Dday of yearnumber189
Mmonth of yearmonthJuly; Jul; 07
dday of monthnumber10
ahalfday of daytextPM
Khour of halfday (0~11)number0
hclockhour of halfday (1~12)number12
Hhour of day (0~23)number0
kclockhour of day (1~24)number24
mminute of hournumber30
ssecond of minutenumber55
Sfraction of secondnumber978
ztime zonetextPacific Standard Time; PST
Ztime zone offset/idzone-0800; -08:00; America/Los_Angeles
\‘escape characterfor a-z/A-ZT
\’\‘single quoteliteral single quote
Based on http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html

Examples

ToString(ToDate(‘2013-10-17T00:00:00.000Z’),‘MM-dd-yy’) returns a string 10-17-13 ToString(ToDate('2013-10-17T00:00:00.000Z'), 'yyyy-MM-dd\'T\'HH:mm:ss') returns a string 2013-10-17T00:00:00

Return value datatype

string

Impact of null value

If either parameter is null or not provided, returns null.
Last modified on April 20, 2026