The Oracle FROM_TZ() function converts a timestamp and a time zone to value with the type of TIME STAMP WITH TIME ZONE.
Syntax #
The following illustrates the syntax of the FROM_TZ() function:
FROM_TZ (timestamp, timezone)
Code language: SQL (Structured Query Language) (sql)
Arguments #
The Oracle FROM_TZ() function requires two arguments:
1) timestamp
The timestamp is a TIMESTAMP value which should be converted to a TIME STAMP WITH TIME ZONE value.
2) timezone
The timezone is a character string in the format TZH:TZM e.g., -08:00 or a character expression that evaluates to a string in TZR with optional TZD format.
Return value #
The Oracle FROM_TZ() function returns a TIMESTAMP WITH TIME ZONE value.
Examples #
The following example shows how to convert a timestamp and a time zone to a TIMESTAMP WITH TIME ZONE value:
SELECT
FROM_TZ(TIMESTAMP '2017-08-08 08:09:10', '-07:00')
FROM
DUAL;
Code language: SQL (Structured Query Language) (sql)
Here is the returned value:
08-AUG-17 08.09.10.000000000 AM -07:00
Code language: SQL (Structured Query Language) (sql)
In this tutorial, you have learned how to use the Oracle FROM_TZ() function to create a TIMESTAMP WITH TIME ZONE value from a timestamp and a time zone.