Datums- und Uhrzeittransformationsfunktionen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 5 Minuten Lesedauer

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

    Datums- und Uhrzeittransformationsfunktionen erfordern eine Datums-/Uhrzeit- oder Zeichenfolgeneingabe-Datenpille. Einige Funktionen unterstützen auch Datenpillen für die Dauer. Stellen Sie sicher, dass Sie den richtigen Eingabedatenpillentyp verwenden, wenn Sie Datums- und Zeittransformationsfunktionen anwenden. Wenn eine Datums- und Uhrzeittransformationsfunktion 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 der Flow-Laufzeitwerte finden Sie unter Flows testen.

    Hinweis:
    Datums-/Uhrzeitwerte der Laufzeit sind nicht lokalisiert und werden in der Zeitzone UTC (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/einer eingegebenen Uhrzeit, einem Datum, einem Fälligkeitsdatum oder einer Dauer hinzu.

    Eingabedatenpille Parameter Ausgabedatenpille
    Datum/Uhrzeit, Datum, Fälligkeitsdatum oder Dauer
    Hinweis:
    Wenn die Eingabe ein Datum oder ein Fälligkeitsdatum ist, erstellt die Transformation einen vollständigen Datums-/Uhrzeitwert unter Verwendung der Zeitwerte Stunde 0, Minute 0 und Sekunde 0.
    		 Duration - Zeit in Tagen, Stunden, Minuten und Sekunden, die addiert werden soll 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: 2019-09-12 14:00:00

    Zeit abziehen

    Subtrahiert Tage, Stunden, Minuten und/oder Sekunden von der Eingabe für 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 Transformation einen vollständigen Datums-/Uhrzeitwert unter Verwendung der Zeitwerte Stunde 0, Minute 0 und Sekunde 0.
    		 Duration Geben Sie die zu subtrahierende Zeit in Tagen, Stunden, Minuten und Sekunden ein Datum/Uhrzeit: Umgewandelter Datums-/Uhrzeitwert nach Abzug des angegebenen Duration
    Abbildung : 2. Beispiel
    • Eingabe: 2019-09-12 11:00:00
    • Dauer: 2 Tage, 1 Stunde, 5 Minuten, 10 Sekunden
    • Ausgabe: 2019-09-10 09:54:50

    In diesem Beispiel ruft der Flow einen CMDB Configuration Item-Datensatz aus einer Remote-Instanz ab. Die Transformationsfunktion Zeit subtrahieren lokalisiert dann den Wert des Felds Erstellt, indem drei Stunden vom Eingabedatum/-uhrzeit abgezogen 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 Datum/Uhrzeit oder Datumsformat der Eingabezeichenfolge
    • Custom Format Gültiges Datum/Uhrzeit oder Datumsformat, dargestellt als Zeichenfolge. Nur erforderlich, wenn Benutzerdefiniertes Format als Input Date Formatausgewählt ist.
    		 Datum/Uhrzeit
    Hinweis:
    • Wenn der Datums-/Uhrzeitwert für die Eingabe „ Benutzerdefiniertes Format “ unvollständig ist, erstellt die Transformation einen vollständigen Datums-/Uhrzeitwert mit Standarddatums- und -uhrzeitwerten. In einem solchen Fall verwendet die Transformation standardmäßig das aktuelle Jahr, den aktuellen Monat, den Tag 1 eines Monats, die Stunde 0, die Minute 0 und die Sekunde 0. Zum Beispiel der Eingabedatenpillenwert Okt. 2019 und das benutzerdefinierte Datumsformat MMM jjjj erzeugt die Ausgabe 2019-10-01 00:00:00.
    • Wenn Sie einen falschen Datenpillentyp oder ein ungültiges benutzerdefiniertes 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 Benutzerdefiniertes Format für die Eingabe Datum/Uhrzeit eingeben.

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

    In diesem Beispiel ruft der Flow einen Benutzerdatensatz [sys_user] aus einer Drittanbieterdatenbank ab. Die Transformationsfunktion Date to String konvertiert das Format des Felds 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.

    Benutzerdefinierte Datumsformate

    Sie können ein benutzerdefiniertes 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 Name des Tages in der Woche Text Mittwoch; Mi
    u Tag und Nummer der Woche Nummer 3
    a am oder nachmittags Text Uhr
    H Stunde im 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 23 Uhr Nummer 0
    S Stunde in „am“ oder „pm“ von 13 bis 12 Nummer 12
    m Minute in Stunde Nummer 59
    s Sekunde in Minuten Nummer 1
    S Millisekunden 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 aus dem 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 aus dem 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 aus dem 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

    Sekunde

    Ruft die zweite Komponente zum angegebenen Datum/Uhrzeit ab.

    Eingabedatenpille Ausgabedatenpille
    Datum/Uhrzeit Ganzzahl: Zweite Komponente aus 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 angegebenen 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 aus 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 Zeitdifferenz 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, die der Epochenzeit (1970-01-01 00:00:00) hinzugefügt wird.
    Abbildung : 14. Beispiel
    • Eingabe: 2021-05-02 09:10:12
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Parameter: 2021-04-07 06:02:23
    • Ausgabe: 1970-01-26 03:07:49

    Monatsende

    Wertet den letzten Tag des Monats aus, nachdem die angegebene Anzahl von Monaten 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 nach Addition der Anzahl von Monaten zum angegebenen Eingabedatum.
    Abbildung : 15. Beispiel
    • Eingabe: 2021-11-20
    • Eingabedatumsformat: ISO-Datum (2004-06-28)
    • Anzahl der Monate: 3
    • Ausgabe: 2022-02-28