TIME

The TIME function returns a time from a value.

TIME(expression)
expression
An expression that returns a value of one of the following built-in data types: a date, a time, a timestamp, a character string, or a graphic string.

If expression is a character or graphic string, its value must be a valid string representation of a date, time, or timestamp. If expression is a valid string representation of a date, it must be one of the IBM® SQL standard formats. For the valid formats of string representations of dates, times, and timestamps, see String representations of datetime values.

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 date:

    The result is midnight.

  • 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 or graphic string:

    The result is the time represented by the string or the time part of the timestamp value represented by the string.

Note

Syntax alternatives: The CAST specification should be used to increase the portability of applications. For more information, see CAST specification.

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