Sélectionner une couche par date et heure (Outils d’analyse criminelle et de sécurité)

Résumé

Sélectionne les registres en fonction des plages de date et heure ou des propriétés de date, par exemple, date unique, plage de temps, période, jours de la semaine, mois, ou année.

Utilisation

L’entrée doit être une couche d’entités ou vue tabulaire.
L’entrée doit contenir un champ de date. Si l’entrée ne comprend pas de champ de date, utilisez l’outil Convert Time Field (Convertir un champ temporel) pour générer un champ de date à partir de dates au format texte dans un champ de texte.
Cet outil utilise l’ensemble des critères pour effectuer une sélection. Si une partie quelconque de la date en entrée ne correspond pas aux critères de sélection, l’entité ou l’enregistrement n’est pas sélectionné(e).

Toutes les sélections de date reposent sur le fuseau horaire de votre ordinateur.
Pour utiliser cet outil dans un modèle ou script, utilisez l’outil Make Table View (Générer une vue tabulaire) ou Make Feature Layer (Générer une couche) pour convertir une classe d’entités en entrée en vue tabulaire ou couche d’entités, respectivement, avant d’exécuter cet outil.

Etiqueter	Explication	Type de données
Enregistrements en entrée	Les données contenant un champ de date sur lesquelles la sélection est appliquée.	Table View; Feature Layer
Type de sélection	Détermine la manière dont la sélection doit être appliquée et ce qui se produit lorsqu’une sélection existe déjà. Nouvelle sélection—La sélection obtenue remplace la sélection courante. Il s’agit de l’option par défaut. Ajouter à la sélection actuelle—La sélection obtenue est ajoutée à la sélection courante si celle-ci existe. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection. Supprimer de la sélection actuelle—La sélection obtenue est supprimée de la sélection courante. S’il n’existe aucune sélection, cette option ne produit aucun effet. Sélectionner un sous-ensemble à partir de la sélection actuelle—La sélection obtenue est associée à la sélection courante. Seuls les enregistrements communs aux deux restent sélectionnés.	String
Type de temps	Spécifie de quelle façon les champs de date et heure sont utilisés pour sélectionner les registres. Champ temporel unique—Les registres sont sélectionnés en fonction d’un seul champ temporel dans l’entité en entrée. Champs Plage temporelle—Les registres sont sélectionnés en fonction des champs d’heure de début et de fin dans l’entité en entrée.	String
Date Field (Facultatif)	Champ Date de la couche en entrée sur lequel est basée la sélection. Ce paramètre est actif uniquement si le paramètre Time Type (Type de temps) est défini sur Single Time Field (Champ temporel unique).	Field
Champ Date de début (Facultatif)	Champ Date de début issu de plage de temps sur laquelle sera basée la sélection. Ce paramètre est actif uniquement si le paramètre Time Type (Type de temps) est défini sur Time Range Fields (Champs Plage temporelle).	Field
Champ Date de fin (Facultatif)	Champ Date de fin issu de plage temporelle sur laquelle sera basée la sélection. Ce paramètre est actif uniquement si le paramètre Time Type (Type de temps) est défini sur Time Range Fields (Champs Plage temporelle).	Field
Options de sélection (Facultatif)	Spécifie comment seront effectuées les sélections de date et heure. Date—La sélection sera effectuée par date. Durée—La sélection sera effectuée par heure de la journée. Jour de la semaine—La sélection sera effectuée par jour de la semaine. Mois—La sélection sera effectuée par mois. Année—La sélection sera effectuée par année.	String
Type de sélection Date (Facultatif)	Détermine si les enregistrements seront sélectionnés en fonction d’une plage de dates, d’une date unique, d’une période de récence ou d’une période comparative. Ce paramètre est actif uniquement si le paramètre Selection Options (Options de sélection) est défini sur Date. Par plage de dates—Les registres seront sélectionnés en fonction d’une plage de dates de début et de fin. Par date unique—Les enregistrements seront sélectionnés en fonction de la date unique spécifiée. Par récence—La sélection des registres s’effectuera en fonction d’une période donnée par rapport à la date actuelle (date et heure système), par exemple, au cours des 14 derniers jours. Par période comparative—La sélection des registres s’effectuera en fonction de la période précédant immédiatement une période récente par rapport à la date actuelle (date et heure système). Si, par exemple, la date actuelle est le 29 janvier et que la période considérée est 14 jours, les registres compris entre le 1er janvier et le 14 janvier seront sélectionnés. Cette option peut être combinée à une sélection By Recency (Par récence) afin de comparer le nombre d’enregistrements entre deux périodes adjacentes (par exemple, les deux périodes de 14 jours allant du 1er au 14 janvier et du 15 au 28 janvier).	String
Date (Facultatif)	Date et heure unique à sélectionner. Ce paramètre est uniquement actif si le paramètre Date Selection Type (Type de sélection de date) est défini sur By Single Date (Par date unique).	Date
Date de début (Facultatif)	Date de début de la plage de dates. Ce paramètre est actif uniquement si le paramètre Date Selection Type (Type de sélection Date) est défini sur By Date Range (Par plage de dates).	Date
Date de fin (Facultatif)	Date de fin de la plage de dates. Ce paramètre est actif uniquement si le paramètre Date Selection Type (Type de sélection Date) est défini sur By Date Range (Par plage de dates).	Date
Utiliser l’heure système actuelle comme Heure de fin (Facultatif)	Spécifie si les registres de la journée en cours (heure système locale) seront inclus dans la sélection s’ils existent dans la période récente. Par exemple, si l’intervalle de temps spécifié est de 14 jours, que l’outil est exécuté le 15 janvier à 17 h 00 (heure système locale), la période de récence inclut tous les enregistrements compris dans la période commençant 14 jours auparavant à 17 h et le jour d’exécution de l’outil à 17 heures ; ce paramètre est activé. Dans cet exemple, la sélection est comprise entre le 1er janvier 2017 à 17 h 00 et le 15 janvier 2017 à 17 h 00. Si l’on utilise le même exemple, en désactivant ce paramètre, la période récente utilise le début de la journée actuelle comme heure de fin (selon l’heure système locale). Dans notre exemple, cela signifie que la sélection sera comprise entre le 1er janvier 2017 à minuit et le 15 janvier 2017 à minuit pour l’intervalle de 14 jours. Ce paramètre est actif uniquement si le paramètre Date Selection Type (Type de sélection Date) est défini sur By Comparative Time Period (Par période comparative) ou By Recency (Par récence). Activé—Les registres de la journée en cours seront inclus dans la sélection. Décoché—Les registres de la journée en cours ne seront pas inclus dans la sélection. Il s’agit de l’option par défaut.	Boolean
Intervalle (Facultatif)	Nombre d’unité de temps (minutes, heures, jours, semaines, mois, ou années) définissant la période récente sur laquelle est basée la sélection, par exemple, les événements ayant eu lieu dans les 14 derniers jours. Ce paramètre est actif uniquement si le paramètre Date Selection Type (Type de sélection Date) est défini sur By Comparative Time Period (Par période comparative) ou By Recency (Par récence).	Time Unit
Heure de début (Facultatif)	Heure de début de la plage temporelle. Ce paramètre est actif uniquement si le paramètre Selection Options (Options de sélection) est défini sur Time (Temps).	Date
Heure de fin (Facultatif)	Heure de fin de la plage temporelle. Ce paramètre est actif uniquement si le paramètre Selection Options (Options de sélection) est défini sur Time (Temps).	Date
Jours de la semaine (Facultatif)	Détermine le ou les jours de la semaine qui seront utilisés pour sélectionner les enregistrements. Ce paramètre est actif uniquement si le paramètre Selection Options (Options de sélection) est défini sur Day of week (Jour de la semaine). Lundi—Les registres enregistrés le lundi seront sélectionnés. Mardi—Les registres enregistrés le mardi seront sélectionnés. Mercredi—Les registres enregistrés le mercredi seront sélectionnés. Jeudi—Les registres enregistrés le jeudi seront sélectionnés. Vendredi—Les registres enregistrés le vendredi seront sélectionnés. Samedi—Les registres enregistrés le samedi seront sélectionnés. Dimanche—Les registres enregistrés le dimanche seront sélectionnés.	String
Mois (Facultatif)	Détermine le ou les mois qui seront utilisés pour sélectionner les enregistrements. Ce paramètre est actif uniquement si le paramètre Selection Options (Options de sélection) est défini sur Month (Mois). Janvier—Les registres enregistrés en janvier seront sélectionnés. Février—Les registres enregistrés en février seront sélectionnés. Mars—Les registres enregistrés en mars seront sélectionnés. Avril—Les registres enregistrés en avril seront sélectionnés. Mai—Les registres enregistrés en mai seront sélectionnés. Juin—Les registres enregistrés en juin seront sélectionnés. Juillet—Les registres enregistrés en juillet seront sélectionnés. Août—Les registres enregistrés en août seront sélectionnés. Septembre—Les registres enregistrés en septembre seront sélectionnés. Octobre—Les registres enregistrés en octobre seront sélectionnés. Novembre—Les registres enregistrés en novembre seront sélectionnés. December (Décembre)—Les registres enregistrés en décembre seront sélectionnés.	String
Années (Facultatif)	La ou les années qui seront utilisées pour sélectionner les enregistrements. Ce paramètre est actif uniquement si le paramètre Selection Options (Options de sélection) est défini sur Years (Années).	Long

Sortie dérivée

Etiqueter	Explication	Type de données
Couche ou vue tabulaire mise à jour	Entrées mises à jour avec sélections appliquées.	Table View; Feature Layer
Nombre de lignes	Nombre d’enregistrements sélectionnés.	Long

arcpy.ca.SelectLayerByDateAndTime(in_layer_or_view, selection_type, time_type, {date_field}, {start_date_field}, {end_date_field}, {selection_options}, {date_selection_type}, {single_date}, {start_date}, {end_date}, {use_system_time}, {time_slice}, {start_time}, {end_time}, {days_of_week}, {months}, {years})

Nom	Explication	Type de données
in_layer_or_view	Les données contenant un champ de date sur lesquelles la sélection est appliquée.	Table View; Feature Layer
selection_type	Détermine la manière dont la sélection doit être appliquée et ce qui se produit lorsqu’une sélection existe déjà. `NEW_SELECTION`—La sélection obtenue remplace la sélection courante. Il s’agit de l’option par défaut. `ADD_TO_SELECTION`—La sélection obtenue est ajoutée à la sélection courante si celle-ci existe. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection. `REMOVE_FROM_SELECTION`—La sélection obtenue est supprimée de la sélection courante. S’il n’existe aucune sélection, cette option ne produit aucun effet. `SUBSET_SELECTION`—La sélection obtenue est associée à la sélection courante. Seuls les enregistrements communs aux deux restent sélectionnés.	String
time_type	Spécifie de quelle façon les champs de date et heure sont utilisés pour sélectionner les registres. `SINGLE_TIME_FIELD`—Les registres sont sélectionnés en fonction d’un seul champ temporel dans l’entité en entrée. `TIME_RANGE_FIELDS`—Les registres sont sélectionnés en fonction des champs d’heure de début et de fin dans l’entité en entrée.	String
date_field (Facultatif)	Champ Date de la couche en entrée sur lequel est basée la sélection. Ce paramètre est actif uniquement si le paramètre `time_type` est défini sur `SINGLE_TIME_FIELD`.	Field
start_date_field (Facultatif)	Champ Date de début issu de plage de temps sur laquelle sera basée la sélection. Ce paramètre est actif uniquement si le paramètre `time_type` est défini sur `TIME_RANGE_FIELDS`.	Field
end_date_field (Facultatif)	Champ Date de fin issu de plage temporelle sur laquelle sera basée la sélection. Ce paramètre est actif uniquement si le paramètre `time_type` est défini sur `TIME_RANGE_FIELDS`.	Field
selection_options [selection_options,...] (Facultatif)	Spécifie comment seront effectuées les sélections de date et heure. `DATE`—La sélection sera effectuée par date. `TIME`—La sélection sera effectuée par heure de la journée. `DAY_OF_WEEK`—La sélection sera effectuée par jour de la semaine. `MONTH`—La sélection sera effectuée par mois. `YEAR`—La sélection sera effectuée par année.	String
date_selection_type (Facultatif)	Détermine si les enregistrements seront sélectionnés en fonction d’une plage de dates, d’une date unique, d’une période de récence ou d’une période comparative. Ce paramètre est actif uniquement si le paramètre `selection_options` est défini sur `DATE`. `DATE_RANGE`—Les registres seront sélectionnés en fonction d’une plage de dates de début et de fin. `SINGLE_DATE`—Les enregistrements seront sélectionnés en fonction de la date unique spécifiée. `RECENCY`—La sélection des registres s’effectuera en fonction d’une période donnée par rapport à la date actuelle (date et heure système), par exemple, au cours des 14 derniers jours. `COMPARATIVE`—La sélection des registres s’effectuera en fonction de la période précédant immédiatement une période récente par rapport à la date actuelle (date et heure système). Si, par exemple, la date actuelle est le 29 janvier et que la période considérée est 14 jours, les registres compris entre le 1er janvier et le 14 janvier seront sélectionnés. Cette option peut être combinée à une sélection `RECENCY` afin de comparer le nombre d’enregistrements entre deux périodes adjacentes (par exemple, les deux périodes de 14 jours allant du 1er au 14 janvier et du 15 au 28 janvier).	String
single_date (Facultatif)	Date et heure unique à sélectionner. Ce paramètre est actif uniquement si le paramètre `date_selection_type` est défini sur `SINGLE_DATE`.	Date
start_date (Facultatif)	Date de début de la plage de dates. Ce paramètre est actif uniquement si le paramètre `date_selection_type` est défini sur `DATE_RANGE`.	Date
end_date (Facultatif)	Date de fin de la plage de dates. Ce paramètre est actif uniquement si le paramètre `date_selection_type` est défini sur `DATE_RANGE`.	Date
use_system_time (Facultatif)	Spécifie si les registres de la journée en cours (heure système locale) seront inclus dans la sélection s’ils existent dans la période récente. Par exemple, si la tranche temporelle spécifiée est de 14 jours, que l’outil est exécuté le 15 janvier à 17 h 00 (heure système locale), la période de récence inclut tous les enregistrements compris dans la période commençant 14 jours auparavant à 17 h 00 et le jour d’exécution de l’outil à 17 h 00 ; `SYSTEM_TIME` est sélectionné. Dans cet exemple, la sélection est comprise entre le 1er janvier 2017 à 17 h 00 et le 15 janvier 2017 à 17 h 00. Si l’on considère le même exemple, en sélectionnant `NO_SYSTEM_TIME`, la période récente utilise le début de la journée actuelle comme heure de fin (selon l’heure système locale). Dans notre exemple, cela signifie que la sélection sera comprise entre le 1er janvier 2017 à minuit et le 15 janvier 2017 à minuit pour l’intervalle de 14 jours. Ce paramètre est actif uniquement si le paramètre `date_selection_type` est défini sur `COMPARATIVE` ou `RECENCY`. `SYSTEM_TIME`—Les registres de la journée en cours seront inclus dans la sélection. `NO_SYSTEM_TIME`—Les registres de la journée en cours ne seront pas inclus dans la sélection. Il s’agit de l’option par défaut.	Boolean
time_slice (Facultatif)	Nombre d’unité de temps (minutes, heures, jours, semaines, mois, ou années) définissant la période récente sur laquelle est basée la sélection, par exemple, les événements ayant eu lieu dans les 14 derniers jours. Ce paramètre est actif uniquement si le paramètre `date_selection_type` est défini sur `COMPARATIVE` ou `RECENCY`.	Time Unit
start_time (Facultatif)	Heure de début de la plage temporelle. Ce paramètre est actif uniquement si le paramètre `selection_options` est défini sur `TIME`.	Date
end_time (Facultatif)	Heure de fin de la plage temporelle. Ce paramètre est actif uniquement si le paramètre `selection_options` est défini sur `TIME`.	Date
days_of_week [days_of_week,...] (Facultatif)	Détermine le ou les jours de la semaine qui seront utilisés pour sélectionner les enregistrements. Ce paramètre est actif uniquement si le paramètre `selection_options` est défini sur `DAY_OF_WEEK`. `MONDAY`—Les registres enregistrés le lundi seront sélectionnés. `TUESDAY`—Les registres enregistrés le mardi seront sélectionnés. `WEDNESDAY`—Les registres enregistrés le mercredi seront sélectionnés. `THURSDAY`—Les registres enregistrés le jeudi seront sélectionnés. `FRIDAY`—Les registres enregistrés le vendredi seront sélectionnés. `SATURDAY`—Les registres enregistrés le samedi seront sélectionnés. `SUNDAY`—Les registres enregistrés le dimanche seront sélectionnés.	String
months [months,...] (Facultatif)	Détermine le ou les mois qui seront utilisés pour sélectionner les enregistrements. Ce paramètre est actif uniquement si le paramètre `selection_options` est défini sur `MONTH`. `JANUARY`—Les registres enregistrés en janvier seront sélectionnés. `FEBRUARY`—Les registres enregistrés en février seront sélectionnés. `MARCH`—Les registres enregistrés en mars seront sélectionnés. `APRIL`—Les registres enregistrés en avril seront sélectionnés. `MAY`—Les registres enregistrés en mai seront sélectionnés. `JUNE`—Les registres enregistrés en juin seront sélectionnés. `JULY`—Les registres enregistrés en juillet seront sélectionnés. `AUGUST`—Les registres enregistrés en août seront sélectionnés. `SEPTEMBER`—Les registres enregistrés en septembre seront sélectionnés. `OCTOBER`—Les registres enregistrés en octobre seront sélectionnés. `NOVEMBER`—Les registres enregistrés en novembre seront sélectionnés. `DECEMBER`—Les registres enregistrés en décembre seront sélectionnés.	String
years [years,...] (Facultatif)	La ou les années qui seront utilisées pour sélectionner les enregistrements. Ce paramètre est actif uniquement si le paramètre `selection_options` est défini sur `YEAR`.	Long

Sortie dérivée

Nom	Explication	Type de données
out_layer_or_view	Entrées mises à jour avec sélections appliquées.	Table View; Feature Layer
count	Nombre d’enregistrements sélectionnés.	Long

Exemple de code

Exemple 1 d’utilisation de la fonction SelectLayerByDateAndTime (fenêtre Python)

Le script ci-après illustre l’utilisation de la fonction SelectLayerByDateAndTime en mode immédiat.

import arcpy
arcpy.env.workspace = r"C:/data/city_pd.gdb"

arcpy.ca.SelectLayerByDateAndTime("Crimes",
                                "NEW_SELECTION",
                                "SINGLE_TIME_FIELD",
                                "offendate",
                                None,
                                None,
                                "DATE",
                                "DATE_RANGE",
                                None,
                                "8/1/2018",
                                "8/31/2018")

Exemple 2 d’utilisation de la fonction SelectLayerByDateAndTime (script autonome)

Le script autonome suivant est un exemple d’utilisation de la fonction SelectLayerByDateAndTime dans un script :

# Name: SelectLayerByDateAndTime.py
# Description: Select crimes that occurred in the past 28 days, from 9 PM to 1 PM, on the weekend, from the month of October to December,
#              in the year 2018, and show the selection count. Finally, make a selection based on all the queries above.

# Import script modules
import arcpy

# Set the workspace
arcpy.env.workspace = r"C:\data\city_pd.gdb"

# Convert Feature class to table view
arcpy.management.MakeTableView("Crimes", "Crimes_View")

lyr, count = arcpy.ca.SelectLayerByDateAndTime(in_layer_or_view="Crimes_View",
                                                selection_type="NEW_SELECTION",
                                                time_type="SINGLE_TIME_FIELD",
                                                date_field="offendate",
                                                selection_options="DATE",
                                                date_selection_type="RECENCY",
                                                time_slice="28 Days")

arcpy.AddMessage("Crimes that occurred in past 28 days: {}".format(str(count)))
arcpy.management.SelectLayerByAttribute("Crimes_View","CLEAR_SELECTION")

lyr, count = arcpy.ca.SelectLayerByDateAndTime(in_layer_or_view="Crimes_View",
                                                selection_type="NEW_SELECTION",
                                                time_type="SINGLE_TIME_FIELD",
                                                date_field="offendate",
                                                selection_options="TIME",
                                                start_time="9:00 PM",
                                                end_time="1:00 AM")

arcpy.AddMessage("All crimes that occurred between 9PM and 1AM: {}".format(count))
arcpy.management.SelectLayerByAttribute("Crimes_View","CLEAR_SELECTION")

lyr, count = arcpy.ca.SelectLayerByDateAndTime(in_layer_or_view="Crimes_View",
                                                selection_type="NEW_SELECTION",
                                                time_type="SINGLE_TIME_FIELD",
                                                date_field="offendate",
                                                selection_options="DAY_OF_WEEK",
                                                days_of_week=["SATURDAY", "SUNDAY"])

arcpy.AddMessage("All crimes that occurred on the weekend: {}".format(count))
arcpy.management.SelectLayerByAttribute("Crimes_View","CLEAR_SELECTION")

lyr, count = arcpy.ca.SelectLayerByDateAndTime(in_layer_or_view="Crimes_View",
                                                selection_type="NEW_SELECTION",
                                                time_type="SINGLE_TIME_FIELD",
                                                date_field="offendate",
                                                selection_options="MONTH",
                                                months=["OCTOBER", "NOVEMBER", "DECEMBER"])

arcpy.AddMessage("All crimes that occurred October through December: {}".format(count))
arcpy.management.SelectLayerByAttribute("Crimes_View","CLEAR_SELECTION")

lyr, count = arcpy.ca.SelectLayerByDateAndTime(in_layer_or_view="Crimes_View",
                                                selection_type="NEW_SELECTION",
                                                time_type="SINGLE_TIME_FIELD",
                                                date_field="offendate",
                                                selection_options="YEAR",
                                                years=[2018])

arcpy.AddMessage("All crimes that occurred in the year 2018: {}".format(count))
arcpy.management.SelectLayerByAttribute("Crimes_View","CLEAR_SELECTION")

# Combine selection options for more detailed time queries
lyr, count = arcpy.ca.SelectLayerByDateAndTime(in_layer_or_view="Crimes_View",
                                                selection_type="NEW_SELECTION",
                                                time_type="SINGLE_TIME_FIELD",
                                                date_field="offendate",
                                                selection_options=["TIME", "DAY_OF_WEEK", "MONTH","YEAR"],
                                                start_time="9:00 PM",
                                                end_time="1:00 AM",
                                                days_of_week=["SATURDAY", "SUNDAY"],
                                                months=["OCTOBER", "NOVEMBER", "DECEMBER"],
                                                years=[2018])

message = """All crimes that occurred in the year 2018 during the months
of October through November on the weekends from 9PM to 1AM: {}
""".format(count)

arcpy.AddMessage(message)
arcpy.management.SelectLayerByAttribute("Crimes_View", "CLEAR_SELECTION")

Environnements

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

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Sélectionner une couche par date et heure (Outils d’analyse criminelle et de sécurité)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes