nls_date_format

Description

nls_date_format specifies the format for converting a date type to a string and for implicitly converting a string to a date.

Privilege requirements

• Query variables

  • Global level

    The sys tenant and all user tenants can execute the SHOW VARIABLES statement or query the SYS.TENANT_VIRTUAL_GLOBAL_VARIABLE view (Oracle-compatible mode) to view the value of a global system variable.

  • Session level

    The sys tenant and all user tenants can execute the SHOW VARIABLES statement or query the SYS.TENANT_VIRTUAL_SESSION_VARIABLE view (Oracle-compatible mode) to view the value of a session system variable.

• Modify variables

  • Global level

    • The sys tenant can directly modify the value of a global system variable.

    • An Oracle user tenant must have the ALTER SYSTEM privilege to modify the value of a global system variable.

  • Session level

    The sys tenant and all user tenants can directly modify the value of a session system variable.

Attributes

Usage

The start_date parameter is of the DATE type. The value of start_date is converted to text in the format specified by the NLS_DATE_FORMAT system variable and then passed to the SQL text. The date and time format model can be simply a text string enclosed in double quotation marks.

Examples

Set the format for converting a date type to a string to DD-MON-RR.

• Session level

  obclient> SET nls_date_format='DD-MON-RR';
  

• Global level

  obclient> SET GLOBAL nls_date_format='DD-MON-RR';
  

References

• Date and time expressions
• Considerations for data conversion