make_ym_interval 関数

適用対象: Databricks SQL Databricks Runtime 10.4 LTS 以降

years および months から年月の間隔を作成します。

構文

make_ym_interval( [ years [, months ] ] )

引数

• years: 正または負の整数の年数
• months: 正または負の整数の月数

戻り値

INTERVAL YEAR TO MONTH。

指定されていない引数の既定値は 0 です。 引数を指定しない場合、結果は INTERVAL '0-0' YEAR TO MONTH になります。

この関数は次の式を実行するのと同じです。

INTERVAL year YEARS + INTERVAL month MONTHS

そのため、各単位が自然な範囲を超え、負の値になる可能性があります。

例

> SELECT make_ym_interval(100, 5);
  100-5

> SELECT make_ym_interval(100, null);
  NULL

> SELECT make_ym_interval(0, 13);
  1-1

> SELECT make_ym_interval(1, -1);
  0-11

関連する関数

• make_dt_interval 関数
• make_date 関数
• make_timestamp 関数