Types de données de date et heure¶

Littéraux d’intervalle¶

Un littéral d’intervalle est une expression qui spécifie une durée dans un littéral de chaîne. Utilisez la syntaxe suivante pour spécifier un littéral d’intervalle :

INTERVAL '[ <sign> ] <string>' { <yearMonthQualifier> | <dayTimeQualifier> }

Où :

• sign est un symbole facultatif qui spécifie une durée positive (+) ou négative (-).

  Par défaut : +.

• string est une valeur qui représente une durée.

• yearMonthQualifier est un qualificatif défini dans Syntaxe des types de données d’intervalle.

• dayTimeQualifier est un qualificatif défini dans Syntaxe des types de données d’intervalle.

Formats d’intervalle¶

Les littéraux de chaîne dans des formats spécifiques peuvent représenter des valeurs d’intervalle.

Pour spécifier des valeurs pour les années et les mois, utilisez le format suivant :

'<sign><Y>-<MM>'

Où :

• sign est un symbole obligatoire qui spécifie une durée positive (+) ou négative (-).

  Par défaut : +.

• Y correspond au nombre d’années. Le nombre de chiffres autorisés (précision) dépend du type de données de la valeur.

• MM correspond à deux chiffres pour le nombre de mois, de 00 à 11.

Pour spécifier des valeurs de jours, d’heures, de secondes et de fractions de seconde, utilisez le format suivant :

'<sign>[<D>] [<HH24>]:[<MI>]:[<SS>].[<F>]'

Où :

• sign est un symbole obligatoire qui spécifie une durée positive (+) ou négative (-).

  Par défaut : +.

• D correspond au nombre de jours. Le nombre de chiffres autorisés (précision) dépend du type de données de la valeur.

  Omettez D pour les valeurs des types suivants :

  • INTERVAL HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL HOUR TO SECOND

  • INTERVAL MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL SECOND

• HH24 correspond à deux chiffres pour le nombre d’heures, de 00 à 23.

  Omettez HH24 pour les valeurs des types suivants :

  • INTERVAL DAY

  • INTERVAL MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL SECOND

• MI correspond à deux chiffres pour le nombre de minutes, de 00 à 59.

  Omettez MI pour les valeurs des types suivants :

  • INTERVAL DAY TO HOUR

  • INTERVAL DAY

  • INTERVAL HOUR

  • INTERVAL SECOND

• SS correspond à deux chiffres pour le nombre de secondes, de 00 à 59.

  Omettez SS pour les valeurs des types suivants :

  • INTERVAL DAY

  • INTERVAL DAY TO HOUR

  • INTERVAL DAY TO MINUTE

  • INTERVAL HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL MINUTE

• F correspond au nombre de fractions de secondes pour les types de données qui incluent des secondes. Le nombre de chiffres autorisés (précision) dépend du type de données de la valeur.

Les notes sur l’utilisation suivantes s’appliquent aux littéraux de chaîne au format d’intervalle :

• La représentation littérale de chaîne s’applique lorsque vous utilisez la fonction CAST ou TO_CHAR pour convertir explicitement des intervalles en chaînes de texte.

• Les zéros de début dans un champ spécifient la précision.

Exemples de valeurs d’intervalle¶

Le tableau suivant montre comment représenter différentes valeurs d’intervalle. Les valeurs indiquées dans le tableau sont conformes aux règles suivantes pour les valeurs d’intervalle :

• Pour les valeurs positives, le signe plus + est facultatif pour les valeurs littérales d’intervalle, mais obligatoire pour les valeurs de format d’intervalle.

• Dans les valeurs littérales d’intervalle, la valeur entre parenthèses spécifie la précision, qui correspond au nombre de chiffres autorisés. Par exemple, YEAR(3) précise que trois chiffres sont autorisés pour l’année.

• Dans les valeurs de format d’intervalle, le champ principal (le champ de début) ne comprend pas de zéros de début. Les champs subordonnés utilisent un nombre fixe de chiffres. Par exemple, dans une valeur YEAR TO MONTH comme +1-08, le champ année n’a pas de zéros de début et le champ mois utilise deux chiffres.

Effectuer des calculs en utilisant des données d’intervalle¶

Les exemples suivants effectuent des calculs en utilisant des données d’intervalle.

Ajoutez une année et un mois à une date :

SELECT TO_DATE('2024-01-01') + INTERVAL '1-1' YEAR TO MONTH
  AS date_plus_one_year_one_month;

+------------------------------+
| DATE_PLUS_ONE_YEAR_ONE_MONTH |
|------------------------------|
| 2025-02-01                   |
+------------------------------+

Soustrayez une année et un mois à une date :

SELECT TO_DATE('2024-01-01') + INTERVAL '-1-1' YEAR TO MONTH
  AS date_plus_one_year_one_month;

+------------------------------+
| DATE_PLUS_ONE_YEAR_ONE_MONTH |
|------------------------------|
| 2022-12-01                   |
+------------------------------+

Ajoutez une période de temps à un horodatage :

SELECT TO_TIMESTAMP('2024-01-01 08:08:08.99') + INTERVAL '1 01:01:01.7878' DAY TO SECOND
  AS date_plus_period_of_time;

+--------------------------+
| DATE_PLUS_PERIOD_OF_TIME |
|--------------------------|
| 2024-01-02 09:09:10.777  |
+--------------------------+

L’exemple suivant utilise la fonction SYSTEM$TYPEOF pour montrer qu’une valeur INTERVAL DAY TO SECOND est renvoyée lorsqu’une requête soustrait deux valeurs d’horodatage :

SELECT SYSTEM$TYPEOF(TO_TIMESTAMP('2025-10-05 01:02:03') - TO_TIMESTAMP('2025-09-15 11:36:22'))
  AS type;

+------------------------------------+
| TYPE                               |
|------------------------------------|
| INTERVAL DAY(9) TO SECOND(9)[SB16] |
+------------------------------------+

Pour afficher les résultats de la requête au format d’intervalle, vous pouvez convertir l’expression en type de données INTERVAL DAY(2) TO SECOND(2) pour spécifier la précision, puis convertir ce type de données en valeur VARCHAR :

SELECT (TO_TIMESTAMP('2025-10-05 01:02:03') - TO_TIMESTAMP('2025-09-15 11:36:22'))::INTERVAL DAY(2) TO SECOND(2)::VARCHAR
  AS interval_format_result;

+------------------------+
| INTERVAL_FORMAT_RESULT |
|------------------------|
| +19 13:25:41.00        |
+------------------------+

Insertion et interrogation de données d’intervalle année-mois¶

Créez une table permettant de suivre les candidatures aux postes vacants au moyen d’une colonne INTERVAL YEAR TO MONTH, puis insérez-y les données :

CREATE OR REPLACE TABLE candidates (
  name_first VARCHAR,
  name_last VARCHAR,
  duration_of_experience INTERVAL YEAR(2) TO MONTH);

INSERT INTO candidates VALUES ('Jane', 'Smith', '14-4');
INSERT INTO candidates VALUES ('Robert', 'Adams', '0-3');
INSERT INTO candidates VALUES ('Mary', 'Jones', '5-11');

Lorsque vous interrogez la table sans convertir la colonne ` duration_of_experience`` en un type de données, la sortie affiche les valeurs de la colonne sous forme de nombre total de mois dans chaque ligne :

SELECT name_first,
       name_last,
       duration_of_experience AS months_of_experience
  FROM candidates;

+------------+-----------+----------------------+
| NAME_FIRST | NAME_LAST | MONTHS_OF_EXPERIENCE |
|------------+-----------+----------------------|
| Jane       | Smith     |                  172 |
| Robert     | Adams     |                    3 |
| Mary       | Jones     |                   71 |
+------------+-----------+----------------------+

Lorsque vous interrogez la table et que vous convertissez la colonne duration_of_experience en type de données VARCHAR, la sortie affiche les valeurs de la colonne au format d’intervalle :

SELECT name_first,
       name_last,
       duration_of_experience::VARCHAR AS duration_of_experience
  FROM candidates;

+------------+-----------+------------------------+
| NAME_FIRST | NAME_LAST | DURATION_OF_EXPERIENCE |
|------------+-----------+------------------------|
| Jane       | Smith     | +14-04                 |
| Robert     | Adams     | +0-03                  |
| Mary       | Jones     | +5-11                  |
+------------+-----------+------------------------+

Insertion et interrogation de données d’intervalle jour-heure¶

Créez une table qui spécifie la durée d’expiration pour différentes fonctionnalités logicielles au moyen d’une colonne INTERVAL HOUR TO SECOND, puis insérez-y les données :

CREATE OR REPLACE TABLE feature_timeouts (
  feature VARCHAR,
  timeout_duration INTERVAL HOUR(2) TO SECOND(0));

INSERT INTO feature_timeouts VALUES ('Feature1', '00:00:30');
INSERT INTO feature_timeouts VALUES ('Feature2', '00:10:00');
INSERT INTO feature_timeouts VALUES ('Feature3', '01:00:00');

Interrogez la table et convertissez la colonne timeout_duration en type de données VARCHAR :

SELECT feature,
       timeout_duration::VARCHAR AS timeout_duration
  FROM feature_timeouts;

+----------+------------------+
| FEATURE  | TIMEOUT_DURATION |
|----------+------------------|
| Feature1 | +0:00:30         |
| Feature2 | +0:10:00         |
| Feature3 | +1:00:00         |
+----------+------------------+

Copie de données d’intervalle dans une table et interrogation de la table¶

Procédez comme suit pour mettre en zone de préparation un fichier avec des données d’intervalle, puis copiez le fichier dans une table :

1. Dans un fichier de votre système de fichiers, copiez le contenu suivant :

   Expand

   1,1-2,28 16:15:14.0
   2,-3-2,-54 16:15:14.123
   

   Show lessSee more

   Scroll to top

   Cet exemple suppose que le fichier est nommé interval_values.csv dans le répertoire /examples/intervals/.

2. Créez une zone de préparation :

   CopyExpand

   CREATE STAGE interval_stage;
   

   Show lessSee more

   Scroll to top

3. Dans l’emplacement de mise en zone de préparation interne, mettez le fichier en zone de préparation :

   CopyExpand

   PUT file:///examples/intervals/interval_values.csv @~/interval_stage
     AUTO_COMPRESS=false;
   

   Show lessSee more

   Scroll to top

4. Créez une table pour les données :

   CopyExpand

   CREATE OR REPLACE TABLE sample_interval_values(
     c1 STRING,
     c2 INTERVAL YEAR(1) TO MONTH,
     c3 INTERVAL DAY(2) TO SECOND(3));
   

   Show lessSee more

   Scroll to top

5. Pour charger le fichier en zone de préparation dans la table que vous avez créée, utilisez la commande COPY INTO <table> :

   CopyExpand

   COPY INTO sample_interval_values FROM @~/interval_stage;
   

   Show lessSee more

   Scroll to top

6. Pour afficher les données chargées, interrogez la table, puis convertissez les données en type VARCHAR pour afficher les données chargées :

   CopyExpand

   SELECT c1,
          c2::VARCHAR AS YEAR_TO_MONTH,
          c3::VARCHAR AS DAY_TO_SECOND,
     FROM sample_interval_values;
   

   Show lessSee more

   Scroll to top
   Expand

   +----+---------------+------------------+
   | C1 | YEAR_TO_MONTH | DAY_TO_SECOND    |
   |----+---------------+------------------|
   | 1  | +1-02         | +28 16:15:14.000 |
   | 2  | -3-02         | -54 16:15:14.123 |
   +----+---------------+------------------+
   

   Show lessSee more

   Scroll to top