TIME fonction scalaire

La fonction TIME renvoie la partie heure d'une valeur.

Read syntax diagramSkip visual syntax diagramTIME(expression)

Le schéma est SYSIBM.

expression
Expression qui renvoie une valeur de l'un des types de données intégrés suivants: DATE, TIME, TIMESTAMP ou une représentation de chaîne de caractères valide d'une date, d'une heure ou d'un horodatage qui n'est pas un objet CLOB. Dans une base de données Unicode, si une expression renvoie une valeur d'un type de données de chaîne graphique, la valeur est d'abord convertie en chaîne de caractères avant l'exécution de la fonction.

Le résultat de la fonction est TIME. Si l'argument peut être null, le résultat peut être null ; si l'argument est null, le résultat est la valeur null.

Les autres règles dépendent du type de données de l'argument:
  • Si l'argument est une DATE ou une représentation sous forme de chaîne d'une date:
    • Le résultat est minuit.
  • Si l'argument est TIME:
    • Le résultat est ce temps.
  • Si l'argument est un TIMESTAMP:
    • Le résultat est la partie heure de l'horodatage.
  • Si l'argument est une chaîne représentation de l'heure ou de l'horodatage:
    • Le résultat est l'heure représentée par la chaîne.

Exemple

Sélectionnez toutes les remarques de l'exemple de table IN_TRAY qui ont été reçues au moins une heure plus tard dans la journée (n'importe quel jour) que l'heure en cours.
   SELECT * FROM IN_TRAY
     WHERE TIME(RECEIVED) >= CURRENT TIME + 1 HOUR