Итерировать время (Инструменты модели)

Краткая информация

Выполняет итерацию по времени в поле даты.

Более подробно о том, как работает инструмент Итерировать время в ModelBuilder

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

Этот инструмент доступен только в ModelBuilder для использования в моделях. Этот инструмент недоступен в панели Геообработка или в Python.
Инструмент принимает объекты и таблицы с полем даты.
Инструмент итерирует и фильтрует строки, находящиеся в разных временных интервалах и временных экстентах. Например, можно итерировать данные по часам для полного временного экстента данных или поднабора данных. Инструмент создает различные временные срезы, которые можно использовать в качестве входных данных в других инструментах.
Используйте параметр Определение времени, чтобы отфильтровать строки для конкретного месяца или дней недели. Например, если вы итерируете данные по неделям, со значением Интервала временного шага 1 неделя, и если для Определения времени установлено Суббота или Воскресенье, каждый временной срез возвращает данные только для субботы и воскресенья.

Используйте параметр Поднабор для создания одного или нескольких поднаборов в каждом временном срезе. В таблице ниже показаны примеры различных значений для опций Задержка поднабора и Продолжительность поднабора при временном срезе с 1‑го января 2022 года, 1.00 (2022-01-01 01:00:00) до 2‑го января 2022 года, 1.00 (2022-01-02 01:00:00). Числа в столбце Случай соответствуют числам на изображении под таблицей.


Случай	Значение поднабора	Результат
	Задержка поднабора: 2 часа Продолжительность поднабора: 2 часа	Будут возвращены данные с 3.00 (2022-01-01 00:03:00) до 5.00 (2022-01-01 00:05:00).
	Задержка поднабора: 2 часа Продолжительность поднабора: 2 часа Задержка поднабора: 8 часов Продолжительность поднабора: 4 часа	Будут возвращены данные с 3.00 (2022-01-01 00:03:00) до 5.00 (2022-01-01 00:05:00), и с 9.00 (2022-01-01 00:09:00) до 13.00 (2022-01-01 00:13:00).
	Задержка поднабора: 2 часа Продолжительность поднабора: Нет	Будут возвращены данные с 3.00 (2022-01-01 00:03:00) до 13.00 следующего дня (2022-01-02 00:01:00).
	Задержка поднабора: 2 часа Продолжительность поднабора: 0 часов	Будут возвращены данные с 3.00 (2022-01-01 00:03:00).

Примеры поднаборов при итерации времени

Используйте параметры Время начала итерации и Время окончания итерации, чтобы создать временные срезы из временного подмножества данных.
Используйте параметры Привязать время начала итерации к данным и Привязать время окончания итерации к данным вместе с параметрами Время начала итерации и Время окончания итерации, чтобы совместить начало и конец итерации с ближайшим значением даты и времени в данных.

Начало и окончание временных срезов вычисляются на основе комбинации значений параметров. В таблице ниже показаны ожидаемые результаты при использовании различных комбинаций параметров со снятой отметкой для параметра Пропустить пустые срезы. Например, экстент данных - с 2022-01-03 по 2022-01-31. С интервалом в один день, если значения параметров Время начала итерации и Время окончания итерации не указаны, первый временной срез начнется с 2022-01-03 на основе начала данных и закончится 2022-02-01.


Время начала итерации	Привязать дату и время начала итерации к данным	Время окончания итерации	Привязать дату и время окончания итерации к данным	Начало первого временного среза	Окончание последнего временного среза
				2022-01-03	2022-02-01
2022-01-01	Не отмечено			2022-01-01	2022-02-01
2022-01-01	Отмечено			2022-01-03	2022-02-01
		2022-02-01	Не отмечено	2022-01-03	2022-02-01
		2022-02-01	Отмечено	2022-01-03	2022-01-31
2022-01-01	Не отмечено	2022-02-01	Не отмечено	2022-01-01	2022-02-01
2022-01-01	Отмечено	2022-02-01	Не отмечено	2022-01-03	2022-02-01
2022-01-01	Не отмечено	2022-02-01	Отмечено	2022-01-01	2022-01-31
2022-01-01	Отмечено	2022-02-01	Отмечено	2022-01-03	2022-01-31

Параметр Включить начало всегда учитывается для первого временного среза, а параметр Включить окончание всегда учитывается для последнего временного среза независимо от значений параметров Включить начало и Включить окончание. Для каждого промежуточного временного среза включение или исключение данных основано на значениях этих параметров. Например, в таблице ниже показан ожидаемый результат подсчета с интервалом в 1 день для итераций с 2022-01-01 по 2022-01-03, если данные имеют значения с 2022-01-01 по 2022-01-03.


Временной срез	Подсчет с обоими параметрами не отмеченными	Подсчет только с отмеченным параметром Включить начало	Подсчет только с отмеченным параметром Включить окончание	Подсчет с обоими параметрами отмеченными
2022-01-01 по 2022-01-02	1	1	2 (Включить начало всегда учитывается для первого временного среза)	2
2022-01-02 по 2022-01-03	0	1	1	2
2022-01-03 по 2022-01-04	0	1	0	1

Параметр Поднабор учитывает настройки включения в параметрах Включить начало и Включить окончание.

Если в параметрах Время начала итерации и Время окончания итерации используется одно и то же поле, строки с пустыми значениями будут пропущены так как они не попадают во какой-либо временной экстент.

Если для параметров Время начала итерации и Время окончания итерации используются разные поля, строки с пустыми значениями будут пропущены по умолчанию. Снимите отметку Пропустить пустые значения, чтобы включить их в итерацию. В приведенных ниже таблицах показано, будет ли строка включена для выходных временных срезов с интервалом в 1 день с 2022-01-01 по 2022-01-03 и отмеченным параметром Включить начало.

Например, в следующей таблице строка имеет пустое значение в поле времени начала, а значение поля времени окончания — 2022-01-02:


Временной срез	Ожидаемый результат
2022-01-01 по 2022-01-02	Включена (поскольку пустое значение строки в поле начала)
2022-01-02 по 2022-01-03	Включена (поскольку параметр Включить начало отмечен)
2022-01-03 по 2022-01-04	Не включено

Например, в следующей таблице строка имеет значение 2022-01-02 в поле времени начала, а значение в поле времени окончания пустое:


Временной срез	Ожидаемый результат
2022-01-01 по 2022-01-02	Не включено
2022-01-02 по 2022-01-03	Включена (поскольку пустое значение строки в поле окончания)
2022-01-03 по 2022-01-04	Включена (поскольку пустое значение строки в поле окончания)

Если строка имеет пустые значения и в поле времени начала и в поле времени окончания, строка будет включена в каждый выходной срез времени.

Снимите отметку для Пропустить пустые срезы, чтобы в выходных данных отображались все временные срезы, включая те, в которых число строк равно нулю. По умолчанию пустые срезы будут скрыты.
Для каждой итерации инструмент возвращает следующие результаты:
- Выходной слой —слой с выбранными строками, соответствующими критериям временного среза
- Время начала —время начала для каждого временного среза
- Время окончания —время окончания для каждого временного среза
- Количество —количество строк в каждом временном срезе
Два выходных параметра, Время начала и Время окончания, имеют 24-часовой формат. Если время не указано ни в данных, ни в каких-либо значениях параметров, время по умолчанию равно 00:00:00.
Значения параметров Время начала и Время окончания можно использовать в качестве замены встроенных переменных для определения имен выходных данных в других инструментах. Для этого отметьте параметр Форматировать выходную строку времени, чтобы вернуть строку даты и времени без специальных символов, как в примере ниже.

Время всегда добавляется к строкам времени начала и окончания. Чтобы удалить время из этой строки, используйте инструмент Вычислить значение и задайте выражение "%Start Time%"[:11] + "_to_" + "%End Time%"[:11]. Результат работы инструмента Вычислить значение затем можно использовать в качестве встроенной переменной в имени результата работы инструмента Копировать объекты.

Параметры

Dialog

Подпись	Объяснение	Тип данных
Входная таблица	Входная таблица, по которой будет производиться итерация.	Table View; Feature Layer
Определение времени (Дополнительный)	Определяет фильтр, который будет применен к данным. Нет–Фильтр применяться не будет. Дни недели–Данные будут отфильтрованы с использованием значения параметра Дни. Месяцы–Данные будут отфильтрованы с использованием значения параметра Месяцы.	String
Месяцы (Дополнительный)	Указывает месяц, который будет использован для фильтра данных. Этот параметр активен, если для значения параметра Определение времени установлено Месяцы. Январь–Будут возвращены данные за Январь. Февраль–Будут возвращены данные за Февраль. Март–Будут возвращены данные за Март. Апрель–Будут возвращены данные за Апрель. Май–Будут возвращены данные за Май. Июнь–Будут возвращены данные за Июнь. Июль–Будут возвращены данные за Июль. Август–Будут возвращены данные за Август. Сентябрь–Будут возвращены данные за Сентябрь. Октябрь–Будут возвращены данные за Октябрь. Ноябрь–Будут возвращены данные за Ноябрь. Декабрь–Будут возвращены данные за Декабрь.	String
Дни (Дополнительный)	Указывает день недели, который будет использован для фильтра данных. Этот параметр активен, если для значения параметра Определение времени установлено Дни. Понедельник–Будут возвращены данные за Понедельник. Вторник–Будут возвращены данные за Вторник. Среда–Будут возвращены данные за Среду. Четверг–Будут возвращены данные за Четверг. Пятница–Будут возвращены данные за Пятница. Суббота–Будут возвращены данные за Субботу. Воскресенье–Будут возвращены данные за Воскресенье.	String
Интервал шкалы времени	Временной интервал, который будет использоваться для создания временных срезов. Допустимыми входными данными являются только целые числа.	Time Unit
Поднабор (Дополнительный)	Один или несколько временных поднаборов в каждой итерации. Каждый поднабор определяется парой значений Задержка поднабора и Продолжительность поднабора. Время начала каждого временного среза сдвигается на величину Задержки поднабора, а временной диапазон среза определяется значением Продолжительности поднабора. Например, временной срез определен между 1-м января 2022 года, 1:00 (2022-01-01 01:00:00) и 2-м января 2022 года, 1:00 (2022-01-02 01:00:00) со значением Задержка поднабора - 2 часа. Если Продолжительность поднабора - 2 часа, временной срез начнется в 3:00 (2022-01-01 00:03:00) и закончится в 5:00 (2022-01-01 00:05:00). Если значение Продолжительность поднабора пустое, временной срез начнется в 3:00 (2022-01-01 00:03:00) и закончится в 1:00 следующего дня (2022-01-02 00:05:00). Если Продолжительность поднабора - 0, будут возвращены данные только на 3:00 (2022-01-01 00:03:00). Столбцы таблицы значений: Subset Delay–The offset from the start of each temporal slice. Subset Duration–The temporal range of the slice.	Value Table
Поле времени начала	Поле, которое будет использоваться для определения временного экстента (или начала временного экстента) и запроса для создания временных срезов. Это поле может иметь тип Дата, Только дата или Только время в зависимости от единицы измерения времени, используемой для итерации по набору данных. Временной экстент можно изменить, указав другое значение даты и времени в параметре Время начала итерации.	Field
Поле времени окончания (Дополнительный)	Поле, которое будет использоваться для определения окончания временного экстента и запроса для создания временных срезов. Тип этого поля должен соответствовать типу поля значения параметра Поле времени начала. Поле можно добавить, если в данных есть отдельные поля даты для времени начала и окончания. Если в данных есть одно поле для времени начала и окончания, оставьте этот параметр пустым или задайте для него то же поле, что и для значения Поле времени начала.	Field
Время начала итерации (Дополнительный)	Время начала, которое создает поднабор данных, начиная с указанного времени, даты или даты и времени и после него. Значение должно соответствовать типу поля, установленному в параметре Поле времени начала.	Date
Привязать дату и время начала итерации к данным (Дополнительный)	Указывает, будет ли начало итерации совпадать с ближайшей датой в данных. Checked—Начало итерации будет соответствовать ближайшей дате в данных, которая совпадает или позже даты, указанной для параметра Время начала итерации. Например, если значение параметра Время начала итерации равно 2022-01-01, а данные начинаются с 2022-01-06, итерация начнется с 2022-01-06 и разделит данные на временной интервал, заданный параметром Интервал временного шага. В случае интервала шага в один месяц срез будет с 2022-01-06 по 2022-02-06 и так далее. Unchecked—Начало итерации будет соответствовать дате, указанной для параметра Время начала итерации. Используется по умолчанию. Например, если значение параметра Время начала итерации равно 2022-01-01, а данные начинаются с 2022-01-06, итерация начнется с 2022-01-01 и разделит данные на временной интервал, заданный параметром Интервал временного шага. В случае интервала шага в один месяц срез будет с 2022-01-01 по 2022-02-01 и так далее.	Boolean
Время окончания итерации (Дополнительный)	Время окончания, которое создает поднабор данных, заканчивающийся в указанное время, дату или дату и время и до него. Значение должно соответствовать типу поля, установленному в параметре Поле времени окончания.	Date
Привязать дату и время окончания итерации к данным (Дополнительный)	Указывает, будет ли окончание итерации совмещено с ближайшей датой в данных. Checked—Окончание итерации будет соответствовать ближайшей дате в данных, которая совпадает или предшествует дате, указанной для параметра Время окончания итерации. Например, если значение параметра Время окончания итерации равно 2022-12-31, а данные заканчиваются на 2022-12-28, итерация завершится на 2022-12-28. Последний срез может быть меньше заданного интервала временного шага. Unchecked—Окончание итерации будет соответствовать ближайшей дате, указанной для параметра Время окончания итерации. Используется по умолчанию. Например, если значение параметра Время окончания итерации равно 2022-12-31, а данные заканчиваются на 2022-12-28, итерация завершится на 2022-12-31. Последний срез будет разделен в соответствии с временным интервалом, но завершится в значении, указанном для параметра Время окончания итерации.	Boolean
Включить начало (Дополнительный)	Указывает, будет ли время начала включено в каждый временной срез. Checked—Время начала будет включено в каждый временной срез. Используется по умолчанию. Unchecked—Время начала не будет включено в каждый временной срез.	Boolean
Включить окончание (Дополнительный)	Указывает, будет ли время окончания включено в каждый временной срез. Отметка Включить начало и Включить окончание приведет к двойному подсчету одного и того же события. Если событие произошло в конце предыдущего среза, оно также будет засчитано в следующем срезе (включая начало). Это может быть полезно для непрерывных событий. Например, пожар продолжался три дня, а вы хотите узнать общее количество новых и существующих записей о пожарах. Checked—Будут включены значения, которые меньше или равны времени окончания. Unchecked—Будут включены значения меньше времени окончания. Используется по умолчанию.	Boolean
Пропустить нулевые значения (Дополнительный)	Указывает, будут ли включены строки с пустыми значениями даты и времени. Этот параметр доступен, если значения параметров Поле времени начала и Поле времени окончания являются разными полями даты. Checked—Строки с пустыми значениями даты и времени не будут включены. Используется по умолчанию. Unchecked—Строки с пустыми значениями даты и времени будут включены. Снимите отметку с этого параметра в следующих случаях: The Значение параметра Поле времени начала равно null —любая строка с пустым значением параметра Поле времени начала будет включена в каждый временной срез, оканчивающийся до или точно во время, указанное в значение Поле окончания. The Значение параметра Поле времени окончания равно null —любая строка с пустым значением параметра Поле времени окончания будет включена в каждый временной срез, начинающийся во время значения параметра Поле начала, или после. Both the Значения обоих параметров Поле времени начала и Поле времени окончания равны null —любая строка с пустым значением параметров Поле начала и Поле окончания будет включена в каждый временной срез.	Boolean
Форматировать выходную строку времени (Дополнительный)	Указывает, будут ли зарезервированные символы удалены из выходных значений параметров Время начала и Время окончания. Будут сохранены только буквенно-цифровые символы и символы подчеркивания. Checked—Зарезервированные символы будут удалены из выходных значений параметров Время начала и Время окончания. Например, если значение даты и времени равно 2022-01-01 08:30:00, отформатированная строка будет иметь вид 2022_01_01_08_30_00. Unchecked—Зарезервированные символы не будут удалены из выходных значений параметров Время начала и Время окончания. Используется по умолчанию.	Boolean
Пропустить пустые срезы (Дополнительный)	Указывает, будут ли удаляться пустые временные срезы. Пустой временной срез не содержит строк. Checked—Пустые временные срезы будут удалены. Например, во входных данных нет записей для 2022-01-02 и 2022-01-03. Для периода с 2022-01-01 по 2022-01-05 с интервалом в один день эта опция позволяет пропустить эти два пустых временных среза, и пустой слой не возвращается. Используется по умолчанию. Unchecked—Пустые временные срезы не будут удалены. Например, во входных данных нет записей для 2022-01-02 и 2022-01-03. Для периода с 2022-01-01 по 2022-01-05 с интервалом в один день эта опция позволяет сохранить эти два временных среза, и пустые слои будут возвращены.	Boolean

Производные выходные данные

Подпись	Объяснение	Тип данных
Слой выходного времени	Слой с выбранными строками, соответствующими критериям выделения временных срезов.	Any Value
Время начала	Время начала для каждого временного среза	String
Конечное время	Время окончания для каждого среза.	String
Количество	Количество строк в каждом срезе.	Long

Параметры среды

Этот инструмент не использует параметры среды геообработки.

Информация о лицензировании

Basic: Да
Standard: Да
Advanced: Да