Функция date_add

  • Статья

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

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

Синтаксис

date_add(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 date_add(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 date_add(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000