Datumsattribute hinzufügen (Crime Analysis and Safety)

Zusammenfassung

Fügt Felder hinzu, die Datums- oder Zeiteigenschaften aus einem Eingabe-Datumsfeld enthalten, beispielsweise vollständiger Name des Tages, Tag des Monats, Monat und Jahr.

Verwendung

  • Vorhandene Felder werden in der Eingabetabelle überschrieben, wenn ein vorhandener Feldname mit dem definierten Wert für Ausgabefeldname übereinstimmt.

  • Die Werte der neuen Felder werden nicht automatisch aktualisiert, wenn die Werte des Parameters Datumsfeld aktualisiert werden. Führen Sie diese Werkzeug aus, wenn der Parameter Datumsfeld aktualisiert wird.

Parameter

BeschriftungErläuterungDatentyp
Eingabetabelle

Der Layer oder die Tabelle mit dem Feld mit den Datumswerten, die extrahiert werden.

Table View
Datumsfeld

Das Datumsfeld, aus dem die Datums- und Zeiteigenschaften extrahiert werden, um die neuen Feldwerte anzugeben.

Field
Datumsattribute

Die Datums- und Zeiteigenschaften sowie die Datums- und Zeitfelder, die der Eingabetabelle hinzugefügt werden.

  • Ausgabezeitformat: Die Datums- oder Zeiteigenschaft, die Ausgabefeldname hinzugefügt wird.
  • Ausgabefeldname: Der Name des Feldes, das der Eingabetabelle hinzugefügt wird.

Die folgenden Optionen für Ausgabezeitformat stehen zur Verfügung:

  • Stunde: Der Stundenwert zwischen 0 und 23.
  • Name des Tages: Der vollständige Name des Wochentages, z. B. Mittwoch.
  • Numerischer Wert für Tag: Der Wert für den Wochentag zwischen 1 und 7.
  • Monat: Der Monatswert zwischen 1 und 12.
  • Tag des Monats: Der Wert für den Tag des Monats zwischen 1 und 31.
  • Jahr: Der Jahreswert im Format JJJJ, z. B. 1983.
Value Table

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Eingabetabelle

Die aktualisierte Eingabetabelle mit den Datumsattributen.

Table View

arcpy.ca.AddDateAttributes(in_table, date_field, date_attributes)
NameErläuterungDatentyp
in_table

Der Layer oder die Tabelle mit dem Feld mit den Datumswerten, die extrahiert werden.

Table View
date_field

Das Datumsfeld, aus dem die Datums- und Zeiteigenschaften extrahiert werden, um die neuen Feldwerte anzugeben.

Field
date_attributes
[date_attributes,...]

Die Datums- und Zeiteigenschaften sowie die Datums- und Zeitfelder, die der Eingabetabelle hinzugefügt werden.

  • Ausgabezeitformat: Die Datums- oder Zeiteigenschaft, die Ausgabefeldname hinzugefügt wird.
  • Ausgabefeldname: Der Name des Feldes, das der Eingabetabelle hinzugefügt wird.

Die folgenden Optionen für Ausgabezeitformat stehen zur Verfügung:

  • Stunde: Der Stundenwert zwischen 0 und 23.
  • Name des Tages: Der vollständige Name des Wochentages, z. B. Mittwoch.
  • Numerischer Wert für Tag: Der Wert für den Wochentag zwischen 1 und 7.
  • Monat: Der Monatswert zwischen 1 und 12.
  • Tag des Monats: Der Wert für den Tag des Monats zwischen 1 und 31.
  • Jahr: Der Jahreswert im Format JJJJ, z. B. 1983.
Value Table

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_table

Die aktualisierte Eingabetabelle mit den Datumsattributen.

Table View

Codebeispiel

AddDateAttributes – Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion AddDateAttributes im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = r"C:\data\city_pd.gdb"
arcpy.ca.AddDateAttributes("CallsForService", "CALLDATE")
AddDateAttributes  – Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht die Verwendung der Funktion AddDateAttributes in einem eigenständigen Skript.

# 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"]
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)

Umgebungen

Sonderfälle

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen