Поделиться через

Функция dateadd

  • Статья

Область применения: флажок Databricks SQL флажок Databricks Runtime 10.4 LTS и выше

Добавляет value units к метке exprвремени. Эта функция является синонимом функции timestampadd.

Синтаксис

dateadd(unit, value, expr)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR |
   DAY | DAYOFYEAR |
   WEEK |
   MONTH |
   QUARTER |
   YEAR }

Аргументы

  • unit: единица измерения.
  • value: числовое выражение количества добавляемых объектов unit в expr.
  • expr: выражение TIMESTAMP.

Возвраты

Значение TIMESTAMP.

Если value имеет отрицательное значение, оно вычитается из expr. Если unit имеет значение MONTH, QUARTER или YEAR, часть дня в полученных данных будет изменена таким образом, чтобы дата была указана правильно.

Функция возвращает ошибку переполнения, если результат выходит за пределы поддерживаемого диапазона меток времени.

Примеры

> SELECT dateadd(MICROSECOND, 5, TIMESTAMP'2022-02-28 00:00:00');
 2022-02-28 00:00:00.000005

-- March 31. 2022 minus 1 month yields February 28. 2022
> SELECT dateadd(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000