SQL Reference

TIME

>>-TIME--(--expression--)--------------------------------------><
 

The schema is SYSIBM.

The TIME function returns a time from a value.

The argument must be a time, timestamp, or a valid character string representation of a time or timestamp that is neither a CLOB nor a LONG VARCHAR.

The result of the function is a time. If the argument can be null, the result can be null; if the argument is null, the result is the null value.

The other rules depend on the data type of the argument:

• If the argument is a time:
  • The result is that time.
• If the argument is a timestamp:
  • The result is the time part of the timestamp.
• If the argument is a character string:
  • The result is the time represented by the character string.

Example:

• Select all notes from the IN_TRAY sample table that were received at least one hour later in the day (any day) than the current time.

    SELECT * FROM IN_TRAY
      WHERE TIME(RECEIVED) >= CURRENT TIME + 1 HOUR