カテゴリ：

半構造化データ関数と構造化データ関数 （型述語）

IS_TIMESTAMP_*

VARIANT 値にそれぞれの TIMESTAMP 値が含まれているかどうかを検証します。

  • IS_TIMESTAMP_LTZ （ローカルタイムゾーンのある値）。

  • IS_TIMESTAMP_NTZ （タイムゾーンのない値）。

  • IS_TIMESTAMP_TZ （タイムゾーンのある値）。

こちらもご参照ください。

IS_<オブジェクト型> , IS_DATE , IS_DATE_VALUE , IS_TIME

構文

IS_TIMESTAMP_LTZ( <variant_expr> )

IS_TIMESTAMP_NTZ( <variant_expr> )

IS_TIMESTAMP_TZ( <variant_expr> )
Copy

引数

variant_expr

VARIANT型の値に評価される式です。

戻り値

この関数は BOOLEAN型の値を返します。

例

VARIANT 列に TIMESTAMP_* 値をすべて表示し、セッションに指定されたタイムゾーンを使用して出力します。

注釈

タイムゾーンの出力形式はパラメーターを使用して設定します。

この例では、ローカルタイムゾーンは US 太平洋標準時（GMT/UCT に対して-08：00）です。

テーブルを作成してロードします。

CREATE OR REPLACE TABLE vardttm (v VARIANT);
Copy
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'));
Copy

データの TIMESTAMP 値を表示します。

SELECT * FROM vardttm WHERE IS_TIMESTAMP_NTZ(v);
Copy
+---------------------------+
| V                         |
|---------------------------|
| "2023-02-24 12:00:00.456" |
| "2021-02-24 14:00:00.123" |
+---------------------------+

SELECT * FROM vardttm WHERE IS_TIMESTAMP_LTZ(v);
Copy
+---------------------------------+
| V                               |
|---------------------------------|
| "2022-02-24 04:00:00.123 -0800" |
+---------------------------------+

SELECT * FROM vardttm WHERE IS_TIMESTAMP_TZ(v);
Copy
+---------------------------------+
| V                               |
|---------------------------------|
| "2020-02-24 15:00:00.123 +0100" |
+---------------------------------+
言語: 日本語