Caché ObjectScript Reference - InterSystems Documentation

• $ZDATETIME(hdatetime) returns the date and time in the default display format forthe current locale.• $ZDATETIME(hdatetime,dformat,tformat,precision,monthlist,yearopt,startwin,endwin,mindate,maxdate,erropt)returns the date and time in the display format specified by dformat and tformat, furtherdefined by the other parameters you specify. The range of valid dates may be restrictedby the mindate and maxdate parameters.ParametershdatetimeThe date and time, specified as an internal format value. Caché internal format representsdates as a count of days from an arbitrary starting point (Dec. 31, 1840), and represents timesas a count of seconds in the current day. The hdatetime value must be a string in one of thefollowing formats:• $HOROLOG: two unsigned integers separated by comma. The first is an integer specifyingthe date (in days), the second is an integer specifying the time (in seconds).• $ZTIMESTAMP: two unsigned numbers separated by comma: the first is an integerspecifying the date (in days), the second is a number specifying the time (in seconds andfractions of a second). The time value can have up to nine digits of precision (fractionalseconds) to the right of the decimal point.You can specify hdatetime as a string value, a variable, or an expression.dformatFormat for the returned date. Valid values are:$ZDATETIMEValue-112345MeaningGet effective dformat value from the DateFormat property of the current locale,which defaults to a value of 1. This is the default behavior if you do not specifydformat.MM/DD/[YY]YY (01/01/97) - The default formatDD Mmm [YY]YY (01 Jul 97)YYYY-MM-DD (1997-07-01) - ODBC formatDD/MM/[YY]YY (01/07/97) - European formatMmm D, YYYY (Jul 1, 1997)Caché ObjectScript Reference 345