Zeitfeld konvertieren (Data Management)

Zusammenfassung

Überträgt in einem Feld gespeicherte Datums- und Uhrzeitwerte in ein anderes Feld. Das Werkzeug kann verwendet werden, um Konvertierungen zwischen unterschiedlichen Feldtypen (Text-, numerischen oder Datumsfeldern) durchzuführen oder um die Werte in ein anderes Format zu konvertieren, z. B. dd/MM/yy HH:mm:ss in yyyy-MM-dd.

Verwendung

Vorsicht:

Mit diesem Werkzeug werden die Eingabedaten geändert. Weitere Informationen und Strategien zur Vermeidung unerwünschter Datenänderungen finden Sie unter Werkzeuge, die Eingabedaten ändern oder aktualisieren.

• Wenn es sich bei dem Eingabezeitfeld um ein Text- oder ein numerisches Feld handelt, wählen Sie für den Parameter Eingabe-Zeitformat das entsprechende Format aus.

  Weitere Informationen zu unterstützten Zeitfeldformaten

• Ist der Parameterwert Eingabe-Zeitfeld ein Textfeld, können für den Parameter Eingabe-Zeitformat benutzerdefinierte Formate hinzugefügt werden.

  Weitere Informationen zum Konvertieren von Zeichenfolgenwerten in das Datumsformat

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Der Layer oder die Tabelle mit dem Feld, das die Zeitwerte enthält, die konvertiert werden.	Table View
Eingabe-Zeitfeld	Das Feld mit den Zeitwerten. Das Feld kann den Typ "Short", "Long", "Float", "Double", "Text" oder "Date" aufweisen.	Field
Eingabe-Zeitformat (optional)	Das Format der Zeitwerte im Parameterwert Eingabe-Zeitfeld. Sie können ein Standardzeitformat aus der Dropdown-Liste wählen oder ein benutzerdefiniertes Format angeben. Weist das Eingabe-Zeitfeld den Typ "Date" auf, wird der Parameter nicht unterstützt. Hinweis: Bei den Formatzeichenfolgen wird die Groß- und Kleinschreibung berücksichtigt. Wenn der Datentyp des Zeitfeldes "Date" ist, ist kein Zeitformat erforderlich. Wenn der Datentyp des Zeitfeldes numerisch (Short, Long, Float oder Double) ist, wird eine Liste standardmäßiger numerischer Zeitformate in der Dropdown-Liste bereitgestellt. Wenn der Datentyp des Zeitfeldes eine Zeichenfolge ist, wird eine Liste standardmäßiger Zeichenfolgen-Zeitformate in der Dropdown-Liste bereitgestellt. Bei Zeichenfolgenfeldern können Sie auch ein benutzerdefiniertes Zeitformat angeben. Möglicherweise wurden die Zeitwerte z. B. in einem Zeichenfolgenfeld in einem der Standardformate wie "yyyy/MM/dd HH:mm:ss" oder in einem benutzerdefinierten Format wie "dd/MM/yyyy HH:mm:ss" gespeichert. Bei dem benutzerdefinierten Format können Sie auch den Bezeichner "a.m." oder "p.m." angeben. Einige häufig verwendete Formate sind unten aufgeführt: yyyy: Das Jahr durch vier Ziffern dargestellt. MM: Monat als Ziffern mit führender Null für einstellige Monate. MMMM: Monat als Abkürzung mit drei Buchstaben. dd: Tag des Monats als Ziffern mit führender Null für einstellige Tage. ddd: Wochentag als Abkürzung mit drei Buchstaben. hh: Stundenangaben mit führender Null für einstellige Stundenangaben im 12-Stunden-Format. HH: Stundenangaben mit führender Null für einstellige Stundenangaben im 24-Stunden-Format. mm: Minuten mit führender Null für einstellige Minuten. ss: Sekunden mit führender Null für einstellige Sekunden. t: Zeitmarkerzeichenfolge mit einem Buchstaben, z. B. "A" oder "P". tt: Zeitmarkerzeichenfolge mit mehreren Buchstaben, z. B. "AM" oder "PM". unix_us: Unixzeit in Mikrosekunden. unix_ms: Unixzeit in Millisekunden. unix_s: Unixzeit in Sekunden. unix_hex: Unixzeit als hexadezimaler Wert.	String
Ausgabe-Zeitfeldname	Der Name des hinzuzufügenden Feldes, in dem die konvertierten Zeitwerte gespeichert werden.	String
Ausgabe-Zeitfeldtyp (optional)	Gibt den Feldtyp des Ausgabezeitfeldes an. Datum—Der Feldtyp ist "Datum". Felder des Typs "Datum" unterstützen Datums- und Uhrzeitwerte. Text—Der Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge. Long (32-Bit-Integer)—Der Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647. Short (16-Bit-Integer)—Der Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767. Double (64-Bit-Gleitkomma)—Der Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308. Float (32-Bit-Gleitkomma)—Der Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38.	String
Ausgabezeitformat (optional)	Das Format der Ausgabe-Zeitwerte. Unterstützte Ausgabe-Zeitformate hängen vom Parameterwert Ausgabe-Zeitfeldtyp ab. Außerdem kann ein benutzerdefiniertes Format verwendet werden, um den Wert in ein anderes Format zu konvertieren oder um einen Teil des Wertes (z. B. das Jahr) zu extrahieren. Eine Liste der benutzerdefinierten Formate finden Sie in der Hilfe zum Parameter Eingabe-Zeitformat. Dieser Parameter wird nicht verwendet, wenn der Parameterwert Ausgabe-Zeitfeldtyp Date lautet. Hinweis: Wenn der Datentyp des Ausgabezeitfeldes nicht lang genug ist, um den konvertierten Zeitwert zu speichern, wird der Ausgabewert abgeschnitten.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabetabelle	Die aktualisierte Eingabetabelle.	Table View

Python

arcpy.management.ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})

Name	Erläuterung	Datentyp
in_table	Der Layer oder die Tabelle mit dem Feld, das die Zeitwerte enthält, die konvertiert werden.	Table View
input_time_field	Das Feld mit den Zeitwerten. Das Feld kann den Typ "Short", "Long", "Float", "Double", "Text" oder "Date" aufweisen.	Field
input_time_format (optional)	Das Format der Zeitwerte im Parameterwert input_time_field. Weist das Eingabe-Zeitfeld den Typ "Date" auf, wird der Parameter nicht unterstützt. Hinweis: Bei den Formatzeichenfolgen wird die Groß- und Kleinschreibung berücksichtigt. Wenn der Datentyp des Zeitfeldes "Date" ist, ist kein Zeitformat erforderlich. Wenn der Datentyp des Zeitfeldes numerisch (Short, Long, Float oder Double) ist, wird eine Liste standardmäßiger numerischer Zeitformate in der Dropdown-Liste bereitgestellt. Wenn der Datentyp des Zeitfeldes eine Zeichenfolge ist, wird eine Liste standardmäßiger Zeichenfolgen-Zeitformate in der Dropdown-Liste bereitgestellt. Bei Zeichenfolgenfeldern können Sie auch ein benutzerdefiniertes Zeitformat angeben. Möglicherweise wurden die Zeitwerte z. B. in einem Zeichenfolgenfeld in einem der Standardformate wie "yyyy/MM/dd HH:mm:ss" oder in einem benutzerdefinierten Format wie "dd/MM/yyyy HH:mm:ss" gespeichert. Bei dem benutzerdefinierten Format können Sie auch den Bezeichner "a.m." oder "p.m." angeben. Einige häufig verwendete Formate sind unten aufgeführt: yyyy: Das Jahr durch vier Ziffern dargestellt. MM: Monat als Ziffern mit führender Null für einstellige Monate. MMMM: Monat als Abkürzung mit drei Buchstaben. dd: Tag des Monats als Ziffern mit führender Null für einstellige Tage. ddd: Wochentag als Abkürzung mit drei Buchstaben. hh: Stundenangaben mit führender Null für einstellige Stundenangaben im 12-Stunden-Format. HH: Stundenangaben mit führender Null für einstellige Stundenangaben im 24-Stunden-Format. mm: Minuten mit führender Null für einstellige Minuten. ss: Sekunden mit führender Null für einstellige Sekunden. t: Zeitmarkerzeichenfolge mit einem Buchstaben, z. B. "A" oder "P". tt: Zeitmarkerzeichenfolge mit mehreren Buchstaben, z. B. "AM" oder "PM". unix_us: Unixzeit in Mikrosekunden. unix_ms: Unixzeit in Millisekunden. unix_s: Unixzeit in Sekunden. unix_hex: Unixzeit als hexadezimaler Wert.	String
output_time_field	Der Name des hinzuzufügenden Feldes, in dem die konvertierten Zeitwerte gespeichert werden.	String
output_time_type (optional)	Gibt den Feldtyp des Ausgabezeitfeldes an. DATE—Der Feldtyp ist "Datum". Felder des Typs "Datum" unterstützen Datums- und Uhrzeitwerte. TEXT—Der Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge. LONG—Der Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647. SHORT—Der Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767. DOUBLE—Der Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308. FLOAT—Der Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38.	String
output_time_format (optional)	Das Format der Ausgabe-Zeitwerte. Unterstützte Ausgabe-Zeitformate hängen vom Parameterwert output_time_type ab. Außerdem kann ein benutzerdefiniertes Format verwendet werden, um den Wert in ein anderes Format zu konvertieren oder um einen Teil des Wertes (z. B. das Jahr) zu extrahieren. Eine Liste der benutzerdefinierten Formate finden Sie in der Hilfe zum Parameter input_time_format. Dieser Parameter wird nicht verwendet, wenn der Parameterwert output_time_type DATE lautet. Hinweis: Wenn der Datentyp des Ausgabezeitfeldes nicht lang genug ist, um den konvertierten Zeitwert zu speichern, wird der Ausgabewert abgeschnitten.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_table	Die aktualisierte Eingabetabelle.	Table View

Codebeispiel

ConvertTimeField: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.ConvertTimeField_management("C:/Data/TemporalData.gdb/Input_Table","Input_Time","1033;MMMM dd, yyyy HH:mm:ss;AM;PM","Output_Time")

ConvertTimeField: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion ConvertTimeField verwendet wird.

# Name: ConvertTimeField_Ex02.py
# Description: Convert a time field to date field
# Requirements: None

# Import system modules
import arcpy

# Set local variables
inTable = "C:\Data\TemporalData.gdb\Input_Table"
inputTimeField = "Input_Time"
inputTimeFormat = "1033;MMMM dd, yyyy HH:mm:ss;AM;PM"
outputDateField = "Output_Time"

# Execute CalculateEndDate
arcpy.ConvertTimeField_management(inTable, inputTimeField, inputTimeFormat, outputDateField)

Umgebungen

Aktueller Workspace

Lizenzinformationen

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