Oracle / PLSQL: LOCALTIMESTAMP function
This Oracle tutorial explains how to use the Oracle/PLSQL LOCALTIMESTAMP function with syntax and examples.
Description
The Oracle/PLSQL LOCALTIMESTAMP function returns the current date and time in the time zone of the current SQL session as set by the ALTER SESSION command. It returns a TIMESTAMP value.
Syntax
The syntax for the LOCALTIMESTAMP function in Oracle/PLSQL is:
LOCALTIMESTAMP
Parameters or Arguments
There are no parameters or arguments for the LOCALTIMESTAMP function.
Returns
The LOCALTIMESTAMP function returns a TIMESTAMP value.
Note
- A similar function to the LOCALTIMESTAMP function is the CURRENT_TIMESTAMP function.
- The difference between these two functions is that the LOCALTIMESTAMP function returns a TIMESTAMP value while the CURRENT_TIMESTAMP function returns a TIMESTAMP WITH TIME ZONE value.
Applies To
The LOCALTIMESTAMP function can be used in the following versions of Oracle/PLSQL:
- Oracle 12c, Oracle 11g, Oracle 10g, Oracle 9i, Oracle 8i
Example
Let's look at some Oracle LOCALTIMESTAMP function examples and explore how to use the LOCALTIMESTAMP function in Oracle/PLSQL.
For example:
If the following ALTER SESSION command was issued:
ALTER SESSION SET TIME_ZONE = '-7:0';
And then the following SQL statement was executed:
select LOCALTIMESTAMP from dual;
You might get the following result:
10-Sep-05 10.58.24 PM
You then modified the session time zone with the following ALTER SESSION command:
ALTER SESSION SET TIME_ZONE = '-2:0';
And then the following SQL statement was executed:
select LOCALTIMESTAMP from dual;
You would now get the following result:
10-Sep-05 03.58.24 AM
The session time zone value has changed from -7:0 to -2:0, causing the LOCALTIMESTAMP function to return the current date and time as a value 5 hours ahead.
Advertisements