ClickHouse/docs/ru/data_types/special_data_types/interval.md
BayoNet fe926f3c06
DOCS-163: INTERVAL. EN review, RU translation for #7452 (#7740)
* Update operators.md (#70)

* Update operators.md (#71)

* CLICKHOUSEDOCS-163: EN review, RU translation.

* CLICKHOUSEDOCS-163: Fix

* Update docs/ru/data_types/special_data_types/interval.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* Update docs/ru/query_language/operators.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* Update docs/ru/data_types/special_data_types/interval.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* CLICKHOUSEDOCS-163: Clarification.
2019-12-06 15:22:55 +03:00

3.9 KiB
Raw Blame History

Interval

Семейство типов данных, представляющих интервалы дат и времени. Оператор INTERVAL возвращает значения этих типов.

!!! warning "Внимание" Нельзя использовать типы данных Interval для хранения данных в таблице.

Структура:

  • Интервал времени в виде положительного целого числа.
  • Тип интервала.

Поддержанные типы интервалов:

  • SECOND
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
  • YEAR

Каждому типу интервала соответствует отдельный тип данных. Например, тип данных IntervalDay соответствует интервалу DAY:

SELECT toTypeName(INTERVAL 4 DAY)
┌─toTypeName(toIntervalDay(4))─┐
│ IntervalDay                  │
└──────────────────────────────┘

Использование

Значения типов Interval можно использовать в арифметических операциях со значениями типов Date и DateTime. Например, можно добавить 4 дня к текущей дате:

SELECT now() as current_date_time, current_date_time + INTERVAL 4 DAY
┌───current_date_time─┬─plus(now(), toIntervalDay(4))─┐
│ 2019-10-23 10:58:45 │           2019-10-27 10:58:45 │
└─────────────────────┴───────────────────────────────┘

Нельзя объединять интервалы различных типов. Нельзя использовать интервалы вида 4 DAY 1 HOUR. Вместо этого выражайте интервал в единицах меньших или равных минимальной единице интервала, например, интервал "1 день и 1 час" можно выразить как 25 HOUR или 90000 SECOND.

Арифметические операции со значениями типов Interval не доступны, однако можно последовательно добавлять различные интервалы к значениям типов Date и DateTime. Например:

SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY + INTERVAL 3 HOUR
┌───current_date_time─┬─plus(plus(now(), toIntervalDay(4)), toIntervalHour(3))─┐
│ 2019-10-23 11:16:28 │                                    2019-10-27 14:16:28 │
└─────────────────────┴────────────────────────────────────────────────────────┘

Следующий запрос приведёт к генерированию исключения:

select now() AS current_date_time, current_date_time + (INTERVAL 4 DAY + INTERVAL 3 HOUR)
Received exception from server (version 19.14.1):
Code: 43. DB::Exception: Received from localhost:9000. DB::Exception: Wrong argument types for function plus: if one argument is Interval, then another must be Date or DateTime.. 

Смотрите также