Функция timestampadd

  • Статья

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

Добавляет объекты valueunit в метку времени expr.

Синтаксис

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