Itérer sur le temps (Outils de modèle)

Résumé

Itère sur le temps dans un champ de date.

En savoir plus sur les données temporelles

En savoir plus sur le fonctionnement de l’outil Itérer sur le temps dans ModelBuilder

Utilisation

Cet outil n’est disponible qu’à partir de ModelBuilder et s’utilise dans les modèles. L’outil n’est pas disponible via la fenêtre Geoprocessing (Géotraitement) ou via Python.
Cet outil accepte les entités et les tables ayant un champ de date.
Cet outil itère et filtre les lignes se trouvant dans des étendues et des intervalles temporels différents. Par exemple, itérez sur des données horaires pour la totalité de l’étendue temporelle des données ou un sous-ensemble de celle-ci. Cet outil crée des tranches temporelles qui peuvent être utilisées en entrée pour d’autres outils.
Utilisez le paramètre Time Definition (Définition temporelle) pour filtrer les lignes selon des mois ou des jours de la semaine spécifiques. Si, par exemple, vous itérez sur des données par semaine en utilisant une valeur Time Step Interval (Intervalle temporel) d’1 semaine alors que le paramètre Time Definition (Définition temporelle) est défini sur Saturday (Samedi) et Sunday (Dimanche), chaque tranche temporelle renvoie uniquement les données correspondant au samedi et au dimanche.

Utilisez le paramètre Subset (Sous-ensemble) pour créer un ou plusieurs sous-ensembles de chaque tranche temporelle. Le tableau ci-dessous contient des exemples de différentes valeurs pour Subset Delay (Délai du sous-ensemble) et Subset Duration (Durée du sous-ensemble) en partant du principe que la tranche temporelle commence le 1er janvier 2022 à 1 h (2022-01-01 01:00:00) et se termine le 2 janvier 2022 à 1 h (2022-01-02 01:00:00). Les numéros indiqués dans la colonne Cas correspondent aux numéros figurant sur l’image en dessous du tableau.


Cas	Valeur de sous-ensemble	Résultat
	Délai du sous-ensemble : 2 heures Durée du sous-ensemble : 2 heures	Les données de 3 h (2022-01-01 00:03:00) à 5 h (2022-01-01 00:05:00) sont renvoyées.
	Délai du sous-ensemble : 2 heures Durée du sous-ensemble : 2 heures Délai du sous-ensemble : 8 heures Durée du sous-ensemble : 4 heures	Les données de 3 h (2022-01-01 00:03:00) à 5 h (2022-01-01 00:05:00), et de 9 h (2022-01-01 00:09:00) à 13 h (2022-01-01 00:13:00) sont renvoyées.
	Délai du sous-ensemble : 2 heures Durée du sous-ensemble : Aucune	Les données de 3 h 00 (2022-01-01 00:03:00) au jour suivant 1 h 00 (2022-01-02 00:01:00) sont renvoyées.
	Délai du sous-ensemble : 2 heures Durée du sous-ensemble : 0 heures	Les données à partir de 3 h (2022-01-01 00:03:00) sont renvoyées.

Exemples de sous-ensemble Iterate Time (Itérer sur le temps)

Utilisez les paramètres Iteration Start Time (Début de l’itération) et Iteration End Time (Fin de l’itération) pour créer des tranches temporelles à partir d’un sous-ensemble temporel des données.
Utilisez les paramètres Snap Iteration Start Datetime To Data (Capturer le début de l’itération sur les données) et Snap Iteration End Datetime To Data (Capturer la fin de l’itération sur les données) avec les paramètres Iteration Start Time (Début de l’itération) et Iteration End Time (Fin de l’itération) pour faire coïncider le début et la fin de l’itération avec la valeur de date et d’heure la plus proche figurant dans les données.

Le début et la fin des tranches temporelles sont calculés en fonction de la combinaison des valeurs des paramètres. Le tableau ci-dessous contient les résultats attendus en fonction de différentes combinaisons de paramètres, lorsque le paramètre Skip Empty Slices (Ignorer les tranches vides) n’est pas activé. Par exemple, l’étendue des données va de 2022-01-03 à 2022-01-31. Avec un intervalle d’un jour, si les valeurs des paramètres Iteration Start Time (Début de l’itération) et Iteration End Time (Fin de l’itération) ne sont pas spécifiées, la première tranche temporelle commencera le 2022-01-03 (selon le début des données) et se terminera le 2022-02-01.


Début de l’itération	Capturer le début de l’itération sur les données	Fin de l’itération	Capturer la fin de l’itération sur les données	Début de la première tranche temporelle	Fin de la dernière tranche temporelle
				2022-01-03	2022-02-01
2022-01-01	Décoché			2022-01-01	2022-02-01
2022-01-01	Activé			2022-01-03	2022-02-01
		2022-02-01	Décoché	2022-01-03	2022-02-01
		2022-02-01	Activé	2022-01-03	2022-01-31
2022-01-01	Décoché	2022-02-01	Décoché	2022-01-01	2022-02-01
2022-01-01	Activé	2022-02-01	Décoché	2022-01-03	2022-02-01
2022-01-01	Décoché	2022-02-01	Activé	2022-01-01	2022-01-31
2022-01-01	Activé	2022-02-01	Activé	2022-01-03	2022-01-31

Le paramètre Include Start (Inclure le début) est toujours respecté pour la première tranche temporelle et le paramètre Include End (Inclure la fin) est toujours respecté pour la dernière tranche temporelle, quelles que soient les valeurs des paramètres Include Start (Inclure le début) et Include End (Inclure la fin). Pour chaque tranche temporelle qui se trouve entre les deux, l’inclusion ou l’exclusion des données est basée sur les valeurs des paramètres. Par exemple, si les données comportent des valeurs du 2022-01-01 au 2022-01-03, le tableau ci-dessous montre le résultat (nombre) attendu avec un intervalle d’un jour pour les itérations comprises entre le 2022-01-01 et le 2022-01-03.


Tranche temporelle	Résultat lorsqu’aucun des deux paramètres n’est sélectionné	Résultat lorsque seul le paramètre Include Start (Inclure le début) est sélectionné	Résultat lorsque seul le paramètre Include End (Inclure le début) est sélectionné	Résultat lorsque les deux paramètres sont sélectionnés
2022-01-01 à 2022-01-02	1	1	2 (Le paramètre Include Start (Inclure le début) est toujours respecté pour la première tranche temporelle)	2
2022-01-02 à 2022-01-03	0	1	1	2
2022-01-03 à 2022-01-04	0	1	0	1

Le paramètre Subset (Sous-ensemble) respecte les paramètres d’inclusion dans les paramètres Include Start (Inclure le début) et Include End (Inclure la fin).

Lorsque le même champ est utilisé pour les paramètres Iteration Start Time (Début de l’itération) et Iteration End Time (Fin de l’itération), les lignes comportant des valeurs nulles sont ignorées, car elles n’appartiennent à aucune étendue temporelle.

Lorsque des champs différents sont utilisés pour les paramètres Iteration Start Time (Début de l’itération) et Iteration End Time (Fin de l’itération), les lignes comportant des valeurs nulles sont ignorées par défaut. Désélectionnez le paramètre Skip Null Values (Ignorer les valeurs nulles) pour inclure les valeurs nulles dans l’itération. Les tableaux ci-dessous indiquent si une ligne est incluse pour les tranches temporelles en sortie comprises entre le 2022-01-01 et le 2022-01-03 avec un intervalle d’un jour, lorsque le paramètre Include Start (Inclure le début) est activé.

Par exemple, dans le tableau ci-dessous, une ligne comporte une valeur nulle dans le champ de début et la valeur du champ de fin est 2022-01-02 :


Tranche temporelle	Résultat attendu
2022-01-01 à 2022-01-02	Incluse (car une valeur de ligne nulle se trouve dans le champ de début)
2022-01-02 à 2022-01-03	Incluse (car le paramètre Include Start (Inclure le début) est activé)
2022-01-03 à 2022-01-04	Non inclus

Par exemple, dans le tableau ci-dessous, une ligne comporte la valeur 2022-01-02 dans le champ de début et la valeur du champ de fin est nulle :


Tranche temporelle	Résultat attendu
2022-01-01 à 2022-01-02	Non inclus
2022-01-02 à 2022-01-03	Incluse (car une valeur de ligne nulle se trouve dans le champ de fin)
2022-01-03 à 2022-01-04	Incluse (car une valeur de ligne nulle se trouve dans le champ de fin)

Si une ligne comporte des valeurs nulles dans les champs de début et de fin, elle est incluse dans chaque tranche temporelle en sortie.

Désélectionnez le paramètre Skip Empty Slices (Ignorer les tranches vides) pour afficher toutes les tranches temporelles dans la sortie, y compris celles dont le nombre de lignes est égal à zéro. Par défaut, les tranches vides sont masquées.
Pour chaque itération, l’outil renvoie les sorties suivantes :
- Output Layer (Couche en sortie) : couche comportant les lignes sélectionnées qui correspondent aux critères de création de tranches temporelles
- Start Time (Heure de début) : heure de début de chaque tranche temporelle
- End Time (Heure de fin) : heure de fin de chaque tranche temporelle
- Count (Nombre) : nombre de lignes dans chaque tranche temporelle
Les paramètres en sortie Start Time (Heure de début) et End Time (Heure de fin) sont au format 24 heures. Si aucune heure n’est spécifiée dans les données ni dans aucune valeur de paramètre, l’heure limite par défaut est 00:00:00.
Les valeurs des paramètres Start Time (Heure de début) et End Time (Heure de fin) peuvent être utilisées comme substitution de variables en ligne pour définir les noms en sortie dans d’autres outils. Pour ce faire, sélectionnez le paramètre Format Output Time String (Mettre en forme la chaîne temporelle en sortie) de sorte qu’une chaîne de date/heure soit renvoyée sans caractères spéciaux, comme dans l’exemple ci-dessous.

L’heure est toujours ajoutée aux chaînes de début et de fin. Pour supprimer l’heure de ces chaînes, utilisez l’outil Calculer une valeur et définissez l’expression sur "%Start Time%"[:11] + "_to_" + "%End Time%"[:11]. La sortie de l’outil Calculer une valeur peut alors être utilisée comme substitution de variable en ligne dans la sortie de l’outil Copier des entités.

Paramètres

Dialog

Etiqueter	Explication	Type de données
Input Table (Table en entrée)	Table en entrée qui sera itérée.	Table View; Feature Layer
Time Definition (Définition temporelle) (Facultatif)	Spécifie le filtre appliqué aux données. Aucun—Aucun filtre n'est appliqué. Jours de la semaine—Les données sont filtrées avec la valeur de paramètre Days (Jours). Mois—Les données sont filtrées avec la valeur de paramètre Months (Mois).	String
Mois (Facultatif)	Spécifie le mois utilisé pour filtrer les données. Ce paramètre est actif si la valeur du paramètre Time Definition (Définition temporelle) est définie sur Months (Mois). Janvier—Les données de janvier sont renvoyées. Février—Les données de février sont renvoyées. Mars—Les données de mars sont renvoyées. Avril—Les données d’avril sont renvoyées. Mai—Les données de mai sont renvoyées. Juin—Les données de juin sont renvoyées. Juillet—Les données de juillet sont renvoyées. Août—Les données d’août sont renvoyées. Septembre—Les données de septembre sont renvoyées. Octobre—Les données d’octobre sont renvoyées. Novembre—Les données de novembre sont renvoyées. December (Décembre)—Les données de décembre sont renvoyées.	String
Jours (Facultatif)	Spécifie le jour de la semaine utilisé pour filtrer les données. Ce paramètre est actif si la valeur du paramètre Time Definition (Définition temporelle) est définie sur Days (Jours). Lundi—Les données du lundi sont renvoyées. Mardi—Les données du mardi sont renvoyées. Mercredi—Les données du mercredi sont renvoyées. Jeudi—Les données du jeudi sont renvoyées. Vendredi—Les données du vendredi sont renvoyées. Samedi—Les données du samedi sont renvoyées. Dimanche—Les données du dimanche sont renvoyées.	String
Intervalle temporel	Intervalle temporel à utiliser pour créer des tranches temporelles. Seuls les nombres entiers constituent des entrées valides.	Time Unit
Sous-ensemble (Facultatif)	Un ou plusieurs sous-ensembles temporels de chaque itération. Chaque sous-ensemble est défini par une paire de valeurs Subset Delay (Délai du sous-ensemble) et Subset Duration (Durée du sous-ensemble). Le début de chaque tranche temporelle est décalé par la valeur de Subset Delay (Délai du sous-ensemble) et la plage temporelle de la tranche est définie par la valeur de Subset Duration (Durée du sous-ensemble). Prenons l’exemple d’une tranche temporelle allant du 1er janvier 2022 1 h (2022-01-01 01:00:00) au 2 janvier 2022 1 h (2022-01-02 01:00:00), avec une valeur de Subset Delay (Délai du sous-ensemble) définie sur 2 heures. Lorsque la valeur de Subset Duration (Durée du sous-ensemble) est définie sur 2 heures, la tranche temporelle commence à 3 h (2022-01-01 00:03:00) et se termine à 5 h (2022-01-01 00:05:00). Lorsque la valeur de Subset Duration (Durée du sous-ensemble) est vide, la tranche temporelle commence à 3 h (2022-01-01 00:03:00) et se termine à 1 h le jour suivant (2022-01-02 01:00:00). Lorsque la valeur de Subset Duration (Durée du sous-ensemble) est définie sur 0, le sous-ensemble renvoie uniquement les données de 3 h (2022-01-01 00:03:00). Colonnes de la table de valeurs : Subset Delay—The offset from the start of each temporal slice. Subset Duration—The temporal range of the slice.	Value Table
Champ temporel de début	Champ qui permet de définir l’étendue temporelle (ou le début de l’étendue temporelle) et la requête dans le but de créer des tranches temporelles. Ce champ peut être de type Date, Date uniquement ou Heure uniquement en fonction de l’unité de temps utilisée pour le jeu de données à itérer. Il est possible de modifier l’étendue temporelle en spécifiant une valeur de date et heure différente pour le paramètre Iteration Start Time (Début de l’itération).	Field
Champ temporel de fin (Facultatif)	Champ qui permet de définir la fin de l’étendue temporelle et de la requête dans le but de créer des tranches temporelles. Ce champ doit être du même type que celui de la valeur de paramètre Start Time Field (Champ temporel de début). Ce champ peut être ajouté si les données contiennent des champs de date distincts pour le début et la fin. Si les données contiennent un seul champ pour le début et la fin, laissez ce paramètre vide ou attribuez-lui la même valeur qu’à Start Time Field (Champ temporel de début).	Field
Début de l’itération (Facultatif)	Heure de début qui crée un sous-ensemble de données commençant à l’heure, à la date ou à la date et heure spécifiées ou après. La valeur doit correspondre au type de champ défini dans le paramètre Start Time Field (Champ temporel de début).	Date
Capturer le début de l’itération sur les données (Facultatif)	Indique si le début de l’itération doit être aligné sur la date la plus proche dans les données. Checked—Le début de l’itération coïncide avec la date la plus proche dans les données, c’est-à-dire la date qui correspond à la date indiquée ou à une date postérieure pour le paramètre Iteration Start Time (Début de l’itération). Par exemple, si la valeur du paramètre Iteration Start Time (Début de l’itération) est 2022-01-01 et que les données commencent le 2022-01-06, l’itération commencera le 2022-01-06 et les données seront divisées selon l’intervalle temporel défini par le paramètre Time Step Interval (Intervalle temporel). Pour un intervalle temporel d’un mois, la tranche va du 2022-01-06 au 2022-02-06, etc. Unchecked—Le début de l’itération coïncide avec la date indiquée pour le paramètre Iteration Start Time (Début de l’itération). Il s’agit de l’option par défaut. Par exemple, si la valeur du paramètre Iteration Start Time (Début de l’itération) est 2022-01-01 et que les données commencent le 2022-01-06, l’itération commencera le 2022-01-01 et les données seront divisées selon l’intervalle temporel défini par le paramètre Time Step Interval (Intervalle temporel). Pour un intervalle temporel d’un mois, la tranche va du 2022-01-01 au 2022-02-01, etc.	Boolean
Fin de l’itération (Facultatif)	Heure de fin qui crée un sous-ensemble de données se terminant à l’heure, à la date ou à la date et heure spécifiées ou avant. La valeur doit correspondre au type de champ défini dans le paramètre End Time Field parameter (Champ temporel de fin).	Date
Capturer la fin de l’itération sur les données (Facultatif)	Indique si la fin de l’itération doit être alignée sur la date la plus proche dans les données. Checked—La fin de l’itération coïncide avec la date la plus proche dans les données, c’est-à-dire la date qui correspond à la date indiquée ou à une date antérieure pour le paramètre Iteration End Time (Fin de l’itération). Par exemple, si la valeur du paramètre Iteration End Time (Fin de l’itération) est 2022-12-31 et que les données se terminent le 2022-12-28, l’itération se terminera le 2022-12-28. La dernière tranche peut être plus petite que l’intervalle temporel défini. Unchecked—La fin de l’itération coïncide avec la date la plus proche indiquée pour le paramètre Iteration End Time (Fin de l’itération). Il s’agit de l’option par défaut. Par exemple, si la valeur du paramètre Iteration End Time (Fin de l’itération) est 2022-12-31 et que les données se terminent le 2022-12-28, l’itération se termine le 2022-12-31. La dernière tranche est divisée conformément à l’intervalle temporel, mais se termine selon la valeur spécifiée pour le paramètre Iteration End Time (Fin de l’itération).	Boolean
Inclure le début (Facultatif)	Indique si l’heure de début doit être incluse dans chaque tranche temporelle. Checked—L’heure de début est incluse dans chaque tranche temporelle. Il s’agit de l’option par défaut. Unchecked—L’heure de début n’est pas incluse dans chaque tranche temporelle.	Boolean
Inclure la fin (Facultatif)	Indique si l’heure de fin doit être incluse dans chaque tranche temporelle. Si les options Include Start (Inclure le début) et Include End (Inclure la fin) sont sélectionnées, le même événement sera comptabilisé deux fois. Si un événement s’est produit à la fin de la tranche précédente, il est également compté dans la tranche suivante (option Inclure le début). Cela peut être utile pour les événements continus. Par exemple, un incendie est en cours depuis trois jours et vous voulez connaître le nombre total d’enregistrements d’incendie, nouveaux et existants. Checked—Les valeurs inférieures ou égales à l’heure de fin sont incluses. Unchecked—Les valeurs inférieures à l’heure de fin sont incluses. Il s’agit de l’option par défaut.	Boolean
Ignorer les valeurs NULL (Facultatif)	Indique si les lignes comportant des valeurs de date et heure nulles doivent être incluses. Ce paramètre est disponible lorsque les paramètres Start Time Field (Champ temporel de début) et End Time Field (Champ temporel de fin) indiquent des champs de date différents. Checked—Les lignes comportant des valeurs de date et heure nulles ne sont pas incluses. Il s’agit de l’option par défaut. Unchecked—Les lignes comportant des valeurs de date et heure nulles sont incluses. Désélectionnez ce paramètre dans les cas suivants : The Start Time Field (Champ temporel de début) est nul : toute ligne comportant une valeur nulle pour le paramètre Start Time Field (Champ temporel de début) est incluse dans toutes les tranches temporelles se terminant au moment défini par la valeur du paramètre End Field (Champ de fin) ou avant. The End Time Field (Champ temporel de fin) est nul : toute ligne comportant une valeur nulle pour le paramètre End Time Field (Champ temporel de fin) est incluse dans toutes les tranches temporelles qui commencent à partir du moment défini par la valeur du paramètre Start Field (Champ de début) ou après. Both the Start Time Field (Champ temporel de début) et End Time Field (Champ temporel de fin) sont nuls : toute ligne comportant une valeur nulle pour les paramètres Start Field (Champ de début) et End Field (Champ de fin) est incluse dans chaque tranche temporelle.	Boolean
Mettre en forme la chaîne temporelle en sortie (Facultatif)	Indique si les caractères réservés sont supprimés des valeurs des paramètres Start Time (Heure de début) et End Time (Heure de fin) en sortie. Seuls les caractères alphanumériques et les traits de soulignement sont conservés. Checked—Les caractères réservés sont supprimés des valeurs des paramètres Start Time (Heure de début) et End Time (Heure de fin) en sortie. Par exemple, si la valeur de date et heure est 2022-01-01 08:30:00, la chaîne mise en forme est 2022_01_01_08_30_00. Unchecked—Les caractères réservés ne sont pas supprimés des valeurs des paramètres Start Time (Heure de début) et End Time (Heure de fin) en sortie. Il s’agit de l’option par défaut.	Boolean
Ignorer les tranches vides (Facultatif)	Indique si les tranches temporelles vides doivent être supprimées. Une tranche temporelle vide ne contient aucune ligne. Checked—Les tranches temporelles vides sont supprimées. Par exemple, les données en entrée ne contiennent aucun enregistrement pour 2022-01-02 et 2022-01-03. Avec un intervalle d’un jour du 2022-01-01 au 2022-01-05, cette option ignore ces deux tranches temporelles sans qu’aucune couche vide ne soit renvoyée. Il s’agit de l’option par défaut. Unchecked—Les tranches temporelles vides ne sont pas supprimées. Par exemple, les données en entrée ne contiennent aucun enregistrement pour 2022-01-02 et 2022-01-03. Avec un intervalle d’un jour du 2022-01-01 au 2022-01-05, cette option conserve ces deux tranches temporelles. Des couches vides sont alors renvoyées.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Couche temporelle en sortie	Couche comportant les lignes sélectionnées qui correspondent aux critères de création de tranches temporelles	Any Value
Heure de début	Heure de début de chaque tranche temporelle.	String
Heure de fin	Heure de fin de chaque tranche.	String
Effectif	Nombre de lignes dans chaque tranche.	Long

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui