Datums- und Uhrzeitfunktionen in Adobe Workfront Fusion

Zugriffsanforderungen

Sie müssen über den folgenden Zugriff verfügen, um die Funktionalität in diesem Artikel verwenden zu können:

Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Workfront-Dokumentation.

Informationen zu Adobe Workfront Fusion -Lizenzen finden Sie unter Adobe Workfront Fusion Lizenzen.

Variablen

now

timestamp

Funktionen

addSeconds (date; number)

Gibt infolge des Hinzufügens einer bestimmten Anzahl von Sekunden zu einem Datum ein neues Datum zurück. Geben Sie eine negative Zahl ein, um Sekunden zu subtrahieren.

addMinutes (date; number) addminutes-date-number

Gibt infolge des Hinzufügens einer bestimmten Anzahl von Minuten zu einem Datum ein neues Datum zurück. Geben Sie eine negative Zahl ein, um Minuten zu subtrahieren.

addHours (Datum; Zahl) addhours-date-number

Gibt infolge des Hinzufügens einer bestimmten Anzahl von Stunden zu einem Datum ein neues Datum zurück. Geben Sie eine negative Zahl ein, um Stunden zu subtrahieren.

addDays (date; number) adddays-date-number

Gibt infolge des Hinzufügens einer bestimmten Anzahl von Tagen zu einem Datum ein neues Datum zurück. Um Tage zu subtrahieren, geben Sie eine negative Zahl ein.

addMonths (date; number)

Gibt infolge des Hinzufügens einer bestimmten Anzahl von Monaten zu einem Datum ein neues Datum zurück. Um Monate abzuziehen, geben Sie eine negative Zahl ein.

addYears (date; number)

Gibt infolge des Hinzufügens einer bestimmten Anzahl von Jahren zu einem Datum ein neues Datum zurück. Um Jahre abzuziehen, geben Sie eine negative Zahl ein.

setSecond (Datum; Zahl)

Diese Funktion gibt ein neues Datum mit den in den Parametern angegebenen Sekunden zurück.

Geben Sie eine Zahl zwischen 0 und 59 an. Wenn die Zahl außerhalb dieses Bereichs liegt, gibt die Funktion eine Sekunde aus der vorherigen Minute (für eine negative Zahl) oder aus der darauf folgenden Minute (für eine positive Zahl) zurück.

Wenn Sie eine Zahl außerhalb des Bereichs angeben müssen, empfehlen wir die Verwendung von​ addSeconds, wie oben im Abschnitt addSeconds (date; number) beschrieben.

setMinute (Datum; Zahl)

Diese Funktion gibt ein neues Datum mit den in den Parametern angegebenen Minuten zurück.

Geben Sie eine Zahl zwischen 0 und 59 an. Wenn die Zahl außerhalb dieses Bereichs liegt, gibt die Funktion eine Minute von der vorherigen Stunde (für eine negative Zahl) oder der nachfolgenden Stunde (für eine positive Zahl) zurück.

Wenn Sie eine Zahl außerhalb des Bereichs angeben müssen, empfehlen wir die Verwendung von addMinutes, wie oben unter addMinutes (Datum; Zahl) beschrieben.

setHour (Datum; Zahl)

Diese Funktion gibt ein neues Datum mit der in den Parametern angegebenen Stunde zurück.

Geben Sie eine Zahl zwischen 0 und 23 an. Wenn die Zahl außerhalb dieses Bereichs liegt, gibt die Funktion eine Stunde vom vorherigen Tag (für eine negative Zahl) oder vom darauf folgenden Tag (für eine positive Zahl) zurück.

Wenn Sie eine Zahl außerhalb des Bereichs angeben müssen, empfehlen wir die Verwendung von addHours, wie oben unter addHours (Datum; Zahl) beschrieben.

setDay (Datum; Zahl/Name des Tages in Englisch)

Diese Funktion gibt ein neues Datum mit dem in den Parametern angegebenen Tag zurück.

Sie können diese Funktion verwenden, um den Wochentag mit Sonntag auf 1 und Samstag auf 7 festzulegen. Wenn Sie eine Zahl zwischen 1 und 7 angeben, liegt das resultierende Datum in der aktuellen (Sonntag bis Samstag) Woche. Wenn die Zahl außerhalb dieses Bereichs liegt, gibt die Funktion einen Tag aus der vorherigen Woche (für eine negative Zahl) oder aus der darauffolgenden Woche (für eine positive Zahl) zurück.

Wenn Sie eine Zahl außerhalb des Bereichs angeben müssen, empfehlen wir die Verwendung von addDays, wie oben unter addDays (Datum; Zahl) beschrieben.

setDate (date; number)

Diese Funktion gibt ein neues Datum mit dem in den Parametern angegebenen Tag des Monats zurück.

Geben Sie eine Zahl zwischen 1 und 31 an. Wenn die Zahl außerhalb dieses Bereichs liegt, gibt die Funktion einen Tag aus dem vorherigen Monat (für eine negative Zahl) oder aus dem darauf folgenden Monat (für eine positive Zahl) zurück.

setMonth (Datum; Zahl/Name des Monats in Englisch)

Diese Funktion gibt ein neues Datum mit dem in den Parametern angegebenen Monat zurück.

Geben Sie eine Zahl zwischen 1 und 12 an. Wenn die Zahl außerhalb dieses Bereichs liegt, gibt die Funktion den Monat im Vorjahr (für eine negative Zahl) oder im darauf folgenden Jahr (für eine positive Zahl) zurück.

setYear (date; number)

Gibt ein neues Datum mit dem in den Parametern angegebenen Jahr zurück.

formatDate (date; format; [timezone])

Verwenden Sie diese Funktion, wenn Sie über einen Datumswert wie 12-10-2021 20:30 verfügen, den Sie als Textwert formatieren möchten, z. B. Dec 10, 2021 8:30 PM.

Dies ist beispielsweise nützlich, wenn Sie das Datumsformat einer App oder eines Webdiensts in das einer verbundenen App oder eines Webdiensts ändern müssen.

Weitere Informationen finden Sie unter Datum und Text im Artikel Elementdatentypen in Adobe Workfront Fusion.

Parameter

Wenn ein anderer Typ angegeben wird, wird die Typerzwingung angewendet. Weitere Informationen finden Sie unter Typenzwang in Adobe Workfront Fusion.

Rückgabewert und Typ

Die Funktion formatDate gibt eine Textdarstellung des angegebenen Datumswerts entsprechend dem angegebenen Format und der angegebenen Zeitzone zurück. Der Datentyp ist Text.

INFO

Beispiele: Das Szenario und die Web-Zeitzone wurden in diesen Beispielen jeweils auf Europe/Prague gesetzt.

• formatDate(1. Date created;MM/DD/YYYY)

  Gibt 10.01.2018 zurück

• formatDate(1. Date created; YYYY-MM-DD hh:mm A)

  Gibt 2018-10-01 09:32 Uhr zurück

• formatDate(1. Date created;DD.MM.YYYY HH:mm;UTC)

  Gibt 01.10.2018 07:32 zurück

• formatDate(now;DD.MM.YYYY HH:mm)

  Gibt 19.03.2019 15:30 Uhr zurück

parseDate (text; format; [timezone])

Verwenden Sie diese Funktion, wenn Sie einen Textwert haben, der ein Datum darstellt (z. B. 12-10-2019 20:30 oder Aug 18, 2019 10:00 AM) und ihn in einen Datumswert konvertieren (analysieren) möchten (eine binäre, maschinenlesbare Darstellung). Weitere Informationen finden Sie unter Datum und Text im Artikel Elementdatentypen in Adobe Workfront Fusion.

Parameter

Die zweite Spalte zeigt den erwarteten Typ an. Wenn ein anderer Typ angegeben wird, wird die Typerzwingung angewendet. Weitere Informationen finden Sie unter Typenzwang in Adobe Workfront Fusion.

Wenn ein anderer Typ angegeben wird, wird die Typerzwingung angewendet. Weitere Informationen finden Sie unter Typenzwang in Adobe Workfront Fusion.

Rückgabewert und Typ

Diese Funktion konvertiert eine Textzeichenfolge entsprechend dem angegebenen Format und der angegebenen Zeitzone in ein Datum. Der Datentyp des Werts ist Datum.

dateDifference (Date1; Date2; Unit)

Gibt eine Zahl zurück, die die Differenz der beiden Daten in der angegebenen Einheit darstellt.

Date2 wird von Date1 subtrahiert.

Verwenden Sie einen der folgenden Zeitwerte für den Parameter unit :

Wenn keine Einheit angegeben ist, gibt die Funktion die Differenz in Millisekunden zurück.

Zusätzliche Beispiele

Berechnung des n. Wochentags im Monat

Dieser Abschnitt wurde für Workfront Fusion von der Webseite Exceljet angepasst, auf der erklärt wird, wie der n-te Wochentag in einem Monat abgerufen werden kann.

Wenn Sie ein Datum berechnen müssen, das dem n. Wochentag im Monat entspricht (z. B. erster Dienstag, dritter Freitag usw.), können Sie die folgende Formel verwenden:

{{addDays(setDate(1.date; 1); 1.n * 7 - formatDate(addDays(setDate(1.date; 1); "-" + 1.dow); "E"))}}

Die Formel enthält die folgenden Elemente:

Wenn Sie nur einen bestimmten Fall berechnen möchten, z. B. jeden zweiten Mittwoch, können Sie die Elemente 1.n und 2.dow in der Formel durch entsprechende Zahlen ersetzen. Für den zweiten Mittwoch im aktuellen Monat würden Sie die folgenden Werte verwenden:

Erklärung:

So berechnen Sie Tage zwischen Datumsangaben

Eine Möglichkeit besteht darin, den folgenden Ausdruck zu verwenden:

{{round((2.value - 1.value) / 1000 / 60 / 60 / 24)}}

Berechnung des letzten Tages/der Millisekunde des Monats

Wenn Sie einen Datumsbereich angeben, z. B. in einem Suchmodul, müssen Sie den letzten Tag des Monats berechnen, wenn der Bereich den gesamten vorherigen Monat als geschlossenes Intervall umfasst (das Intervall, das beide Begrenzungspunkte enthält).

2019-09-01 ≤ D ≤ 2019-09-30

Die folgende Formel zeigt eine Methode zur Berechnung des letzten Tages des vorherigen Monats:

{{addDays(setDate(now; 1); -1)}}

In einigen Fällen müssen Sie nicht nur den letzten Tag des Monats berechnen, sondern buchstäblich die letzte Millisekunde:

2019-09-01T00:00:00.000Z ≤ D ≤ 2019-09-30T23:59:59.999Z

Diese Formel zeigt eine Methode zur Berechnung der letzten Millisekunde des Vormonats:

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD"; "UTC") - 1; "x")}}

Wenn Sie das Ergebnis benötigen, um Ihre Zeitzoneneinstellung zu verwenden, lassen Sie das UTC-Argument weg:

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD") - 1; "x")}}

Es ist jedoch vorzuziehen, stattdessen das halboffene Intervall zu verwenden (das Intervall, das einen seiner Grenzpunkte ausschließt), stattdessen den ersten Tag des folgenden Monats anzugeben und den Operator "kleiner oder gleich"wie folgt durch "kleiner als"zu ersetzen:

2019-09-01 ≤ D < 2019-10-01

2019-09-01T00:00:00.000Z ≤ D < 2019-10-01T00:00:00.000Z