trunc 関数

  • [アーティクル]

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

書式モデル unit で指定された単位で切り詰められた日付を返します。

構文

trunc(expr, unit)

引数

  • expr: DATE 式。
  • unit: 切り詰める方法を指定する STRING 式。

戻り値

DATE 値。

メモ

fmt は次のいずれかにする必要があります (大文字と小文字は区別されません)。

  • 'YEAR'、'YYYY'、'YY' - 日付が含まれる年の最初の日付に切り詰めます。
  • 'QUARTER' - 日付が含まれる四半期の最初の日付に切り詰めます。
  • 'MONTH'、'MM'、'MON' - 日付が含まれる月の最初の日付に切り詰めます。
  • 'WEEK' - 日付が含まれる週の月曜日に切り詰めます。

fmt が整形式でない場合、この関数は NULL を返します。

例

> SELECT trunc('2019-08-04', 'week');
 2019-07-29

> SELECT trunc('2019-08-04', 'quarter');
 2019-07-01

> SELECT trunc('2009-02-12', 'MM');
 2009-02-01

> SELECT trunc('2015-10-27', 'YEAR');
 2015-01-01

-- 'JAHR' is not a recognized unit
> SELECT trunc('2015-10-27', 'JAHR');
 NULL