メインコンテンツまでスキップ
バージョン: Stable-3.3

date_trunc

説明​

指定された日付部分（年、日、時間、分など）に基づいて時間値を切り捨てます。

StarRocks では、指定された日付部分を抽出するための年、四半期、月、週、日、時間の関数も提供しています。

構文​

DATETIME|DATE date_trunc(VARCHAR fmt, DATETIME|DATE datetime)

パラメータ​

  • datetime: 切り捨てる時間で、DATETIME または DATE 型である必要があります。日付と時間が存在しない場合、NULL が返されます。例えば、2021-02-29 11:12:13 は存在しない日付なので、NULL が返されます。

  • fmt: 日付部分、つまり datetime がどの精度に切り捨てられるかを指定します。値は VARCHAR 定数である必要があります。

    fmt は以下の表にリストされている値に設定する必要があります。値が間違っている場合、エラーが返されます。

    datetime が DATE 値の場合、fmt は year、quarter、month、week、または day のみ設定できます。他の日付単位、例えば hour に設定すると、エラーが報告されます。例8を参照してください。

値説明
microsecondマイクロ秒に切り捨てます (3.1.7以降)。
millisecondミリ秒に切り捨てます (3.1.7以降)。
second秒に切り捨てます。
minute分に切り捨てます。秒の部分はゼロになります。
hour時間に切り捨てます。分と秒の部分はゼロになります。
day日に切り捨てます。時間の部分はゼロになります。
weekdatetime が含まれる週の最初の日に切り捨てます。時間の部分はゼロになります。
monthdatetime が含まれる月の最初の日に切り捨てます。時間の部分はゼロになります。
quarterdatetime が含まれる四半期の最初の日に切り捨てます。時間の部分はゼロになります。
yeardatetime が含まれる年の最初の日に切り捨てます。時間の部分はゼロになります。

戻り値​

DATETIME または DATE 型の値を返します。

datetime が DATE 型で、fmt が hour、minute、または second に設定されている場合、返される値の時間部分はデフォルトで 00:00:00 になります。

例​

例1: 入力時間をマイクロ秒に切り捨てます。

select date_trunc('microsecond', '2023-10-31 23:59:59.001002');
+---------------------------------------------------------+
| date_trunc('microsecond', '2023-10-31 23:59:59.001002') |
+---------------------------------------------------------+
| 2023-10-31 23:59:59.001002                              |
+---------------------------------------------------------+

例2: 入力時間をミリ秒に切り捨てます。

select date_trunc('millisecond', '2023-10-31 23:59:59.001002');
+---------------------------------------------------------+
| date_trunc('millisecond', '2023-10-31 23:59:59.001002') |
+---------------------------------------------------------+
| 2023-10-31 23:59:59.001000                              |
+---------------------------------------------------------+

select date_trunc('millisecond', '2023-10-31');
+-----------------------------------------+
| date_trunc('millisecond', '2023-10-31') |
+-----------------------------------------+
| 2023-10-31 00:00:00                     |
+-----------------------------------------+

例3: 入力時間を分に切り捨てます。

select date_trunc('minute', '2023-11-04 23:59:59.001002');
+----------------------------------------------------+
| date_trunc('minute', '2023-11-04 23:59:59.001002') |
+----------------------------------------------------+
| 2023-11-04 23:59:00                                |
+----------------------------------------------------+

例4: 入力時間を時間に切り捨てます。

select date_trunc("hour", "2020-11-04 11:12:13");
+-------------------------------------------+
| date_trunc('hour', '2020-11-04 11:12:13') |
+-------------------------------------------+
| 2020-11-04 11:00:00                       |
+-------------------------------------------+

例5: 入力時間を週の最初の日に切り捨てます。

select date_trunc("week", "2020-11-04 11:12:13");
+-------------------------------------------+
| date_trunc('week', '2020-11-04 11:12:13') |
+-------------------------------------------+
| 2020-11-02 00:00:00                       |
+-------------------------------------------+

例6: 入力時間を四半期の最初の日に切り捨てます。

select date_trunc("quarter", "2020-11-04 11:12:13");
+----------------------------------------------+
| date_trunc('quarter', '2020-11-04 11:12:13') |
+----------------------------------------------+
| 2020-10-01 00:00:00                          |
+----------------------------------------------+

例7: 入力時間を年の最初の日に切り捨てます。

select date_trunc('year', '2023-11-04 23:59:59.001002');
+--------------------------------------------------+
| date_trunc('year', '2023-11-04 23:59:59.001002') |
+--------------------------------------------------+
| 2023-01-01 00:00:00                              |
+--------------------------------------------------+

例8: DATE 値を時間に切り捨てます。エラーが返されます。

select date_trunc("hour", cast("2020-11-04" as date));

ERROR 1064 (HY000): Getting analyzing error from line 1, column 26 to line 1, column 51. Detail message: date_trunc function can't support argument other than year|quarter|month|week|day.

例9: 入力日付を年の最初の日に切り捨てます。

select date_trunc("month", cast("2020-11-04" as date));
+-------------------------------------------------+
| date_trunc('month', CAST('2020-11-04' AS DATE)) |
+-------------------------------------------------+
| 2020-11-01                                      |
+-------------------------------------------------+