TO_TIMESTAMP_TZ

TO_TIMESTAMP_TZ converts a text expression to a value of TIMESTAMP WITH TIME ZONE data type.

Return Value

TIMESTAMP WITH TIME ZONE

Syntax

TO_TIMESTAMP_TZ(char [, fmt [ 'nlsparam' ] ])

Arguments

char is a text expression to be converted.

fmt is a datetime model format specifying the format of char. The default date format is determined implicitly by the NLS_TERRITORY initialization parameter or can be set explicitly by the NLS_DATE_FORMAT parameter. For data type formats, refer to the Oracle Database SQL Reference.

nlsparam specifies the language in which month and day names and abbreviations are returned. This argument can have this form:

'NLS_DATE_LANGUAGE = language'

By default, the return value is in the session date language.

Example

TO_TIMESTAMP_TZ('2006-03-26 7:33:00 -4:00', 'YYYY-MM-DD HH:MI:SS TZH:TZM') returns the value 26-MAR-06 07.33.00 AM -04:00.