Catégories :

Fonctions de conversion , Fonctions de date et d’heure

TO_TIME , TIME

Convertit une expression d’entrée en heure.

Voir aussi :

TRY_TO_TIME

Syntaxe

TO_TIME( <string_expr> [, <format> ] )
TO_TIME( <timestamp_expr> )
TO_TIME( '<integer>' )
TO_TIME( <variant_expr> )

TIME( <string_expr> )
TIME( <timestamp_expr> )
TIME( '<integer>' )
TIME( <variant_expr> )
Copy

Arguments

Obligatoire :

string_expr ou timestamp_expr ou 'integer' ou variant_expr

Expression à convertir en une heure :

  • Pour string_expr, chaîne à convertir en heure.

  • Pour timestamp_expr, horodatage à convertir en heure. La fonction renvoie la portion heure de la valeur d’entrée.

  • Pour 'integer', chaîne contenant un entier à convertir en heure. L’entier est traité comme un nombre de secondes, millisecondes, microsecondes ou nanosecondes après le début de l’époque Unix. Voir les Notes sur l’utilisation.

    Pour cet horodatage, la fonction obtient le nombre de secondes après le début de l’epoch Unix. La fonction effectue une opération modulo pour obtenir le reste de la division de ce nombre par le nombre de secondes dans un jour (86400) :

    number_of_seconds % 86400

    La fonction interprète ce reste comme le nombre de secondes après minuit.

    Par exemple, supposons que la valeur est '31536002789'.

    1. Sur la base de l’amplitude de cette valeur, la fonction utilise les millisecondes comme unité de temps et détermine que la valeur représente 1971-01-01 00:00:02.789.

    2. La fonction obtient le nombre de secondes après l’epoch Unix pour cette valeur (31536002).

    3. La fonction obtient le reste en divisant ce nombre par le nombre de secondes dans un jour (31536002 % 86400).

    4. La fonction utilise le reste (2) comme nombre de secondes après minuit. La valeur résultante était 00:00:02.

  • Pour variant_expr :

    • Si la VARIANT contient une chaîne au format TIME (tel que HH:MI:SS), une conversion de chaîne est effectuée.

    • Si la VARIANT contient une chaîne au format INTEGER, une conversion de chaîne est effectuée et la valeur est traitée comme le nombre de secondes depuis minuit (modulus 86400, si nécessaire).

    • Si la VARIANT contient une valeur nulle JSON, la sortie est NULL.

Pour toutes les autres valeurs, une erreur de conversion est générée.

Facultatif :

format

Spécificateur de format d’heure pour string_expr ou AUTO, qui précise que Snowflake détecte automatiquement le format à utiliser. Pour plus d’informations, voir Formats de date et d’heure dans les fonctions de conversion.

Par défaut : valeur actuelle du paramètre de session TIME_INPUT_FORMAT (par défaut, AUTO)

Renvoie

Le type de données de la valeur renvoyée est TIME. Si l’entrée est NULL, renvoie NULL.

Notes sur l’utilisation

  • Le format d’affichage des heures dans la sortie est déterminé par le paramètre de session TIME_OUTPUT_FORMAT (par défaut, HH24:MI:SS).

  • Si le format du paramètre d’entrée est une chaîne contenant un entier, l’unité de mesure de la valeur (secondes, microsecondes, millisecondes ou nanosecondes) est déterminée comme suit :

  • Une fois la chaîne convertie en entier, l’entier est traité comme un nombre de secondes, millisecondes, microsecondes ou nanosecondes après le début de l’epoch Unix (1970-01-01 00:00:00.000000000 UTC).

    • Si l’entier est inférieur à 31536000000 (le nombre de millisecondes dans une année), alors la valeur est traitée comme un nombre de secondes.

    • Si la valeur est supérieure ou égale à 31536000000 et inférieure à 31536000000000, la valeur est alors traitée en millisecondes.

    • Si la valeur est supérieure ou égale à 31536000000000 et inférieure à 31536000000000000, la valeur est alors traitée en microsecondes.

    • Si la valeur est supérieure ou égale à 31536000000000000, alors la valeur est traitée comme des nanosecondes.

  • Si plusieurs lignes sont évaluées (par exemple, si l’entrée est le nom de colonne d’une table qui contient plus d’une ligne), chaque valeur est examinée indépendamment pour déterminer si elle représente des secondes, des millisecondes, des microsecondes ou des nanosecondes.

  • Contrairement à la fonction TO_TIME, la fonction TIME ne prend pas en charge le paramètre facultatif format.

Exemples

Ces exemples utilisent les fonctions TO_TIME et TIME.

SELECT TO_TIME('13:30:00'), TIME('13:30:00');
Copy
+---------------------+------------------+
| TO_TIME('13:30:00') | TIME('13:30:00') |
|---------------------+------------------|
| 13:30:00            | 13:30:00         |
+---------------------+------------------+
SELECT TO_TIME('13:30:00.000'), TIME('13:30:00.000');
Copy
+-------------------------+----------------------+
| TO_TIME('13:30:00.000') | TIME('13:30:00.000') |
|-------------------------+----------------------|
| 13:30:00                | 13:30:00             |
+-------------------------+----------------------+

Cet exemple montre comment utiliser la fonction TO_TIME pour traiter des séparateurs de champs autres que les deux-points par défaut. L’exemple utilise le caractère de point comme séparateur entre les heures et les minutes et entre les minutes et les secondes :

SELECT TO_TIME('11.15.00', 'HH24.MI.SS');
Copy
+-----------------------------------+
| TO_TIME('11.15.00', 'HH24.MI.SS') |
|-----------------------------------|
| 11:15:00                          |
+-----------------------------------+

Cet exemple montre comment la fonction TO_TIME interprète une chaîne contenant un entier :

CREATE OR REPLACE TABLE demo1_time (
  description VARCHAR,
  value VARCHAR -- string rather than bigint
);

INSERT INTO demo1_time (description, value) VALUES
  ('Seconds',      '31536001'),
  ('Milliseconds', '31536002400'),
  ('Microseconds', '31536003600000'),
  ('Nanoseconds',  '31536004900000000');
Copy
SELECT description,
       value,
       TO_TIMESTAMP(value),
       TO_TIME(value)
  FROM demo1_time
  ORDER BY value;
Copy
+--------------+-------------------+-------------------------+----------------+
| DESCRIPTION  | VALUE             | TO_TIMESTAMP(VALUE)     | TO_TIME(VALUE) |
|--------------+-------------------+-------------------------+----------------|
| Seconds      | 31536001          | 1971-01-01 00:00:01.000 | 00:00:01       |
| Milliseconds | 31536002400       | 1971-01-01 00:00:02.400 | 00:00:02       |
| Microseconds | 31536003600000    | 1971-01-01 00:00:03.600 | 00:00:03       |
| Nanoseconds  | 31536004900000000 | 1971-01-01 00:00:04.900 | 00:00:04       |
+--------------+-------------------+-------------------------+----------------+