Datentypen für Datum und Uhrzeit¶

Intervall-Literale¶

Ein Intervall-Literal ist ein Ausdruck, der eine Zeitdauer in einem Zeichenfolgenliteral angibt. Verwenden Sie die folgende Syntax, um ein Intervall-Literal anzugeben:

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

Wobei:

• sign ist ein optionales Symbol, das eine positive (+) oder negative (-) Zeitdauer angibt.

  Standard: +.

• string ist ein Wert, der eine Zeitdauer repräsentiert.

• yearMonthQualifier ist ein Qualifizierer, der in Syntax von Intervall-Datentypen definiert ist.

• dayTimeQualifier ist ein Qualifizierer, der in Syntax von Intervall-Datentypen definiert ist.

Intervallformate¶

Zeichenfolgenliterale in bestimmten Formaten können Intervallwerte darstellen.

Um Werte für Jahre und Monate anzugeben, verwenden Sie das folgende Format:

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

Wobei:

• sign ist ein erforderliches Symbol, das eine positive (+) oder negative (-) Zeitdauer angibt.

  Standard: +.

• Y ist die Anzahl der Jahre. Die Anzahl der zulässigen Stellen (Genauigkeit) hängt vom Datentyp des Wertes ab.

• MM sind zwei Ziffern für die Anzahl der Monate, von 00 bis``11``.

Um Werte für Tage, Stunden, Sekunden und Sekundenbruchteile anzugeben, verwenden Sie das folgende Format:

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

Wobei:

• sign ist ein erforderliches Symbol, das eine positive (+) oder negative (-) Zeitdauer angibt.

  Standard: +.

• D ist die Anzahl der Tage. Die Anzahl der zulässigen Stellen (Genauigkeit) hängt vom Datentyp des Wertes ab.

  Lassen Sie D für Werte der folgenden Typen weg:

  • INTERVAL-HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL HOUR TO SECOND

  • INTERVAL-MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL-SECOND

• HH24 sind zwei Ziffern für die Anzahl der Stunden, von 00 bis 23.

  Lassen Sie HH24 für Werte der folgenden Typen weg:

  • INTERVAL-DAY

  • INTERVAL-MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL-SECOND

• MI sind zwei Ziffern für die Anzahl der Minuten, von 00 bis``59``.

  Lassen Sie MI für Werte der folgenden Typen weg:

  • INTERVAL DAY TO HOUR

  • INTERVAL-DAY

  • INTERVAL-HOUR

  • INTERVAL-SECOND

• SS sind zwei Ziffern für die Anzahl der Sekunden, von 00 bis``59``.

  Lassen Sie SS für Werte der folgenden Typen weg:

  • INTERVAL-DAY

  • INTERVAL DAY TO HOUR

  • INTERVAL DAY TO MINUTE

  • INTERVAL-HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL-MINUTE

• F ist die Anzahl der Sekundenbruchteile für die Datentypen, die Sekunden enthalten. Die Anzahl der zulässigen Stellen (Genauigkeit) hängt vom Datentyp des Wertes ab.

Die folgenden Nutzungshinweise gelten für Zeichenfolgenliterale im Intervallformat:

• Die Darstellung des Zeichenfolgenliterals gilt, wenn Sie die Funktion CAST oderTO_CHAR verwenden, um Intervalle explizit in Textzeichenfolgen umzuwandeln.

• Führende Nullen in einem Feld geben die Genauigkeit an.

Beispiele für Intervallwerte¶

Die folgende Tabelle zeigt, wie Sie verschiedene Intervallwerte darstellen können. Die in der Tabelle angezeigten Werte entsprechen den folgenden Regeln für Intervallwerte:

• Bei positiven Werten ist das Pluszeichen:code:+ optional für Intervall-Literalwerte, aber erforderlich für Intervallformatwerte.

• In den Intervall-Literalwerten gibt der Wert in Klammern die Genauigkeit an, d. h. die Anzahl der zulässigen Stellen. Beispiel: YEAR(3) legt fest, dass drei Ziffern für das Jahr zulässig sind.

• In den Intervallformatwerten enthält das primäre Feld (das führende Feld) keine führenden Nullen. Untergeordnete Felder verwenden eine feste Anzahl von Ziffern. Beispiel: In einem YEAR TO MONTH-Wert wie +1-08 enthält das Jahresfeld keine führenden Nullen, und das Monatsfeld verwendet zwei Ziffern.

Durchführen von Arithmetik unter Verwendung von Intervalldaten¶

Die folgenden Beispiele führen Arithmetik unter Verwendung von Intervalldaten aus.

Hinzufügen von einem Jahr und einem Monats zu einem Datum:

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                   |
+------------------------------+

Abziehen von einem Jahr und einem Monat von einem Datum:

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                   |
+------------------------------+

Hinzufügen von einem bestimmten Zeitraum zu einem Zeitstempel:

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  |
+--------------------------+

Im folgenden Beispiel wird die Funktion :doc:`/sql-reference/functions/system_typeof`verwendet, um zu zeigen, dass ein INTERVAL DAY TO SECOND-Wert zurückgegeben wird, wenn eine Abfrage zwei Zeitstempelwerte abzieht:

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] |
+------------------------------------+

Um die Ergebnisse der Abfrage im Intervallformat anzuzeigen, können Sie den Ausdruck in den Datentyp INTERVAL DAY(2) TO SECOND(2) umwandeln, um die Genauigkeit anzugeben, und dann in VARCHAR umwandeln:

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        |
+------------------------+

Einfügen und Abfragen von Jahr-Monat-Intervalldaten¶

Erstellen Sie eine Tabelle, die Kandidaten für offene Stellen mit einer INTERVAL YEAR TO MONTH-Spalte verfolgt, und fügen Sie Daten ein:

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');

Wenn Sie die Tabelle abfragen, ohne die duration_of_experience`-Spalte in einen Datentyp umzuwandeln, enthält die Ausgabe die Werte der Spalte als Gesamtzahl der Monate in jeder Zeile:

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 |
+------------+-----------+----------------------+

Wenn Sie die Tabelle abfragen und die duration_of_experience-Spalte in den VARCHAR-Datentyp umwandeln, zeigt die Ausgabe die Spaltenwerte im Intervallformat an:

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                  |
+------------+-----------+------------------------+

Einfügen und Abfragen von Tag-Uhrzeit-Intervalldaten¶

Erstellen Sie eine Tabelle, die die Timeout-Dauer für verschiedene Software-Features mit einer INTERVAL HOUR TO SECOND-Spalte angibt, und fügen Sie Daten ein:

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');

Fragen Sie die Tabelle ab, und wandeln Sie die timeout_duration-Spalte in den VARCHAR-Datentyp um:

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         |
+----------+------------------+

Kopieren von Intervalldaten in eine Tabelle und Abfragen der Tabelle¶

Führen Sie die folgenden Schritte aus, um eine Datei mit Intervalldaten bereitzustellen, und kopieren Sie die Datei dann in eine Tabelle:

1. Kopieren Sie den folgenden Inhalt in eine Datei in Ihrem Dateisystem:

   Expand

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

   Show lessSee more

   Scroll to top

   In diesem Beispiel wird davon ausgegangen, dass die Datei interval_values.csv heißt und sich im Verzeichnis /examples/intervals/ befindet.

2. Erstellen Sie einen Stagingbereich:

   CopyExpand

   CREATE STAGE interval_stage;
   

   Show lessSee more

   Scroll to top

3. Stellen Sie die Datei im internen Staging-Speicherort bereit:

   CopyExpand

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

   Show lessSee more

   Scroll to top

4. Erstellen Sie eine Tabelle für die Daten:

   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. Um die Stagingdatei in die von Ihnen erstellte Tabelle zu laden, verwenden Sie den Befehl COPY INTO <Tabelle>:

   CopyExpand

   COPY INTO sample_interval_values FROM @~/interval_stage;
   

   Show lessSee more

   Scroll to top

6. Um die geladenen Daten anzuzeigen, fragen Sie die Tabelle ab und wandeln Sie sie in den VARCHAR-Typ um:

   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