Zeit iterieren (Model Tools)

Zusammenfassung

Durchläuft Zeitangaben in einem Datumsfeld.

Informationen zur Funktionsweise von Zeit iterieren in ModelBuilder

Verwendung

Dieses Werkzeug ist nur über ModelBuilder zur Verwendung in Modellen verfügbar. Dieses Werkzeug ist nicht im Bereich Geoverarbeitung oder in Python verfügbar.
Dieses Werkzeug akzeptiert Features und Tabellen mit einem Datumsfeld.
Dieses Werkzeug durchläuft und filtert Zeilen, die in verschiedenen Zeitintervallen und Zeiträumen liegen. Sie können zum Beispiel stündlich erfasste Daten in der vollständigen zeitlichen Ausdehnung oder in einem Teil davon durchlaufen. Das Werkzeug erstellt verschiedene Zeitintervalle, die in anderen Werkzeugen als Eingabe verwendet werden können.
Verwenden Sie den Parameter Zeitdefinition zum Filtern von Zeilen für bestimmte Monate oder Wochentage. Wenn z. B. bei der Iteration von Daten nach Woche mit einem Zeitschrittintervall von 1 Woche die Zeitdefinition auf Samstag und Sonntag eingestellt ist, gibt jedes Zeitintervall nur die Daten von Samstag und Sonntag zurück.

Verwenden Sie den Parameter Teilmenge, um eine oder mehrere Teilmengen jedes Zeitintervalls zu erstellen. Die nachstehende Tabelle zeigt Beispiele für verschiedene Werte unter Verzögerung für Teilmenge und Dauer für Teilmenge unter der Annahme, dass das Zeitintervall vom 1. Januar 2022, 1 Uhr (2022-01-01 01:00:00) bis zum 2. Januar 2022, 1 Uhr morgens (2022-01-02 01:00:00) reicht. Die Zahlen in der Spalte "Case" entsprechen den Zahlen im Bild unter der Tabelle.


Case	Teilmengenwert	Ergebnis
	Verzögerung für Teilmenge: 2 Stunden Dauer für Teilmenge: 2 Stunden	Daten von 3:00 (2022-01-01 00:03:00) bis 5:00 (2022-01-01 00:05:00) werden zurückgegeben.
	Verzögerung für Teilmenge: 2 Stunden Dauer für Teilmenge: 2 Stunden Verzögerung für Teilmenge: 8 Stunden Dauer für Teilmenge: 4 Stunden	Daten von 3:00 (2022-01-01 00:03:00) bis 5:00 (2022-01-01 00:05:00) und von 9:00 (2022-01-01 00:09:00) bis 13:00 (2022-01-01 00:13:00) werden zurückgegeben.
	Verzögerung für Teilmenge: 2 Stunden Dauer für Teilmenge: Keine	Daten von 3:00 (2022-01-01 00:03:00) bis zum nächsten Tag 13:00 (2022-01-02 00:01:00) werden zurückgegeben.
	Verzögerung für Teilmenge: 2 Stunden Dauer für Teilmenge: 0 Stunden	Daten von 3:00 (2022-01-01 00:03:00) werden zurückgegeben.

Teilmengen-Beispiele für "Zeit iterieren"

Verwenden Sie die Parameter Startzeit der Iteration und Endzeit der Iteration, um Zeitintervalle einer zeitlichen Teilmenge der Daten zu erstellen.
Verwenden Sie die Parameter Start-Datum/Uhrzeit der Iteration an Daten fangen und End-Datum/Uhrzeit der Iteration an Daten fangen mit den Parametern Startzeit der Iteration und Endzeit der Iteration, um den Beginn und das Ende der Iteration an dem am nächsten liegenden Datum-/Uhrzeit-Wert in den Daten auszurichten.

Der Beginn und das Ende von Zeitintervallen wird basierend auf der Kombination der Parameterwerte berechnet. Die folgende Tabelle enthält die erwarteten Ergebnisse bei verschiedenen Parameterkombinationen mit deaktiviertem Parameter Leere Segmente überspringen. Die Datenausdehnung beträgt von 2022-01-03 bis 2022-01-31. Wenn es zum Beispiel um ein Ein-Tages-Intervall geht und für die Parameter Startzeit der Iteration und Endzeit der Iteration keine Werte angegeben sind, beginnt basierend auf dem Start der Daten das erste Zeitintervall am 2022-01-03 und endet am 2022-02-01.


Startzeit der Iteration	Start-Datum/Uhrzeit der Iteration an Daten fangen	Endzeit der Iteration	End-Datum/Uhrzeit der Iteration an Daten fangen	Start des ersten Zeitintervalls	Ende des letzten Zeitintervalls
				Montag, 3. Januar 2022	Dienstag, 1. Februar 2022
Samstag, 1. Januar 2022	Deaktiviert			Samstag, 1. Januar 2022	Dienstag, 1. Februar 2022
Samstag, 1. Januar 2022	Aktiviert			Montag, 3. Januar 2022	Dienstag, 1. Februar 2022
		Dienstag, 1. Februar 2022	Deaktiviert	Montag, 3. Januar 2022	Dienstag, 1. Februar 2022
		Dienstag, 1. Februar 2022	Aktiviert	Montag, 3. Januar 2022	Montag, 31. Januar 2022
Samstag, 1. Januar 2022	Deaktiviert	Dienstag, 1. Februar 2022	Deaktiviert	Samstag, 1. Januar 2022	Dienstag, 1. Februar 2022
Samstag, 1. Januar 2022	Aktiviert	Dienstag, 1. Februar 2022	Deaktiviert	Montag, 3. Januar 2022	Dienstag, 1. Februar 2022
Samstag, 1. Januar 2022	Deaktiviert	Dienstag, 1. Februar 2022	Aktiviert	Samstag, 1. Januar 2022	Montag, 31. Januar 2022
Samstag, 1. Januar 2022	Aktiviert	Dienstag, 1. Februar 2022	Aktiviert	Montag, 3. Januar 2022	Montag, 31. Januar 2022

Der Parameter Start einschließen wird immer für das erste Zeitintervall berücksichtigt, und der Parameter Ende einschließen wird ungeachtet der Werte der Parameter Start einschließen und Ende einschließen immer für das letzte Zeitintervall berücksichtigt. Für jedes Zeitintervall dazwischen basiert der Einschluss oder Ausschluss von Daten auf den Parameterwerten. Für ein Beispiel mit Daten, die Werte vom 2022-01-01 bis zum 2022-01-03 enthalten, enthält die folgende Tabelle die erwarteten Ergebnisse für die Anzahl mit einem 1-Tages-Intervall für die Iterationen vom 2022-01-01 bis zum 2022-01-03.


Zeitintervall	Anzahl, wenn beide Parameter deaktiviert sind	Anzahl, wenn nur "Start einschließen" aktiviert ist	Anzahl, wenn nur "Ende einschließen" aktiviert ist	Anzahl, wenn beide Parameter aktiviert sind
2022-01-01 bis 2022-01-02	1	1	2 (Start einschließen wird immer für das erste Zeitintervall berücksichtigt)	2
2022-01-02 bis 2022-01-03	0	1	1	2
2022-01-03 bis 2022-01-04	0	1	0	1

Der Parameter Teilmenge berücksichtigt die Einbeziehungseinstellungen in den Parametern Start einschließen und Ende einschließen.

Wenn dasselbe Feld für die Parameter Startzeit der Iteration und Endzeit der Iteration verwendet wird, dann werden Zeilen mit NULL-Werten übersprungen, da sie in keinem Zeitraum liegen.

Wenn unterschiedliche Felder für die Parameter Startzeit der Iteration und Endzeit der Iteration verwendet werden, dann werden Zeilen mit NULL-Werten standardmäßig übersprungen. Deaktivieren Sie den Parameter NULL-Werte überspringen, damit sie bei der Iteration berücksichtigt werden. Die folgenden Tabellen zeigen, ob eine Zeile für die Ausgabe-Zeitintervalle vom 2022-01-01 bis zum 2022-01-03 berücksichtigt wird, wenn es um ein 1-Tages-Intervall geht und der Parameter Start einschließen aktiviert ist.

Wenn zum Beispiel in der folgenden Tabelle eine Zeile im Startzeitfeld einen NULL-Wert und im Endzeitfeld den Wert 2022-01-02 enthält:


Zeitintervall	Erwartetes Ergebnis
2022-01-01 bis 2022-01-02	Berücksichtigt (da im Startfeld der Zeile ein NULL-Wert enthalten ist)
2022-01-02 bis 2022-01-03	Berücksichtigt (da der Parameter Start einschließen aktiviert ist)
2022-01-03 bis 2022-01-04	Nicht enthalten

Wenn zum Beispiel in der folgenden Tabelle eine Zeile im Startzeitfeld den Wert 2022-01-02 und im Endzeitfeld einen NULL-Wert enthält:


Zeitintervall	Erwartetes Ergebnis
2022-01-01 bis 2022-01-02	Nicht enthalten
2022-01-02 bis 2022-01-03	Berücksichtigt (da im Endfeld der Zeile ein NULL-Wert enthalten ist)
2022-01-03 bis 2022-01-04	Berücksichtigt (da im Endfeld der Zeile ein NULL-Wert enthalten ist)

Wenn zum Beispiel eine Zeile sowohl im Startzeitfeld als auch im Endzeitfeld einen NULL-Wert enthält, dann wird diese Zeile für jedes Ausgabe-Zeitintervall berücksichtigt.

Deaktivieren Sie den Parameter Leere Segmente überspringen, wenn in der Ausgabe alle Zeitintervalle, also auch die Zeitintervalle mit der Zeilenanzahl Null, enthalten sein sollen. Standardmäßig werden die leeren Intervalle ausgeblendet.
Für jede Iteration gibt das Werkzeug die folgenden Ausgaben zurück:
- Ausgabe-Layer: Der Layer mit ausgewählten Zeilen, die mit den Kriterien für Zeitintervalle übereinstimmen
- Startzeit: Die Startzeit für jedes Zeitintervall
- Endzeit: Die Endzeit für jedes Zeitintervall
- Anzahl: Die Anzahl der Zeilen in jedem Zeitintervall
Die zwei Ausgabeparameter Startzeit und Endzeit werden im 24-Stunden-Format angegeben. Wenn in den Daten oder in keinem Parameterwert eine Zeit angegeben ist, wird standardmäßig die Grenzwertzeit 00:00:00 verwendet.
Die Werte der Parameter Startzeit und Endzeit können als direkte Variablenersetzung zum Definieren der Ausgabenamen in anderen Werkzeugen verwendet werden. Dazu müssen Sie den Parameter Ausgabe-Zeitzeichenfolge formatieren aktivieren, damit eine Datums-/Uhrzeit-Zeichenfolge ohne Sonderzeichen wie im folgenden Beispiel zurückgegeben wird.

An die Start- und Endzeitzeichenfolgen wird immer die Zeit angehängt. Um aus dieser Zeichenfolge die Zeit zu entfernen, verwenden Sie das Werkzeug Wert berechnen, und legen den Ausdruck auf "%Start Time%"[:11] + "_to_" + "%End Time%"[:11] fest. Die Ausgabe des Werkzeugs Wert berechnen kann anschließend als direkte Variablenersetzung in der Ausgabe des Werkzeugs Features kopieren verwendet werden.

Parameter

Dialog

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Die Eingabetabelle, die durchlaufen wird.	Table View; Feature Layer
Zeitdefinition (Optional)	Gibt den Filter an, der auf die Daten angewendet werden soll. Keine—Es wird kein Filter angewendet. Werktage—Die Daten werden anhand des Parameterwertes Tage gefiltert. Monate—Die Daten werden anhand des Parameterwertes Monate gefiltert.	String
Monate (Optional)	Gibt den Monat an, nach dem die Daten gefiltert werden sollen. Dieser Parameter ist aktiv, wenn für den Parameter Zeitdefinition der Wert Monate verwendet wird. Januar—Daten von Januar werden zurückgegeben. Februar—Daten von Februar werden zurückgegeben. März—Daten von März werden zurückgegeben. April—Daten von April werden zurückgegeben. Mai—Daten von Mai werden zurückgegeben. Juni—Daten von Juni werden zurückgegeben. Juli—Daten von Juli werden zurückgegeben. August—Daten von August werden zurückgegeben. September—Daten von September werden zurückgegeben. Oktober—Daten von Oktober werden zurückgegeben. November—Daten von November werden zurückgegeben. Dezember—Daten von Dezember werden zurückgegeben.	String
Tage (Optional)	Gibt den Wochentag an, nach dem die Daten gefiltert werden sollen. Dieser Parameter ist aktiv, wenn für den Parameter Zeitdefinition der Wert Tage verwendet wird. Montag—Daten von Montag werden zurückgegeben. Dienstag—Daten von Dienstag werden zurückgegeben. Mittwoch—Daten von Mittwoch werden zurückgegeben. Thursday—Daten von Donnerstag werden zurückgegeben. Friday—Daten von Freitag werden zurückgegeben. Saturday—Daten von Samstag werden zurückgegeben. Sunday—Daten von Sonntag werden zurückgegeben.	String
Zeitschrittintervall	Das Zeitschrittintervall, das zum Erstellen der Zeitintervalle verwendet werden soll. Gültige Eingaben sind nur ganze Zahlen.	Time Unit
Teilmenge (Optional)	Eine oder mehrere zeitliche Teilmengen jeder Iteration. Jede Teilmenge wird durch ein Wertepaar aus Verzögerung für Teilmenge und Dauer für Teilmenge definiert. Der Beginn jedes Zeitintervalls wird um den Wert Verzögerung für Teilmenge zeitlich versetzt, und die Dauer des Intervalls wird durch den Wert Dauer für Teilmenge definiert. Beispiel: Ein Zeitintervall liegt zwischen 1. Januar 2022, 1:00 (2022-01-01 01:00:00) und 2. Januar 2022, 1:00 (2022-01-02 01:00:00) mit einem Wert bei Verzögerung für Teilmenge von 2 Stunden. Wenn der Wert Dauer für Teilmenge 2 Stunden beträgt, startet das Zeitintervall um 3:00 (2022-01-01 00:03:00) und endet um 5:00 (2022-01-01 00:05:00). Wenn der Wert Dauer für Teilmenge leer ist, startet das Zeitintervall um 3:00 (2022-01-01 00:03:00) und endet um 1:00 am nächsten Tag (2022-01-01 00:01:00). Wenn der Wert Dauer für Teilmenge 0 beträgt, gibt die Teilmenge nur die Daten um 3:00 (2022-01-01 00:03:00) zurück. Spalten der Wertetabelle: Subset Delay—The offset from the start of each temporal slice. Subset Duration—The temporal range of the slice.	Value Table
Startzeitfeld	Ein Feld, das zum Definieren der zeitlichen Ausdehnung (oder des Starts der zeitlichen Ausdehnung) und der Abfrage zum Erstellen von Zeitintervallen verwendet werden soll. Dieses Feld kann vom Typ "Datum", "Nur Datum" oder "Nur Uhrzeit" sein, je nachdem, welche Zeiteinheit für die Iteration durch das Dataset verwendet wird. Die zeitliche Ausdehnung kann geändert werden, indem ein anderer Datums-/Uhrzeitwert für den Parameter Startzeit der Iteration angegeben wird.	Field
Endzeitfeld (Optional)	Ein Feld, das zum Definieren des Endes der zeitlichen Ausdehnung und der Abfrage zum Erstellen von Zeitintervallen verwendet werden soll. Der Feldtyp dieses Feldes muss mit dem Feldtyp des Parameterwertes Startzeitfeld übereinstimmen. Dieses Feld kann hinzugefügt werden, wenn in den Daten separate Datumsfelder für Start- und Endzeit enthalten sind. Wenn in den Daten nur ein Feld für Start- und Endzeit enthalten ist, dann lassen Sie diesen Parameter leer, oder legen Sie ihn auf dasselbe Feld wie den Wert von Startzeitfeld fest.	Field
Startzeit der Iteration (Optional)	Eine Startzeit, die eine Teilmenge der Daten erstellt, die zum oder nach dem angegebenen Datumswert, Uhrzeitwert oder Datums- und Uhrzeitwert beginnen. Der Wert muss mit dem Feldtyp übereinstimmen, der im Parameterwert Startzeitfeld festgelegt ist.	Date
Start-Datum/Uhrzeit der Iteration an Daten fangen (Optional)	Gibt an, ob der Beginn der Iteration an dem am nächsten gelegenen Datum in den Daten ausgerichtet werden soll. Checked—Der Beginn der Iteration wird an dem am nächsten gelegenen Datum in den Daten ab dem Datum, das für den Parameter Startzeit der Iteration angegeben ist, ausgerichtet. Wenn zum Beispiel der Parameter Startzeit der Iteration den Wert 2022-01-01 hat und die Daten am 2022-01-06 beginnen, dann beginnt die Iteration am 2022-01-06, und die Daten werden durch das Zeitintervall, das durch den Parameter Zeitschrittintervall definiert ist, dividiert. Bei einem Schrittintervall von einem Monat reicht das Intervall von 2022-01-06 bis 2022-02-06 und so weiter. Unchecked—Der Beginn der Iteration wird an dem Datum, das für den Parameter Startzeit der Iteration angegeben ist, ausgerichtet. Dies ist die Standardeinstellung. Wenn zum Beispiel der Parameter Startzeit der Iteration den Wert 2022-01-01 hat und die Daten am 2022-01-06 beginnen, dann beginnt die Iteration trotzdem am 2022-01-01, und die Daten werden durch das Zeitintervall, das durch den Parameter Zeitschrittintervall definiert ist, dividiert. Bei einem Schrittintervall von einem Monat reicht das Intervall von 2022-01-01 bis 2022-02-01 und so weiter.	Boolean
Endzeit der Iteration (Optional)	Eine Endzeit, die eine Teilmenge der Daten erstellt, die zum oder vor dem angegebenen Datumswert, Uhrzeitwert oder Datums- und Uhrzeitwert enden. Der Wert muss mit dem Feldtyp übereinstimmen, der im Parameterwert Endzeitfeld festgelegt ist.	Date
End-Datum/Uhrzeit der Iteration an Daten fangen (Optional)	Gibt an, ob das Ende der Iteration an dem am nächsten gelegenen Datum in den Daten ausgerichtet werden soll. Checked—Das Ende der Iteration wird an dem am nächsten gelegenen Datum in den Daten bis zu dem Datum, das für den Parameter Endzeit der Iteration angegeben ist, ausgerichtet. Wenn zum Beispiel der Parameter Endzeit der Iteration den Wert 2022-12-31 hat und die Daten am 2022-12-28 enden, dann endet die Iteration am 2022-12-28. Das letzte Intervall kann kleiner als das definierte Zeitschrittintervall sein. Unchecked—Das Ende der Iteration wird an dem am nächsten gelegenen Datum, das für den Parameter Endzeit der Iteration angegeben ist, ausgerichtet. Dies ist die Standardeinstellung. Wenn zum Beispiel der Parameter Endzeit der Iteration den Wert 2022-12-31 hat und die Daten am 2022-12-28 enden, dann endet die Iteration am 100.00. Das letzte Intervall wird zwar gemäß dem Zeitintervall dividiert, endet aber basierend auf dem Wert, der im Feld des Parameters Endzeit der Iteration angegeben ist.	Boolean
Start einbeziehen (Optional)	Gibt an, ob die Startzeit in jedem Zeitintervall berücksichtigt werden soll. Checked—Die Startzeit wird in jedem Zeitintervall berücksichtigt. Dies ist die Standardeinstellung. Unchecked—Die Startzeit wird nicht in jedem Zeitintervall berücksichtigt.	Boolean
Ende einbeziehen (Optional)	Gibt an, ob die Endzeit in jedem Zeitintervall berücksichtigt werden soll. Wenn sowohl Start einschließen als auch Ende einschließen aktiviert ist, dann wird dasselbe Ereignis zweimal gezählt. Wenn ein Ereignis am Ende des vorherigen Intervalls aufgetreten ist, dann wird es auch im folgenden Intervall gezählt (Start einschließen). Dies kann bei kontinuierlichen Ereignissen hilfreich sein. Ein Beispiel wäre ein Brand, der drei Tage angedauert hat. Und Sie möchten die Gesamtzahl der neuen und vorhandenen Einträge in Erfahrung bringen. Checked—Die Werte kleiner als oder gleich der Endzeit werden berücksichtigt. Unchecked—Die Werte kleiner als die Endzeit werden berücksichtigt. Dies ist die Standardeinstellung.	Boolean
NULL-Werte überspringen (Optional)	Gibt an, ob Zeilen mit NULL-Datums-/Uhrzeitwerten berücksichtigt werden sollen. Dieser Parameter ist dann verfügbar, wenn in den Parametern Startzeitfeld und Endzeitfeld unterschiedliche Datumsfelder enthalten sind. Checked—Zeilen mit NULL-Datums-/Uhrzeitwerten werden nicht berücksichtigt. Dies ist die Standardeinstellung. Unchecked—Zeilen mit NULL-Datums-/Uhrzeitwerten werden berücksichtigt. Diesen Parameter sollten Sie in den folgenden Fällen deaktivieren: The Der Parameter Startzeitfeld hat einen NULL-Wert: Jede Zeile mit einem NULL-Wert im Wert des Parameters Startzeitfeld wird in jedem Zeitintervall berücksichtigt, das zum oder vor dem Wert des Parameters Endfeld endet. The Der Parameter Endzeitfeld hat einen NULL-Wert: Jede Zeile mit einem NULL-Wert im Wert des Parameters Endzeitfeld wird in jedem Zeitintervall berücksichtigt, das zum oder nach dem Wert des Parameters Startfeld endet. Both the Sowohl der Parameter Startzeitfeld als auch der Parameter Endzeitfeld haben einen NULL-Wert: Jede Zeile mit NULL-Werten im Wert der Parameter Startfeld und Endfeld wird in jedem Zeitintervall berücksichtigt.	Boolean
Ausgabe-Zeitzeichenfolge formatieren (Optional)	Gibt an, ob reservierte Zeichen aus den Werten der Ausgabeparameter Startzeit und Endzeit entfernt werden sollen. Dabei bleiben nur alphanumerische Zeichen und Unterstriche erhalten. Checked—Reservierte Zeichen werden aus den Werten der Ausgabeparameter Startzeit und Endzeit entfernt. Wenn zum Beispiel der Datums-/Uhrzeitwert 2022-01-01 08:30:00 beträgt, dann wird als formatierte Zeichenfolge 2022_01_01_08_30_00 ausgegeben. Unchecked—Reservierte Zeichen werden nicht aus den Werten der Ausgabeparameter Startzeit und Endzeit entfernt. Dies ist die Standardeinstellung.	Boolean
Leere Segmente überspringen (Optional)	Gibt an, ob leere Zeitintervalle entfernt werden sollen. Ein leeres Zeitintervall enthält keine Zeilen. Checked—Leere Zeitintervalle werden entfernt. Als Beispiel sei angenommen, dass die Eingabedaten keine Einträge 2022-01-02 und 2022-01-03 enthalten. Bei einem Ein-Tages-Intervall vom 2022-01-01 bis zum 2022-01-05 können Sie mit dieser Option diese zwei leeren Zeitintervalle überspringen. In diesem Fall wird kein leerer Layer zurückgegeben. Dies ist die Standardeinstellung. Unchecked—Leere Zeitintervalle werden nicht entfernt. Als Beispiel sei angenommen, dass die Eingabedaten keine Einträge 2022-01-02 und 2022-01-03 enthalten. Bei einem Ein-Tages-Intervall vom 2022-01-01 bis zum 2022-01-05 können Sie mit dieser Option diese zwei Zeitintervalle beibehalten. In diesem Fall werden leere Layer zurückgegeben.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabezeit-Layer	Der Layer mit ausgewählten Zeilen, die mit den Kriterien für Zeitintervalle übereinstimmen	Any Value
Startzeit	Die Startzeit für jedes Zeitintervall.	String
Endzeit	Die Endzeit für jedes Intervall.	String
Anzahl	Die Anzahl der Zeilen in jedem Intervall.	Long

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja