DATEADD

Синтаксис

DATEADD( datetime [ , unit [ , number ] ] )

Описание

Возвращает дату, полученную в результате добавления unit в количестве number к указанной дате datetime.

Аргумент number задается целым числом. Может принимать отрицательные значения.
Аргумент unit принимает следующие значения:

  • "year" — год;
  • "month" — месяц;
  • "day" — день;
  • "hour" — час;
  • "minute" — минута;
  • "second" — секунда.

Типы аргументов:

  • datetimeДата | Дата и время
  • unitЦелое число | Строка
  • numberЦелое число

Возвращаемый тип: Совпадает с типом аргументов (datetime)

Примечание

Значения аргументов (unit) должны быть константами.

Примечание

Для всех источников, кроме ClickHouse, аргумент number принимает только константные значения.

Примеры

DATEADD(#2018-01-12#, "day", 6) = #2018-01-18#
DATEADD(#2018-01-12#, "month", 6) = #2018-07-12#
DATEADD(#2018-01-12#, "year", 6) = #2024-01-12#
DATEADD(#2018-01-12 01:02:03#, "second", 6) = #2018-01-12 01:02:09#
DATEADD(#2018-01-12 01:02:03#, "minute", 6) = #2018-01-12 01:08:03#
DATEADD(#2018-01-12 01:02:03#, "hour", 6) = #2018-01-12 07:02:03#
DATEADD(#2018-01-12 01:02:03#, "day", 6) = #2018-01-18 01:02:03#
DATEADD(#2018-01-12 01:02:03#, "month", 6) = #2018-07-12 01:02:03#
DATEADD(#2018-01-12 01:02:03#, "year", 6) = #2024-01-12 01:02:03#

Поддержка источников данных

ClickHouse 21.8, Yandex Metrica, Microsoft SQL Server 2017 (14.0), MySQL 5.7, Oracle Database 12c (12.1), PostgreSQL 9.3, YDB.

Previous