Add Date Attributes (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 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.

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

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
Attributs de date

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 obtenue

ÉtiquetteExplicationType de données
Table en entrée actualisée

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

Vue tabulaire

arcpy.ca.AddDateAttributes(in_table, date_field, date_attributes)
NomExplicationType 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 obtenue

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)

Environnements

Cas particuliers

Informations de licence

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

Rubriques connexes