Documentation
Table of Contents
13. Селектор периода времени
Обзор
Селектор Период времени (Time period) позволяет выбрать наиболее популярные периоды одним щелчком мыши. Его можно раскрыть или свернуть щелчком мыши по вкладке Период времени (Time period) в правом верхнем углу.
Такие опции как Сегодня (Today), Эта неделя (This week) и т.п. отображают весь период, включая ещё не наступившие дни/часы. Такие опции как Сегодня до сих пор (Today so far), На этой неделе (This week so far) и т.п. отображают только прошедшие часы.
После выбора периода, его можно перемещать назад и вперёд во времени при помощи кнопок стрелок 
. Кнопка Расширить (Zoom out) позволяет раздвинуть масштаб на 50% в каждую сторону.
Для графиков отображаемый период времени также можно выбрать, выделяя область на графике левой кнопкой мыши. При отпускании левой кнопки мыши график приблизит масштаб по выделенной области. Отдаление масштаба также можно выполнить двойным щелчком в графике.
Поля От/К (From/To) отображают выбранный период либо в синтаксисе абсолютного времени (в формате Y-m-d H:i:s), либо в синтаксисе относительного времени. Период относительного времени может содержать одну или несколько математических операций (- или +), например: now-1d или now-1d-2h+5m.
Для относительного времени поддерживаются следующие сокращения:
nows(секунды)m(минуты)h(часы)d(дни)w(недели)M(месяцы)y(года)
Точность поддерживается в селекторе времени Период времени (Time period) (например, /M в now-1d/M). Детали касательно точности:
| Точность | От | До |
|---|---|---|
m |
Y-m-d H:m:00 | Y-m-d H:m:59 |
h |
Y-m-d H:00:00 | Y-m-d H:59:59 |
d |
Y-m-d 00:00:00 | Y-m-d 23:59:59 |
w |
Понедельник недели 00:00:00 | Воскресенье недели 23:59:59 |
M |
Первый день месяца 00:00:00 | Последний день месяца 23:59:59 |
y |
1 Января года 00:00:00 | 31 Декабря года 23:59:59 |
Период времени также можно выбрать, используя Элемент выбора даты (Date picker). Чтобы его открыть, щёлкните мышью по значку календаря возле полей От/К (From/To).
В пределах элемента выбора даты можно перемещаться между годом/месяцем/датой, используя Tab, Shift+Tab и кнопки стрелок клавиатуры. Нажатие Enter подтверждает выбор.
Примеры
| От | До | Выбранный период |
|---|---|---|
now/d |
now/d |
00:00 — 23:59 сегодня |
now/d |
now/d+1d |
00:00 сегодня — 23:59 завтра |
now/w |
now/w |
Понедельник 00:00:00 — Воскресенье 23:59:59 текущей недели |
now-1y/w |
now-1y/w |
Неделя с понедельника 00:00:00 по воскресенье 23:59:59 годом ранее |
Использование «now/M+1M» для параметра До (To) может добавить 31 день, что может привести к смещению даты на 1-3 дня в зависимости от количества дней в месяце. Например, если использовать в январе, результатом может быть 02 марта вместо ожидаемого 28 февраля. Чтобы избежать этой проблемы, используйте «now/M-3d+1M/M», что точно подстраивается под длину месяца. Аналогично, если настраиваете От (From) для перехода назад, используйте «now/M+3d-1M/M».