Transformationsfunktionen für Datum und Uhrzeit

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 5 Minuten Lesedauer

    • Verwenden Sie Transformationsfunktionen für Datum und Uhrzeit, um Datenpillen für Datums-/Uhrzeitwerte neu zu berechnen oder umzuformatieren.

    Transformationsfunktionen für Datum und Uhrzeit erfordern eine Datums-/Uhrzeiteingabedatenpille oder eine Zeichenfolge. Einige Funktionen unterstützen auch Datenpillen für die Dauer. Stellen Sie sicher, dass Sie die richtige Eingabe verwenden Datenpillentyp Beim Anwenden von Transformationsfunktionen für Datum und Uhrzeit. Wenn eine Datums- und Uhrzeitumwandlungsfunktion auf einen falschen Datenpillentyp angewendet wird, werden die Daten zur Laufzeit nicht umgewandelt, und stattdessen wird der Eingabewert zurückgegeben. Weitere Informationen zum Bestätigen Ihrer Flow-Laufzeitwerte finden Sie unter Testen Sie einen Flow .

    Hinweis:
    Werte für Datum/Uhrzeit der Laufzeit sind nicht lokalisiert und werden in der UTC-Zeitzone (Coordinated Universal Time) angezeigt. Weitere Informationen finden Sie unter Zeitzonen Und Zeitzonendarstellung .

    Zeit hinzufügen

    Fügt Tage, Stunden, Minuten oder Sekunden zu einem eingegebenen Datum/Uhrzeit, Datum, Fälligkeitsdatum oder Dauer hinzu.

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum/Uhrzeit, Datum, Fälligkeitsdatum oder Dauer
    Hinweis:
    Wenn die Eingabe ein Datum oder Fälligkeitsdatum ist, erstellt die Transformation einen vollständigen Datums-/Uhrzeitwert mit Zeitwerten von Stunde 0, Minute 0 und Sekunde 0.
    		 Duration – Zeit zum Hinzufügen in Tagen, Stunden, Minuten und Sekunden Datum/Uhrzeit: Transformierter Datums-/Uhrzeitwert nach dem Hinzufügen des angegebenen Duration
    Abbildung : 1. Beispiel
    • Eingabe: 2009-09-12 11:00:00 2019
    • Dauer: 3 Stunden
    • Ausgabe: 2009-09-12 14:00:00 2019

    Zeit abziehen

    Subtrahiert Tage, Stunden, Minuten und/oder Sekunden von den Eingabedatum/Uhrzeit, Datum, Fälligkeitsdatum oder Dauer.

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum/Uhrzeit, Datum, Fälligkeitsdatum oder Dauer
    Hinweis:
    Wenn die Eingabe ein Datum oder Fälligkeitsdatum ist, erstellt die Transformation einen vollständigen Datums-/Uhrzeitwert mit Zeitwerten von Stunde 0, Minute 0 und Sekunde 0.
    		 Duration – Geben Sie eine Zeit für die Subtraktion in Tagen, Stunden, Minuten und Sekunden ein Datum/Uhrzeit: Transformierter Datums-/Uhrzeitwert nach Abzug des angegebenen Duration
    Abbildung : 2. Beispiel
    • Eingabe: 2009-09-12 11:00:00 2019
    • Dauer: 2 Tage, 1 Stunde, 5 Minuten, 10 Sekunden
    • Ausgabe: 10. September 2019 09:54:50

    In diesem Beispiel ruft der Flow einen CMDB-Konfigurationselement-Datensatz aus einer Remote-Instanz ab. Die Transformationsfunktion „Zeit abziehen“ lokalisiert dann den Wert von Erstellt Feld durch Abzug von drei Stunden vom eingegebenen Datum/Uhrzeit.

    Abbildung : 3. Lokalisieren Sie die Zeitzone eines Feldwerts
    Lokalisieren Sie die Zeitzone eines Feldwerts.

    Zeichenfolge in Datum

    Wandelt die Eingabezeichenfolge in Datum/Uhrzeit um.

    Eingabedatenpille Parameter Ausgabedatenpille
    Zeichenfolge formatiert wie in angegeben Input Date Format
    • Input Date Format – Datums-/Uhrzeitformat oder Datumsformat der Eingabezeichenfolge
    • Custom Format – Gültiges Datum/Uhrzeit- oder Datumsformat, dargestellt als Zeichenfolge. Nur erforderlich, wenn Anwenderdefiniertes Format als ausgewählt ist Input Date Format.
    		 Datum/Uhrzeit
    Hinweis:
    • Wenn der Datums-/Uhrzeitwert für Anwenderdefiniertes Format Die Eingabe ist unvollständig. Die Transformation erstellt einen vollständigen Datums-/Uhrzeitwert mit Standarddaten und -Uhrzeiten. In einem solchen Fall wird die Transformation standardmäßig auf das aktuelle Jahr, den aktuellen Monat, Tag 1 eines Monats, Stunde 0, Minute 0 und Sekunde 0 zurückgesetzt. Beispiel: Ein Eingabedatenpillenwert von Okt. 2019 Und ein anwenderdefiniertes Datumsformat von MMM JJJJ Erzeugt eine Ausgabe von 2019-10-01 00:00:00 .
    • Wenn Sie einen falschen Datenpillentyp verwenden oder ungültig sind Anwenderdefiniertes Format , Der Flow wird während der Laufzeit abgebrochen.
    Abbildung : 4. Beispiel
    • Eingabe: „1995-11-20“
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Ausgabe: 1995-11-20 00:00:00

    Datum in Zeichenfolge

    Wandelt das eingegebene Datum/Uhrzeit, Datum oder Fälligkeitsdatum in eine Zeichenfolge um. Wählen Sie ein aus Datumsformat Für die Eingabe von Datum/Uhrzeit. Alternativ können Sie ein eingeben Anwenderdefiniertes Format Für die Eingabe von Datum/Uhrzeit.

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum/Uhrzeit, Datum oder Fälligkeitsdatum
    • Output Date Format – Datums-/Uhrzeitformat oder Datumsformat der Ausgabezeichenfolge
    • Custom Format – Gültiges Datum/Uhrzeit- oder Datumsformat, dargestellt als Zeichenfolge. Nur erforderlich, wenn Anwenderdefiniertes Format als ausgewählt wird Datumsformat .
    		 Zeichenfolge formatiert wie in angegeben Output Date Format
    Hinweis:
    Wenn Sie einen falschen Eingabedatenpillentyp verwenden oder ungültig sind Anwenderdefiniertes Format , Der Flow wird während der Laufzeit abgebrochen.
    Abbildung : 5. Beispiel
    • Eingabe: 1969-12-31 14:23:57
    • Ausgabedatumsformat: Anwenderdefiniert (unten eingeben)
    • Anwenderdefiniertes Format: „Ein“ MMM TT, JJJ „um“ hh:mm a
    • Ausgabe: „Am 31. Dezember 1969 um 14:23 Uhr“

    In diesem Beispiel ruft der Flow einen Anwenderdatensatz [sys_user] aus einer Drittpartei-Datenbank ab. Die Transformationsfunktion „Datum in Zeichenfolge“ konvertiert das Format von Erstellt Und protokolliert dann das Datum, die Uhrzeit und den Namen, die dem Datensatz zugeordnet sind.

    Abbildung : 5. Verketten Sie einen Datums-/Uhrzeitwert mit einem Zeichenfolgenwert
    Verketten Sie einen Datums-/Uhrzeitwert mit einem Zeichenfolgenwert.

    Anwenderdefinierte Datumsformate

    Sie können ein anwenderdefiniertes Datumsformat mit einer Sequenz bestimmter Datums- und Zeitmusterzeichenfolgen angeben. Eine Musterzeichenfolge besteht aus einem oder mehreren Groß- und Kleinbuchstaben von A bis Z. Jeder Text in Anführungszeichen wird ignoriert und stattdessen in die Datumsausgabe kopiert.

    Zeichenfolge Beschreibung Ausgabeformat Beispiel
    G ERA-Bezeichner Text AD
    J Jahr Jahr 2019; 19
    Y Woche im Jahr Jahr 2019; 19
    M Monat im Jahr (innerhalb des Datums) Monat Juli; Juli; Juli; 07
    L Monat im Jahr (eigenständiger Wert) Monat Juli; Juli; Juli; 07
    w Woche im Jahr Nummer 52
    W Woche im Monat Nummer 1
    D Tag im Jahr Nummer 365
    D Tag im Monat Nummer 2
    F Wochentag im Monat Nummer 3
    E Tagesname in Woche Text Mittwoch; Mi
    u Wochentage Nummer 3
    a Morgens oder p.m. Text P.m.
    H Stunde in Tag von 0 bis 23 Nummer 0
    k Stunde in Tag von 1 bis 24 Nummer 24
    Tsd. Stunde in morgens oder p.m. von 0 bis 11 Nummer 0
    S Stunde in morgens oder abends von 1 bis 12 Nummer 12
    m Minute in Stunde Nummer 59
    s Sekunde in Minute Nummer 1
    S Millisekunde Nummer 500
    z Zeitzone im Standardformat Zeitzone im Standardformat Pazifik-Normalzeit; PST
    Z Zeitzone im RFC 822-Format Zeitzone im RFC 822-Format -0800
    X Zeitzone im ISO 8601-Format Zeitzone im ISO 8601-Format -08; -0800; -08:00

    Tag

    Ruft die Tageskomponente ab dem angegebenen Datum/der angegebenen Uhrzeit ab.

    Eingabedatenpille Ausgabedatenpille
    Datum/Uhrzeit Ganzzahl: Tag ab dem angegebenen Datum.
    Abbildung : 7. Beispiel
    • Eingabe: 2014-11-20 13:06:12 2021
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Ausgabe: 20

    Stunde

    Ruft die Stundenkomponente ab dem angegebenen Datum/der angegebenen Uhrzeit ab.

    Eingabedatenpille Ausgabedatenpille
    Datum/Uhrzeit Ganzzahl: Stunde ab dem angegebenen Datum.
    Abbildung : 8. Beispiel
    • Eingabe: 2014-11-20 13:06:12 2021
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Ausgabe: 13

    Minute

    Ruft die Minutenkomponente ab dem angegebenen Datum/der angegebenen Uhrzeit ab.

    Eingabedatenpille Ausgabedatenpille
    Datum/Uhrzeit Ganzzahl: Minutenkomponente ab dem angegebenen Datum.
    Abbildung : 9. Beispiel
    • Eingabe: 2014-11-20 13:06:12 2021
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Ausgabe: 06

    2.

    Ruft die zweite Komponente ab dem angegebenen Datum/der angegebenen Uhrzeit ab.

    Eingabedatenpille Ausgabedatenpille
    Datum/Uhrzeit Ganzzahl: Zweite Komponente ab dem angegebenen Datum.
    Abbildung : 10. Beispiel
    • Eingabe: 2014-11-20 13:06:12 2021
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Ausgabe: 12

    Monat

    Ruft die Monatskomponente ab dem angegebenen Datum/der angegebenen Uhrzeit ab.

    Eingabedatenpille Ausgabedatenpille
    Datum/Uhrzeit Ganzzahl: Monatskomponente ab dem angegebenen Datum.
    Abbildung : 11. Beispiel
    • Eingabe: 2014-11-20 13:06:12 2021
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Ausgabe: 11

    Woche

    Wertet die Wochennummer für das angegebene Datum/die angegebene Uhrzeit aus.

    Eingabedatenpille Ausgabedatenpille
    Datum/Uhrzeit Ganzzahl: Wochennummer für das angegebene Datum.
    Abbildung : 12. Beispiel
    • Eingabe: 2021-04-07 12:01:12
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Ausgabe: 15

    Jahr

    Ruft die Jahreskomponente ab dem angegebenen Datum/der angegebenen Uhrzeit ab.
    Eingabedatenpille Ausgabedatenpille
    Datum/Uhrzeit Ganzzahl: Jahreskomponente ab dem angegebenen Datum.
    Abbildung : 13. Beispiel
    • Eingabe: 2021-04-07 12:01:12
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Ausgabe: 2021

    Datumsdifferenz

    Wertet die Zeitdauerdifferenz zwischen dem angegebenen Eingabedatum und dem Parameterdatum aus und addiert dann die Zeitdauer der Differenz zur Epochenzeit (01.01.1970 00:00:00).

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum/Uhrzeit, Datum oder Fälligkeitsdatum Datum/Uhrzeit, Datum oder Fälligkeitsdatum Dauer: Differenz der Zeitdauer, die der Epochenzeit hinzugefügt wurde (01.01.1970 00:00:00).
    Abbildung : 14. Beispiel
    • Eingabe: 02.05.2021 09:10:12
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Parameter: 2011-04-07 06:02:23 2021
    • Ausgabe: 26.01.1970 03:07:49

    Monatsende

    Wertet den letzten Tag des Monats aus, nachdem die angegebene Anzahl der Monate zum angegebenen Datum hinzugefügt wurde.

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum Anzahl der Monate: Monate, die dem angegebenen Datum hinzugefügt werden sollen. Ganzzahl: Letzter Tag des Monats nach Hinzufügen der Anzahl der Monate zum angegebenen Eingabedatum.
    Abbildung : 15. Beispiel
    • Eingabe: 2021-11-20
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Anzahl der Monate: 3
    • Ausgabe: 28. Februar 2022