Zeit iterieren (ModelBuilder)

Zusammenfassung

Durchläuft Zeitangaben in einem Datumsfeld.

Weitere Informationen zu Zeitdaten

Informationen zur Funktionsweise von "Zeit iterieren" in ModelBuilder

Verwendung

• Dieses Werkzeug ist nur über das ModelBuilder-Menüband 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 die Parameter Startzeit der Iteration und Endzeit der Iteration, um Zeitintervalle einer zeitlichen Teilmenge der Daten zu erstellen.

• Verwenden Sie die Parameter Startdatum der Iteration an Daten fangen und Enddatum 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 Wert von datetime 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. Zum Beispiel haben die Daten eine datetime-Ausdehnung 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, dann 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
  				3. Januar 2022	1. Februar 2022
  1. Januar 2022	Deaktiviert			1. Januar 2022	1. Februar 2022
  1. Januar 2022	Aktiviert			3. Januar 2022	1. Februar 2022
  		1. Februar 2022	Deaktiviert	3. Januar 2022	1. Februar 2022
  		1. Februar 2022	Aktiviert	3. Januar 2022	31. Januar 2022
  1. Januar 2022	Deaktiviert	1. Februar 2022	Deaktiviert	1. Januar 2022	1. Februar 2022
  1. Januar 2022	Aktiviert	1. Februar 2022	Deaktiviert	3. Januar 2022	1. Februar 2022
  1. Januar 2022	Deaktiviert	1. Februar 2022	Aktiviert	1. Januar 2022	31. Januar 2022
  1. Januar 2022	Aktiviert	1. Februar 2022	Aktiviert	3. Januar 2022	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

• Wenn dasselbe datetime-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 datetime-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 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 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 datetime-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 danach als direkte Variablenersetzung in der Ausgabe des Werkzeugs Features kopieren verwendet werden.

  

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Die Eingabetabelle, die durchlaufen werden soll.	Table View; Feature Layer
Zeitschrittintervall	Gibt das Zeitintervall an, das zum Erstellen der Zeitintervalle verwendet werden soll. Gültige Eingaben sind nur ganze Zahlen. Minuten—Die Daten werden durch Minuten dividiert. Stunden—Die Daten werden durch Stunden dividiert. Tage—Die Daten werden durch Tage dividiert. Wochen—Die Daten werden durch Wochen dividiert. Monate—Die Daten werden durch Monate dividiert. Jahre—Die Daten werden durch Jahre dividiert. Jahrzehnte—Die Daten werden durch Jahrzehnte dividiert. Jahrhunderte—Die Daten werden durch Jahrhunderte dividiert.	Time Unit
Startzeitfeld	Ein Feld, das zum Definieren der zeitlichen Ausdehnung und zum Abfragen beim Erstellen der Zeitintervalle verwendet werden soll. Die zeitliche Ausdehnung kann geändert werden, indem ein anderer Wert für das Feld datetime im Parameter Startzeit der Iteration angegeben wird.	Field
Endzeitfeld (optional)	Ein Feld, das zum Definieren des Endes der zeitlichen Ausdehnung und zum Abfragen beim Erstellen der Zeitintervalle verwendet werden soll. 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)	Erstellt eine Teilmenge der Daten, die an dem angegebenen Wert von datetime beginnt.	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. Aktiviert: 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. Deaktiviert: 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)	Erstellt eine Teilmenge der Daten, die an dem angegebenen Wert von datetime enden.	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. Aktiviert: 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. Deaktiviert: 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 datetime des Parameters Endzeit der Iteration angegeben ist.	Boolean
Start einbeziehen (optional)	Gibt an, ob die Startzeit in jedem Zeitintervall berücksichtigt werden soll. Aktiviert: Die Startzeit wird in jedem Zeitintervall berücksichtigt. Dies ist die Standardeinstellung. Aktiviert: 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. Aktiviert: Die Werte kleiner als oder gleich der Endzeit werden berücksichtigt. Deaktiviert: Die Werte kleiner als die Endzeit werden berücksichtigt. Dies ist die Standardeinstellung.	Boolean
NULL-Werte überspringen (optional)	Gibt an, ob Zeilen mit NULL-Werten im Feld datetime berücksichtigt werden sollen. Dieser Parameter ist dann verfügbar, wenn in den Parametern Startzeitfeld und Endzeitfeld Werte mit unterschiedlichen Datumsfeldern enthalten sind. Aktiviert: Die Zeilen mit NULL-Werten im Feld datetime werden nicht berücksichtigt. Dies ist die Standardeinstellung. Deaktiviert: Die Zeilen mit NULL-Werten im Feld datetimes werden nicht berücksichtigt. Diesen Parameter sollten Sie in den folgenden Fällen deaktivieren: Der Parameter Startzeitfeld hat den Wert null: Jede Zeile mit einem NULL-Wert im Wert des Parameters Startzeitfeld wird in jedem Zeitintervall bis zum Ende des Zeitraums im Wert des Parameters Endfeld berücksichtigt. Der Parameter Endzeitfeld hat den Wert null: Jede Zeile mit einem NULL-Wert im Wert des Parameters Endzeitfeld wird in jedem Zeitintervall, das innerhalb der Zeitintervallabfrage für dieses Zeitintervall liegt, berücksichtigt. Sowohl der Parameter Startzeitfeld als auch der Parameter Endzeitfeld hat den Wert null: Jede Zeile mit einem NULL-Wert 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 Startzeit entfernt werden sollen. Dabei bleiben nur alphanumerische Zeichen und Unterstriche erhalten. Aktiviert: Reservierte Zeichen werden aus den Werten der Ausgabeparameter Startzeit und Startzeit entfernt. Wenn zum Beispiel das Feld datetime den Wert 2022-01-01 08:30:00 hat, wird die formatierte Zeichenfolge 2022_01_01_08_30_00 ausgegeben. Deaktiviert: Reservierte Zeichen werden nicht aus den Werten der Ausgabeparameter Startzeit und Startzeit entfernt. Dies ist die Standardeinstellung.	Boolean
Leere Segmente überspringen (optional)	Gibt an, ob leere (Zeilenanzahl = 0) Zeitintervalle entfernt werden sollen. Ein leeres Zeitintervall enthält keine Zeilen. Aktiviert: 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 Zeitintervalle überspringen. In diesem Fall wird kein leerer Layer zurückgegeben. Dies ist die Standardeinstellung. Deaktiviert: 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.