- Kategorien:
Funktionen für semistrukturierte und strukturierte Daten (Typprädikate)
IS_TIME¶
Überprüft, ob ein VARIANT-Argument einen TIME-Wert enthält.
- Siehe auch:
Syntax¶
IS_TIME( <variant_expr> )
Argumente¶
variant_expr
Ein Ausdruck, der einen Wert vom Typ VARIANT ergibt.
Rückgabewerte¶
Gibt einen BOOLEAN Wert oder NULL zurück.
Gibt TRUE zurück, wenn der VARIANT-Wert einen TIME-Wert enthält. Andernfalls wird FALSE zurückgegeben.
Wenn die Eingabe NULL ist, wird NULL ohne Meldung eines Fehlers zurückgegeben.
Beispiele¶
Gibt alle TIME-Werte in einer VARIANT-Spalte zurück.
Bemerkung
Das Ausgabeformat für die TIME-Werte wird mit dem Parameter TIME_OUTPUT_FORMAT festgelegt. Die Standardeinstellung ist HH24:MI:SS
.
Erstellen und laden Sie eine Tabelle mit verschiedenen Datums- und TIME-Werten in einer VARIANT-Spalte:
CREATE OR REPLACE TABLE vardttm (v VARIANT);
INSERT INTO vardttm SELECT TO_VARIANT(TO_DATE('2024-02-24'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIME('20:57:01.123456789+07:00'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP('2023-02-24 12:00:00.456'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP_LTZ('2022-02-24 13:00:00.123 +01:00'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP_NTZ('2021-02-24 14:00:00.123 +01:00'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP_TZ('2020-02-24 15:00:00.123 +01:00'));
Verwenden Sie die Funktion TYPEOF in einer Abfrage, um die Datentypen der in der VARIANT-Spalte gespeicherten Werte v
anzuzeigen:
SELECT v, TYPEOF(v) AS type FROM vardttm;
+---------------------------------+---------------+
| V | TYPE |
|---------------------------------+---------------|
| "2024-02-24" | DATE |
| "20:57:01" | TIME |
| "2023-02-24 12:00:00.456" | TIMESTAMP_NTZ |
| "2022-02-24 04:00:00.123 -0800" | TIMESTAMP_LTZ |
| "2021-02-24 14:00:00.123" | TIMESTAMP_NTZ |
| "2020-02-24 15:00:00.123 +0100" | TIMESTAMP_TZ |
+---------------------------------+---------------+
Zeigen Sie die TIME-Werte in den Daten an, indem Sie die Funktion IS_TIME in einer WHERE-Klausel verwenden. In der Ausgabe wird nur der TIME-Wert zurückgegeben. Die DATE- und TIMESTAMP-Werte werden nicht zurückgegeben.
SELECT v FROM vardttm WHERE IS_TIME(v);
+------------+
| V |
|------------|
| "20:57:01" |
+------------+