Datums-/Uhrzeit-Transformationsfunktionen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 5 Minuten Lesedauer

    • Verwenden Sie Datums- und Uhrzeittransformationsfunktionen, um Datenpillen für Datums-/Uhrzeitwerte neu zu berechnen oder neu zu formatieren.

    Datums-/Uhrzeit-Transformationsfunktionen erfordern eine Datums-/Uhrzeit- oder Zeichenfolgen-Eingabedatenpille. Einige Funktionen unterstützen auch Datenpillen für die Dauer. Stellen Sie sicher, dass Sie den richtigen Eingabepillentyp verwenden, wenn Sie Datums- und Uhrzeittransformationsfunktionen anwenden. Wenn eine Datums-/Uhrzeit-Transformationsfunktion auf einen unzulässigen Datenpillentyp angewendet wird, werden die Daten zur Laufzeit nicht umgewandelt, und stattdessen wird der Eingabewert zurückgegeben. Weitere Informationen zum Bestätigen der Werte für die Flow-Laufzeit finden Sie unter Flow testen.

    Hinweis:
    Datums-/Uhrzeitwerte 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

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

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum/Uhrzeit, Datum, Fälligkeitsdatum oder Dauer
    Hinweis:
    Wenn die Eingabe ein Datum oder ein Fälligkeitsdatum ist, erstellt die Umwandlung einen vollständigen Datums-/Uhrzeitwert unter Verwendung der Zeitwerte Stunde 0, Minute 0 und Sekunde 0.
    		 Duration Menge der zu addierenden Zeit in Tagen, Stunden, Minuten und Sekunden Datum/Uhrzeit: Umgewandelter Datums-/Uhrzeitwert nach dem Hinzufügen des angegebenen Duration
    Abbildung : 1. Beispiel
    • Eingabe: 2019-09-12 11:00:00
    • Dauer: 3 Stunden
    • Ausgabe: 12.09.2019 14:00:00

    Zeit abziehen

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

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum/Uhrzeit, Datum, Fälligkeitsdatum oder Dauer
    Hinweis:
    Wenn die Eingabe ein Datum oder ein Fälligkeitsdatum ist, erstellt die Umwandlung einen vollständigen Datums-/Uhrzeitwert unter Verwendung der Zeitwerte Stunde 0, Minute 0 und Sekunde 0.
    		 Duration Geben Sie eine zu subtrahierende Zeit in Tagen, Stunden, Minuten und Sekunden ein Datum/Uhrzeit: Umgewandelter Datums-/Uhrzeitwert nach Subtrahieren des angegebenen Duration
    Abbildung : 2. Beispiel
    • Eingabe: 2019-09-12 11:00:00
    • Dauer: 2 Tage, 1 Stunde, 5 Minuten, 10 Sekunden
    • Ausgabe: 10.09.2019 09:54:50

    In diesem Beispiel ruft der Flow einen Datensatz für ein CMDB-Konfigurationselement von einer Remote-Instanz ab. Die Transformationsfunktion „Zeit subtrahieren“ lokalisiert dann den Wert des Felds „ Erstellt “, indem drei Stunden von dem eingegebenen Datum/Uhrzeit subtrahiert werden.

    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-/Uhrzeit- oder Datumsformat der Eingabezeichenfolge
    • Custom Format Gültiges Datums-/Uhrzeit- oder Datumsformat, dargestellt als Zeichenfolge. Nur erforderlich, wenn Input Date Formatals „Anwenderdefiniertes Format“ ausgewählt ist.
    		 Datum/Uhrzeit
    Hinweis:
    • Wenn der Datums-/Uhrzeitwert für die Eingabe „Anwenderdefiniertes Format “ unvollständig ist, erstellt die Umwandlung unter Verwendung von Standarddaten und -uhrzeiten einen vollständigen Datums-/Uhrzeitwert. In diesem Fall verwendet die Transformation standardmäßig das aktuelle Jahr, den aktuellen Monat, Tag 1 eines Monats, Stunde 0, Minute 0 und Sekunde 0. Zum 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 oder ein ungültiges anwenderdefiniertes Formatverwenden, wird der Flow zur 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 Datumsformat für die Eingabe Datum/Uhrzeit aus. Alternativ können Sie ein anwenderdefiniertes Format für Datum/Uhrzeit eingeben.

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum/Uhrzeit, Datum oder Fälligkeitsdatum
    • Output Date Format Datums-/Uhrzeit- oder Datumsformat der Ausgabezeichenfolge
    • Custom Format Gültiges Datums-/Uhrzeit- oder Datumsformat, dargestellt als Zeichenfolge. Nur erforderlich, wenn „Anwenderdefiniertes Format“ als Datumsformatausgewählt ist.
    		 Zeichenfolge formatiert wie in angegeben Output Date Format
    Hinweis:
    Wenn Sie einen falschen Eingabepillentyp oder ein ungültiges anwenderdefiniertes Formatverwenden, wird der Flow zur Laufzeit abgebrochen.
    Abbildung : 5. Beispiel
    • Eingabe: 1969-12-31 14:23:57
    • Ausgabedatumsformat: Anwenderdefiniert (unten eingeben)
    • Anwenderdefiniertes Format: „Am“ MMM tt, jjjj „um“ hh:mm a
    • Ausgabe: „Am 31. Dezember 1969 um 14:23“

    In diesem Beispiel ruft der Flow einen Benutzerdatensatz [sys_user] aus der Datenbank einer Drittpartei ab. Die Funktion zum Umwandeln von Datum in Zeichenfolge konvertiert das Format des Felds Erstellt und protokolliert dann Datum, Uhrzeit und Name, 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 Uhrzeitmusterzeichenfolgen angeben. Eine Musterzeichenfolge besteht aus einem oder mehreren Groß- und Kleinbuchstaben von A bis Z. Text in Anführungszeichen wird ignoriert und stattdessen in die Datumsausgabe kopiert.

    Zeichenfolge Beschreibung Ausgabeformat Beispiel
    G Era-Bezeichner Text AD
    y Jahr Jahr 2019; 19
    Y Woche im Jahr Jahr 2019; 19
    M Monat im Jahr (innerhalb des Datums) Monat Juli; Juli; 07
    L Monat im Jahr (eigenständiger Wert) Monat 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 Tagname in der Woche Text Mittwoch; Mi
    u Anzahl der Tage der Woche Nummer 3
    a am oder nachmittags Text Uhr
    H Stunde am Tag von 0 bis 23 Nummer 0
    k Stunde am Tag von 1 bis 24 Nummer 24
    K Stunde in am oder pm von 0 bis 11 Uhr Nummer 0
    S Stunde in am oder pm von 13 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-Standardzeit 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 vom angegebenen Datum/der angegebenen Uhrzeit ab.

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

    Stunde

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

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

    Minute

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

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

    Zweite(r)

    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: 2021-11-20 13:06:12
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Ausgabe: 12

    Monat

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

    Eingabedatenpille Ausgabedatenpille
    Datum/Uhrzeit Ganzzahl: Monatskomponente ab dem angegebenen Datum.
    Abbildung : 11. Beispiel
    • Eingabe: 2021-11-20 13:06:12
    • 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 vom 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 Differenzzeitdauer zur Epochenzeit (1970-01-01 00:00:00).

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum/Uhrzeit, Datum oder Fälligkeitsdatum Datum/Uhrzeit, Datum oder Fälligkeitsdatum Dauer: Zeitdauerdifferenz, addiert zur Epochenzeit (1970-01-01 00:00:00).
    Abbildung : 14. Beispiel
    • Eingabe: 2021-05-02 09:10:12
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Parameter: 07.04.2021 06:02:23
    • Ausgabe: 1970-01-26 03:07:49

    Monatsende

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

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