Zeitfeld konvertieren (Datenmanagement)

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

Parameter

BeschriftungErläuterungDatentyp
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.
    • MMM: 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.

  • DateDer Feldtyp ist "Date". Felder des Typs "Date" unterstützen Datums- und Uhrzeitwerte.
  • TextDer 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
Ausgabe-Zeitformat
(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

BeschriftungErläuterungDatentyp
Aktualisierte Eingabetabelle

Die aktualisierte Eingabetabelle.

Table View

arcpy.management.ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})
NameErläuterungDatentyp
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.
    • MMM: 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.

  • DATEDer Feldtyp ist "Date". Felder des Typs "Date" unterstützen Datums- und Uhrzeitwerte.
  • TEXTDer Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge.
  • LONGDer Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647.
  • SHORTDer Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767.
  • DOUBLEDer Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308.
  • FLOATDer 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

NameErläuterungDatentyp
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)