Mit dem Werkzeug "Datums-/Uhrzeitfeld erstellen" wird ein Datums-/Uhrzeitfeld aus vorhandenen Feldwerten erstellt.
Beispiele
Das Werkzeug "Datums-/Uhrzeitfeld erstellen" kann beispielsweise in folgenden Szenarien verwendet werden:
- Ein Dataset mit Daten zu einer Hurrikan-Spur enthält eine Zeichenfolgendarstellung der Beobachtungszeit. Verwenden Sie das Werkzeug "Datums-/Uhrzeitfeld erstellen", um das Zeichenfolgenfeld als Datumsfeld zu formatieren und auszugeben.
- Ein Dataset speichert Uhrzeitinformationen in den Feldern Hour, Minute und Second. Verwenden Sie das Werkzeug "Datums-/Uhrzeitfeld erstellen", um diese Felder und die Formate der Feldwerte anzugeben und ein neues Datumsfeld zu erstellen.
Parameter
In der folgenden Tabelle werden die Parameter beschrieben, die im Werkzeug "Datums-/Uhrzeitfeld erstellen" verwendet werden:
| Parameter | Beschreibung |
|---|---|
Eingabe-Dataset | Das Dataset mit den Feldwerten, die zum Erstellen des Datumfeldes verwendet werden. |
Felder | Eine Liste mit einem oder mehreren Feldern und dem Format der Datums- oder Uhrzeitwerte, die im angegebenen Feld enthalten sind. |
Zeitfeld | Ein Feld mit Datums- oder Uhrzeitwerten. |
Zeitformat | Das Format der Werte im Uhrzeitfeld. |
Quellfelder beibehalten | Gibt an, ob die zur Datumserstellung verwendeten Felder in der Ausgabe beibehalten werden. |
Zeitzone | Die Zeitzone der Eingabewerte. |
Ausgabezeit-Feldname | Der Name des Ausgabezeit-Feldes. Dieser Parameter ist optional. Der Standardwert ist TIMESTAMP. |
Verwendungshinweise
Verwenden Sie den Parameter Eingabe-Dataset, um das Dataset mit den Feldwerten zu identifizieren, die zum Erstellen des Datumsfeldes verwendet werden. Das Dataset wird in der Ausgabe zurückgegeben, wobei eine neue Spalte mit der Bezeichnung "Datum" hinzugefügt wird.
Verwenden Sie den Parameter Felder, um mindestens ein Feld zur Berechnung der Ausgabedatumswerte anzugeben. Die Ausgabe ist ein einzelnes Datumsfeld. Nachfolgend finden Sie Beispiele von Eingabefeldern und -formaten:
- Sie haben ein Zeichenfolgenfeld mit der Bezeichnung MY_DATE_TIME und dem Wert 2022-12-30 17:30:00. Sie geben MYDATETIME für das Zeitfeld und den Wert yyyy-MM-dd HH:mm:ss für das Zeitformat ein.
- Sie haben zwei Felder: MY_DATE mit dem Wert 07/25/2000 und MY_TIME mit dem Wert 5:30:00 PM. Sie geben zwei Feld-Format-Paare an. Geben Sie für das erste Zeitfeld MY_DATE mit dem Formatwert MM/dd/yyyy und für das zweite Zeitfeld MY_TIME mit dem Formatwert hh:mm:ss a an.
Standardmäßig werden die für die Datumserstellung verwendeten Felder aus dem Ausgabe-Dataset entfernt. Aktivieren Sie den Parameter Quellfelder beibehalten, um die Eingabefelder beizubehalten.
Der Parameter Zeitzone gibt die Zeitzone an, in der die Eingabezeitwerte gespeichert werden. Der Standardwert ist UTC (koordinierte Weltzeit). Wenn Sie einen anderen Wert als UTC angeben, werden die Eingabewerte anhand des angegebenen Zeitwertes berechnet. Das Ausgabezeitfeld wird jedoch in UTC konvertiert.
Zeitzonen basieren auf Joda-Time. Weitere Informationen zu den Joda-Time-Formaten finden Sie unter Joda-Time Available Time Zones.
Zeitformate in Data Pipelines
| Wert | Beschreibung | Beispiel |
|---|---|---|
yy | Das Jahr – durch zwei Ziffern dargestellt. | 16 |
yyyy | Das Jahr – durch vier Ziffern dargestellt. | 2016 |
MM | Der Monat – als numerischer Wert dargestellt. | 01 oder 1 |
MMM | Der Monat – durch drei Buchstaben dargestellt. | Jan |
MMMM | Der Monat – vollständig ausgeschrieben. | January |
dd | Der Tag. | 02 oder 2 |
HH | Die Stunde – wobei das 24-Stunden-Format mit Werten von 0 bis 23 verwendet wird. | 21 |
hh | Die Stunde – wobei das 12-Stunden-Format mit Werten von 1 bis 12 verwendet wird. | 9 |
mm | Die Minute – Werte liegen zwischen 0 und 59. | 45 |
ss | Die Sekunde – Werte liegen zwischen 0 und 59. | 02 |
SSS | Die Millisekunde – Werte liegen zwischen 0 und 999. | 50 |
a | Der AM/PM-Marker. | PM |
epoch_millis | Die Zeit in Millisekunden von der Unixzeit. | 1509581781000 |
epoch_seconds | Die Zeit in Sekunden von der Unixzeit. | 1509747601 |
Z | Der Zeitzonenversatz, ausgedrückt in Stunden. | -0100 oder -01:00 |
ZZZ | Der Zeitzonenversatz, ausgedrückt in Zeitzonen-IDs. | America/Los_Angeles |
'' | Einzelne Anführungszeichen werden zum Hinzufügen von Text verwendet, der keinen in dieser Tabelle angegebenen Wert darstellt. | 'T' |
Ausgaben
Das Werkzeug erstellt ein einzelnes Datumsfeld. Zum Erstellen eines einzelnen Datumswertes werden alle von Ihnen angegebenen Zeitfeld- und Format-Paare verwendet. Um mehrere Datumsfelder zu erstellen, müssen Sie das Werkzeug mehrmals ausführen.
Die Werkzeugausgabe umfasst ein Dataset, das zusätzlich zu einem neuen Datumsfeld alle Felder des Eingabe-Datasets enthält. Wenn Sie keinen Ausgabefeldnamen angegeben haben, erhält das Uhrzeitfeld standardmäßig den Namen TIMESTAMP. Der Typ des Ausgabefeldes lautet date und enthält die Datums- und Uhrzeitinformationen jedes Datensatzes.
Bei der Vorschau von Datumsfeldern werden die Werte in der Zeitzone des Browsers angezeigt. Werden die Werte in einen Feature-Layer geschrieben, werden sie in UTC-Zeit gespeichert.
Einschränkungen
Für das Werkzeug "Datums-/Uhrzeitfeld erstellen" sind die folgenden Einschränkungen bekannt:
- Das Werkzeug gibt ein einzelnes Datumsfeld zurück. Um mehrere Datumsfelder zu berechnen, müssen Sie zusätzliche Werkzeuge zum Erstellen von Datums-/Uhrzeitfeldern konfigurieren.
- Die angegebenen Feld-Format-Paare müssen einen vollständigen Datumswert berechnen, z. B. 12/23/2022 12:30:00. Werte des Typs "Nur Datum" wie 12/23/2022 oder Werte des Typs "Nur Uhrzeit" wie 12:30:00 werden für Felder des Typs "Datum" nicht unterstützt.
- Das Format muss exakt mit den Werten im angegebenen Feld übereinstimmen. Es ist beispielsweise nicht möglich, das Format MM/dd/yyyy zu verwenden, wenn das Feld nur eine Teilmenge der Werte, wie z. B. 12/30, enthält.
Lizenzanforderungen
Die folgenden Lizenzen und Konfigurationen werden benötigt:
- Benutzertyp Creator oder Professional
- Publisher-, Vermittler- oder Administratorrolle oder eine entsprechende benutzerdefinierte Rolle
Weitere Informationen zu den Anforderungen für Data Pipelines finden Sie unter Anforderungen.