Zeit iterieren (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.

    CaseTeilmengenwertErgebnis

    1

    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.

    2

    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.

    3

    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.

    4

    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, dann beginnt basierend auf dem Start der Daten das erste Zeitintervall am 2022-01-03 und endet am 2022-02-01.

    Startzeit der IterationStart-Datum/Uhrzeit der Iteration an Daten fangenEndzeit der IterationEnd-Datum/Uhrzeit der Iteration an Daten fangenStart des ersten ZeitintervallsEnde 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.

    ZeitintervallAnzahl, wenn beide Parameter deaktiviert sindAnzahl, wenn nur "Start einschließen" aktiviert istAnzahl, wenn nur "Ende einschließen" aktiviert istAnzahl, 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 eine Zeile im Startzeitfeld einen NULL-Wert und im Endzeitfeld den Wert 2022-01-02 enthält:

    ZeitintervallErwartetes 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:

    ZeitintervallErwartetes 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.

    Werkzeugausgaben als direkte Variablenersetzung

    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.

    Werkzeugausgaben ohne Zeit als direkte Variablenersetzung

Parameter

BeschriftungErläuterungDatentyp
Eingabetabelle

Die Eingabetabelle, die durchlaufen werden soll.

Table View; Feature Layer
Zeitdefinition
(optional)

Gibt den Filter an, der auf die Daten angewendet werden soll.

  • KeineEs wird kein Filter angewendet.
  • Werktage:Die Daten werden anhand des Parameterwerts Tage gefiltert.
  • MonateDie Daten werden anhand des Parameterwerts Monate gefiltert.
String
Monate
(optional)

Gibt den Monat an, nach dem die Daten gefiltert werden sollen.

Dieser Parameter ist aktiv, wenn Sie als Parameterwert Zeitdefinition die Option Monate angegeben haben.

  • JanuarDaten von Januar werden zurückgegeben.
  • FebruarDaten von Februar werden zurückgegeben.
  • MärzDaten von März werden zurückgegeben.
  • AprilDaten von April werden zurückgegeben.
  • MaiDaten von Mai werden zurückgegeben.
  • JuniDaten von Juni werden zurückgegeben.
  • JuliDaten von Juli werden zurückgegeben.
  • AugustDaten von August werden zurückgegeben.
  • SeptemberDaten von September werden zurückgegeben.
  • OktoberDaten von Oktober werden zurückgegeben.
  • NovemberDaten von November werden zurückgegeben.
  • DezemberDaten von Dezember werden zurückgegeben.
String
Tage
(optional)

Gibt den Wochentag an, nach dem die Daten gefiltert werden sollen.

Dieser Parameter ist aktiv, wenn Sie als Parameterwert Zeitdefinition die Option Tage angegeben haben.

  • MontagDaten von Montag werden zurückgegeben.
  • DienstagDaten von Dienstag werden zurückgegeben.
  • MittwochDaten von Mittwoch werden zurückgegeben.
  • DonnerstagDaten von Donnerstag werden zurückgegeben.
  • FreitagDaten von Freitag werden zurückgegeben.
  • SamstagDaten von Samstag werden zurückgegeben.
  • SonntagDaten 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.
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 zum Abfragen beim Erstellen der Zeitintervalle 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.

  • 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)

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.

  • 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 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-Datums-/Uhrzeitwerten berücksichtigt werden sollen. Dieser Parameter ist dann verfügbar, wenn in den Parametern Startzeitfeld und Endzeitfeld unterschiedliche Datumsfelder enthalten sind.

  • Aktiviert: Zeilen mit NULL-Datums-/Uhrzeitwerten werden nicht berücksichtigt. Dies ist die Standardeinstellung.
  • Deaktiviert: Zeilen mit NULL-Datums-/Uhrzeitwerten werden berücksichtigt.

Diesen Parameter sollten Sie in den folgenden Fällen deaktivieren:

  • 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.
  • 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.
  • 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 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 der Datums-/Uhrzeitwert 2022-01-01 08:30:00 beträgt, dann wird als 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 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 leeren 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

BeschriftungErläuterungDatentyp
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.

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja