Oracle/PLSQL: To_Timestamp_Tz Function

In Oracle/PLSQL, the to_timestamp_tz function converts a string to a timestamp with time zone.

Syntax

The syntax for the to_timestamp_tz function is:

to_timestamp_tz( string1 , [ format_mask ] [ 'nlsparam' ] )

string1 is the string that will be converted to a timestamp with time zone.

format_mask is optional. This is the format that will be used to convert string1 to a timestamp with time zone.

The following is a list of options for the format_mask parameter. These parameters can be used in many combinations.

Parameter	Explanation
YYYY	4-digit year
MM	Month (01-12; JAN = 01).
MON	Abbreviated name of month.
MONTH	Name of month, padded with blanks to length of 9 characters.
DD	Day of month (1-31).
HH	Hour of day (1-12).
HH12	Hour of day (1-12).
HH24	Hour of day (0-23).
MI	Minute (0-59).
SS	Second (0-59).
TZM	Time zone minute.
TZH	Time zone hour.

Applies To

• Oracle 11g, Oracle 10g, Oracle 9i

For Example

to_timestamp_tz('2003/12/13 10:13:18 -8:00', 'YYYY/MM/DD HH:MI:SS TZH:TZM')

would return '13-DEC-03 10.13.18.000000000 AM -08:00' as a timestamp with time zone value.

to_timestamp_tz('2003/DEC/13 10:13:18 -8:00', 'YYYY/MON/DD HH:MI:SS TZH:TZM')

would also return '13-DEC-03 10.13.18.000000000 AM -08:00' as a timestamp with time zone value.