Ajouter des attributs de date (Analyse criminelle et sécurité)

Synthèse

Ajoute des champs contenant des propriétés de date ou d’heure à partir d’un champ de date en entrée, par exemple le nom complet du jour, le jour du mois, le mois et l’année.

Utilisation

• Les champs existants seront remplacés dans la valeur de la table en entrée lorsqu’un nom de champ existant est le même que la valeur définie du nom de champ en sortie.

• Les valeurs des nouveaux champs ne se mettront pas automatiquement à jour en cas de mise à jour des valeurs du paramètre Champ de date. Exécutez cet outil lorsque le paramètre Champ de date est mis à jour.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	Couche ou table qui contient le champ dont les valeurs temporelles seront extraites.	Table View
Champ Date	Champ de date à partir duquel les propriétés de date et d’heure seront extraites pour remplir les valeurs du nouveau champ.	Field
Attributs de date	Propriétés de date et d’heure, et champs qui seront ajoutés à la table en entrée. Format d’heure en sortie : propriété de date ou d’heure qui sera ajoutée au nom de champ en sortie. Nom de champ en sortie : nom du champ qui sera ajouté à la table en entrée. Les options Format d’heure en sortie sont les suivantes : Heure : valeur d’heure, comprise entre 0 et 23. Nom complet du jour : nom complet du jour de la semaine, par exemple mercredi. Valeur numérique du jour : valeur entre 1 et 7 représentant le jour de la semaine. Mois : valeur de mois, comprise entre 1 et 12. Jour du mois : valeur du jour du mois, comprise entre 1 et 31. Année : valeur de l’année au format aaaa, par exemple 1983.	Value Table

Sortie obtenue

Étiquette	Explication	Type de données
Table en entrée mise à jour	Table en entrée mise à jour contenant les attributs de date.	Table View

Python

arcpy.ca.AddDateAttributes(in_table, date_field, date_attributes)

Nom	Explication	Type de données
in_table	Couche ou table qui contient le champ dont les valeurs temporelles seront extraites.	Table View
date_field	Champ de date à partir duquel les propriétés de date et d’heure seront extraites pour remplir les valeurs du nouveau champ.	Field
date_attributes [date_attributes,...]	Propriétés de date et d’heure, et champs qui seront ajoutés à la table en entrée. Format d’heure en sortie : propriété de date ou d’heure qui sera ajoutée au nom de champ en sortie. Nom de champ en sortie : nom du champ qui sera ajouté à la table en entrée. Les options Format d’heure en sortie sont les suivantes : Heure : valeur d’heure, comprise entre 0 et 23. Nom complet du jour : nom complet du jour de la semaine, par exemple mercredi. Valeur numérique du jour : valeur entre 1 et 7 représentant le jour de la semaine. Mois : valeur de mois, comprise entre 1 et 12. Jour du mois : valeur du jour du mois, comprise entre 1 et 31. Année : valeur de l’année au format aaaa, par exemple 1983.	Value Table

Sortie obtenue

Nom	Explication	Type de données
out_table	Table en entrée mise à jour contenant les attributs de date.	Table View

Exemple de code

Exemple 1 d’utilisation de l’outil AddDateAttributes (fenêtre Python)

La fenêtre de script Python suivante illustre l’utilisation de la fonction AddDateAttributes en mode immédiat.

import arcpy
arcpy.env.workspace = r"C:\data\city_pd.gdb"
arcpy.ca.AddDateAttributes("CallsForService", "CALLDATE")

Exemple 2 d’utilisation de l’outil AddDateAttributes (script autonome)

Le script Python suivant illustre l’utilisation de la fonction AddDateAttributes dans un script autonome.

# Name: AddDateAttributes.py
# Description: Add fields for hour, day full name, month, day of the month, 
#              and year to the calls for service data based on the call date 
#              field.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:/data/city_pd.gdb"

# Set local variables
in_features = "CallsForService"
date_field = "CALLDATE"

# Customize the name of output date attribute fields
# ["Output Time Format", "Output Field Name"]
day_name_field = ["DAY_FULL_NAME", "CALL_DAYOFWEEK"]
day_week_field = ["DAY_OF_WEEK", "CALL_DAYNUM"]
hour_field = ["HOUR", "CALL_HOUR"]
month_field = ["MONTH", "CALL_MONTH"]
day_num_field = ["DAY_OF_MONTH", "CALL_DAY"]
year_field = ["YEAR", "CALL_YEAR"]

date_attributes = [day_name_field, day_week_field, hour_field, month_field, day_num_field, 
                   year_field]

# Execute AddDateAttributes
arcpy.ca.AddDateAttributes(in_features, date_field, date_attributes)

Environnements

Espace de travail courant, Étendue

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui