Wiki source code of Ввод динамического временного диапазона
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Для указания промежутка времени, за который строится отчёт, часто удобно использовать не фиксированное время начала и окончания, а время относительно текущего (динамический диапазон). При запуске такого отчёта, временной промежуток будет рассчитываться относительно текущего времени, данные будут выводится за разные периоды. | ||
| 2 | |||
| 3 | {{info}} | ||
| 4 | **ПОДСКАЗКА** | ||
| 5 | |||
| 6 | Для указания фиксированного времени можно использовать ручной ввод и [[элемент Календарь>>doc:ui.Инструменты.Элемент Календарь.WebHome]]. | ||
| 7 | {{/info}} | ||
| 8 | |||
| 9 | == {{id name="Вводдинамическоговременногодиапазона-Общиесведения"/}}Общие сведения == | ||
| 10 | |||
| 11 | Для ввода динамического временного диапазона, также как и статического, указывается точное время начала и окончания временного интервала. Однако в качестве точки начала и окончания используется не фиксированная дата/время, а такие понятия, как текущее время, текущий месяц/год, прошедшие несколько часов, несколько дней и проч. | ||
| 12 | |||
| 13 | Например, отчет может быть построен: | ||
| 14 | |||
| 15 | * за текущую неделю/месяц/год (с 00:00 начала периода); | ||
| 16 | * за последние несколько часов, дней и проч. (со сдвигом относительно текущего времени). | ||
| 17 | |||
| 18 | Заданный динамический диапазон, наряду с другими параметрами отчёта, может быть сохранён в шаблоне. Такие шаблоны особенно необходимы при [[автоматической рассылке отчётов по событию или расписанию>>doc:ui.Параметры узла.Автоматизация.WebHome]]. | ||
| 19 | |||
| 20 | При вызове отчёта по шаблону каждый раз рассчитывается, за какой промежуток требуется сформировать отчёт, вычисленный промежуток времени указывается в заголовке отчёта. | ||
| 21 | |||
| 22 | Перечень значений, которые можно установить для точек начала и окончания интервала приведён в таблице ниже. | ||
| 23 | |||
| 24 | |=((( | ||
| 25 | Значение | ||
| 26 | )))|=((( | ||
| 27 | Дополнительные параметры | ||
| 28 | )))|=((( | ||
| 29 | Комментарий | ||
| 30 | ))) | ||
| 31 | |((( | ||
| 32 | Фиксированное время | ||
| 33 | )))|((( | ||
| 34 | Точная дата/время | ||
| 35 | )))|((( | ||
| 36 | Можно ввести вручную в формате ДД:ММ:ГГГГ или задать с помощью [[элемента Календарь>>doc:ui.Инструменты.Элемент Календарь.WebHome]]. | ||
| 37 | ))) | ||
| 38 | |((( | ||
| 39 | Текущее время | ||
| 40 | )))|((( | ||
| 41 | – | ||
| 42 | )))|((( | ||
| 43 | Подставляется текущее системное время на узле Платформа НЕЙРОСС. | ||
| 44 | ))) | ||
| 45 | |((( | ||
| 46 | Время относительно текущего | ||
| 47 | )))|((( | ||
| 48 | * N часов назад; | ||
| 49 | * N дней назад; | ||
| 50 | * N недель назад; | ||
| 51 | * N месяцев назад, | ||
| 52 | |||
| 53 | где N - целое число | ||
| 54 | )))|((( | ||
| 55 | Указывается целое число и единица измерения для сдвига времени относительно текущего. | ||
| 56 | |||
| 57 | Например, если сегодня пятница 3 апреля 2020, время 15:45:00, то: | ||
| 58 | |||
| 59 | * 1 час назад — это пятница 3 апреля 14:45:00; | ||
| 60 | * 1 дней назад — это четверг 2 апреля 14:45:00; | ||
| 61 | * 1 неделя назад — это пятница 27 марта 14:45:00; | ||
| 62 | * 1 месяц назад — это вторник 3 марта 14:45:00. | ||
| 63 | ))) | ||
| 64 | |((( | ||
| 65 | Начало периода | ||
| 66 | )))|((( | ||
| 67 | * Текущий день; | ||
| 68 | * Текущая неделя; | ||
| 69 | * Текущий месяц; | ||
| 70 | * Текущий год. | ||
| 71 | )))|((( | ||
| 72 | Задаёт точку начала (00:00:00) текущего периода. | ||
| 73 | |||
| 74 | Например, если сегодня пятница 3 апреля 2020, время 15:45:00, то: | ||
| 75 | |||
| 76 | * Текущий день — пятница 3 апреля 00:00:00; | ||
| 77 | * Текущая неделя — это понедельник 30 марта 00:00:00; | ||
| 78 | * Текущий месяц — это среда 1 апреля 00:00:00; | ||
| 79 | * Текущий год — это среда 1 января 00:00:00. | ||
| 80 | ))) | ||
| 81 | |||
| 82 | == {{id name="Вводдинамическоговременногодиапазона-Примерыиспользования"/}}Примеры использования(%%) == | ||
| 83 | |||
| 84 | === {{id name="Вводдинамическоговременногодиапазона-Затекущуюнеделю"/}}За текущую неделю(%%) === | ||
| 85 | |||
| 86 | Установите временной промежуток согласно значениям на рисунке и в таблице ниже. | ||
| 87 | [[image:attach:reports_dates1.png||height="110"]]\\ | ||
| 88 | |||
| 89 | |=((( | ||
| 90 | Параметр | ||
| 91 | )))|=((( | ||
| 92 | Значение | ||
| 93 | )))|=((( | ||
| 94 | Комментарий | ||
| 95 | ))) | ||
| 96 | |((( | ||
| 97 | Начало временного интервала | ||
| 98 | )))|((( | ||
| 99 | Начало периода → Текущая неделя | ||
| 100 | )))|(% rowspan="2" %)((( | ||
| 101 | Отчёт строится с 00:00 часов понедельника текущей недели до текущего времени. Если отчёт вызван в среду в середине дня, то до этого времени. При необходимости строить отчёт за всю неделю целиком, необходимо вызвать отчёт в воскресенье в 23:59:59. Это можно сделать с помощью задания автоматизации. | ||
| 102 | ))) | ||
| 103 | |((( | ||
| 104 | Конец временного интервала | ||
| 105 | )))|((( | ||
| 106 | Текущее время | ||
| 107 | ))) | ||
| 108 | |||
| 109 | Аналогично можно создать шаблон отчета за текущий день и вызывать его по расписанию каждый день в 23:59:59. | ||
| 110 | |||
| 111 | === {{id name="Вводдинамическоговременногодиапазона-Запоследниймесяц"/}}За последний месяц === | ||
| 112 | |||
| 113 | Установите временной промежуток согласно значениям на рисунке и в таблице ниже. | ||
| 114 | [[image:attach:reports_dates2.png||height="111"]]\\ | ||
| 115 | |||
| 116 | |=((( | ||
| 117 | Параметр | ||
| 118 | )))|=((( | ||
| 119 | Значение | ||
| 120 | )))|=((( | ||
| 121 | Комментарий | ||
| 122 | ))) | ||
| 123 | |((( | ||
| 124 | Начало временного интервала | ||
| 125 | )))|((( | ||
| 126 | Время относительно текущего → 1 месяц назад | ||
| 127 | )))|(% rowspan="2" %)((( | ||
| 128 | Отчёт строится за сегодняшнюю дату/время со сдвигом в один месяц. Если отчёт вызван в 7 апреля в 15:45:00, то интервал для построения отчёта будет с 7 марта 15:45:00 по 7 апреля 15:45:00. При необходимости строить отчёт за месяц целиком, необходимо вызвать отчёт 1 числа месяца в 00:00:00. Это можно сделать с помощью задания автоматизации. | ||
| 129 | ))) | ||
| 130 | |((( | ||
| 131 | Конец временного интервала | ||
| 132 | )))|((( | ||
| 133 | Текущее время | ||
| 134 | ))) | ||
| 135 | |||
| 136 | Аналогично можно создать шаблон отчёта за последний час/несколько часов, дней, недель, месяцев. |