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

Résumé

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 table en entrée lorsqu’un nom de champ existant est le même que le nom de champ en sortie défini.

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

Syntaxe

arcpy.ca.AddDateAttributes(in_table, date_field, date_attributes)
ParamètreExplicationType de données
in_table

Couche ou table qui contient le champ dont les valeurs temporelles doivent être 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,...]

Spécifie les propriétés de date et d’heure et les champs qui seront ajoutés à la table en entrée.

  • Output Time Format (Format d’heure en sortie) : propriété de date ou d’heure à ajouter au nom de champ en sortie.
  • Output Field Name (Nom de champ en sortie) : nom du champ qui sera ajouté à la table en entrée.

Les options Output Time Format (Format d’heure en sortie) sont les suivantes :

  • Hour (Heure) : valeur d’heure, comprise entre 0 et 23.
  • Day Full Name (Nom complet du jour) : nom complet du jour de la semaine, par exemple mercredi.
  • Month (Mois) : valeur de mois, comprise entre 1 et 12.
  • Day of the Month (Jour du mois) : valeur du jour du mois, comprise entre 1 et 31.
  • Year (Année) : valeur de l’année au format aaaa, par exemple 1983.
Value Table

Sortie dérivée

NomExplicationType de données
out_table

Table en entrée mise à jour contenant les attributs de date.

Vue tabulaire

Exemple de code

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

Le script de fenêtre Python ci-dessous 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 ci-dessous illustre l'utilisation de l'outil AddDateAttributes dans un script autonome.

# Name: AddDateAttributes.py
# Description: Adds 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"]
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, hour_field, month_field, day_num_field, 
                   year_field]
# Execute AddDateAttributes
arcpy.ca.AddDateAttributes(in_features, date_field, date_attributes)

Informations de licence

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

Rubriques connexes