make_date 関数

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

yearmonthday の各フィールドから日付を作成します。

構文

make_date(year, month, day)

引数

  • year: 1 から 9999 までの値に評価される INTEGER 式。
  • month: 1 (1 月) から 12 (12 月) までの値に評価される INTEGER 式。
  • day: 1 から 31 までの値に評価される INTEGER 式。

戻り値

DATE 値。

Databricks SQL では、引数のいずれかが境界外の場合、結果は NULL になります。 Databricks Runtime では、引数のいずれかが範囲外の場合、Azure Databricksは < DATETIME_FIELD_OUT_OF_BOUNDS spark.sql.ansi.enabled でない限り、 を返します。

一般的なエラー状態

> SELECT make_date(2013, 7, 15);
 2013-07-15
> SELECT make_date(2019, 13, 1);
 NULL
> SELECT make_date(2019, 7, NULL);
 NULL
> SELECT make_date(2019, 2, 30);
 NULL

-- In DBR with ANSI mode, out-of-bounds fields raise an error.
> SELECT make_date(2024, 13, 1);
  Error: DATETIME_FIELD_OUT_OF_BOUNDS