Связаться с намиПодключиться

DATEADD

Статья создана
Улучшена
Обновлена 6 ноября 2024 г.

Синтаксис

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, Файлы, Google Sheets, Yandex Metrica, Microsoft SQL Server 2017 (14.0), MySQL 5.7, Oracle Database 12c (12.1), PostgreSQL 9.3, Яндекс Документы, YDB.

Предыдущая
Обзор
Следующая
DATEPART