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
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.