Datum- och tidsfunktioner i Adobe Workfront Fusion

Åtkomstkrav

Du måste ha följande åtkomst för att kunna använda funktionerna i den här artikeln:

Mer information om informationen i den här tabellen finns i Åtkomstkrav i Workfront-dokumentationen.

Mer information om Adobe Workfront Fusion licenser finns i Adobe Workfront Fusion licenser.

Variabel

nu

tidsstämpel

Funktioner

addSeconds (date; number)

Returnerar ett nytt datum som ett resultat av att ett visst antal sekunder har lagts till ett datum. Om du vill subtrahera sekunder anger du ett negativt tal.

addMinutes (date; number) addminutes-date-number

Returnerar ett nytt datum som ett resultat av att ett visst antal minuter har lagts till ett datum. Om du vill subtrahera minuter anger du ett negativt tal.

addHours (date; number) addhours-date-number

Returnerar ett nytt datum som ett resultat av att ett visst antal timmar har lagts till ett datum. Om du vill subtrahera timmar anger du ett negativt tal.

addDays (date; number) adddays-date-number

Returnerar ett nytt datum som ett resultat av att ett visst antal dagar har lagts till ett datum. Om du vill subtrahera dagar anger du ett negativt tal.

addMonths (date; number)

Returnerar ett nytt datum som ett resultat av att ett visst antal månader har lagts till ett datum. Om du vill subtrahera månader anger du ett negativt tal.

addYears (date; number)

Returnerar ett nytt datum som ett resultat av att ett visst antal år har lagts till ett datum. Om du vill subtrahera år anger du ett negativt tal.

setSecond (date; number)

Den här funktionen returnerar ett nytt datum med de sekunder som anges i parametrar.

Ange ett tal mellan 0 och 59. Om talet ligger utanför det intervallet returnerar funktionen en sekund från föregående minut (för ett negativt tal) eller efterföljande minut (för ett positivt tal).

Om du behöver ange ett tal utanför intervallet rekommenderar vi att du använder ​ addSeconds, enligt beskrivningen ovan i avsnittet addSeconds (date; number).

setMinute (date; number)

Den här funktionen returnerar ett nytt datum med de minuter som anges i parametrarna.

Ange ett tal mellan 0 och 59. Om talet ligger utanför det intervallet returnerar funktionen en minut från föregående timme (för ett negativt tal) eller efterföljande timme (för ett positivt tal).

Om du behöver ange ett tal utanför intervallet rekommenderar vi att du använder addMinutes enligt beskrivningen ovan i addMinutes (date; number).

setHour (date; number)

Den här funktionen returnerar ett nytt datum med timmen angiven i parametrar.

Ange ett tal mellan 0 och 23. Om talet ligger utanför det här intervallet returnerar funktionen en timme från föregående dag (för ett negativt tal) eller efterföljande dag (för ett positivt tal).

Om du behöver ange ett tal utanför intervallet rekommenderar vi att du använder addHours enligt beskrivningen ovan i addHours (date; number).

setDay (date; number/name of the day in English)

Den här funktionen returnerar ett nytt datum med den dag som anges i parametrar.

Du kan använda den här funktionen för att ange veckodag, med söndag som 1 och lördag som 7. Om du anger ett tal mellan 1 och 7 blir det resulterande datumet inom den aktuella veckan (söndag till lördag). Om talet ligger utanför det intervallet returnerar funktionen en dag från föregående vecka (för ett negativt tal) eller efterföljande vecka (för ett positivt tal).

Om du behöver ange ett tal utanför intervallet rekommenderar vi att du använder addDays enligt beskrivningen ovan i addDays (date; number).

setDate (date; number)

Den här funktionen returnerar ett nytt datum med den dag i månaden som anges i parametrar.

Ange ett tal mellan 1 och 31. Om talet ligger utanför det här intervallet returnerar funktionen en dag från föregående månad (för ett negativt tal) eller efterföljande månad (för ett positivt tal).

setMonth (date; number/name of the month in English)

Den här funktionen returnerar ett nytt datum med den månad som anges i parametrar.

Ange ett tal mellan 1 och 12. Om talet ligger utanför det här intervallet returnerar funktionen månaden under föregående år (för ett negativt tal) eller efterföljande år (för ett positivt tal).

setYear (date; number)

Returnerar ett nytt datum med året angivet i parametrar.

formatDate (date; format; [timezone])

Använd den här funktionen när du har ett datumvärde, till exempel 12-10-2021 20:30, som du vill formatera som ett textvärde, till exempel Dec 10, 2021 8:30 PM.

Detta är praktiskt när du till exempel behöver ändra datumformatet för en app eller webbtjänst till datumformatet för en ansluten app eller webbtjänst i samma scenario.

Mer information finns i Datum och Text i artikeln Objektdatatyper i Adobe Workfront Fusion.

Parametrar

Om en annan typ anges används typtvång. Mer information finns i Typtvång i Adobe Workfront Fusion.

Returvärde och typ

Funktionen formatDate returnerar en textrepresentation av det angivna Date-värdet enligt det angivna formatet och tidszonen. Datatypen är Text.

INFO

Exempel: Scenario och Web timezone var båda inställda på Europe/Prague i dessa exempel.

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

  Returer 2018-10-01

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

  Returnerar 2018-10-01 09:32

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

  Returnerar 01.10.2018 07:32

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

  Returnerar 19.03.2019 15:30

parseDate (text; format; [timezone])

Använd den här funktionen när du har ett textvärde som representerar ett datum (till exempel 12-10-2019 20:30 eller Aug 18, 2019 10:00 AM) och du vill konvertera (parsa) det till ett datumvärde (en binär maskinläsbar representation). Mer information finns i Datum och Text i artikeln Objektdatatyper i Adobe Workfront Fusion.

Parametrar

Den andra kolumnen anger den förväntade typen. Om en annan typ anges används typtvång. Mer information finns i Typtvång i Adobe Workfront Fusion.

Om en annan typ anges används typtvång. Mer information finns i Typtvång i Adobe Workfront Fusion.

Returvärde och typ

Den här funktionen konverterar en textsträng till ett datum enligt det format och den tidszon som du anger. Datatypen för värdet är Date.

dateDifference (Date1; Date2; Unit)

Returnerar ett tal som representerar skillnaden mellan de två datumen, uttryckt i den angivna enheten.

Datum2 subtraheras från datum1.

Använd ett av följande tidsvärden för parametern unit:

Om ingen enhet anges returnerar funktionen differensen i millisekunder.

Ytterligare exempel

Så här beräknar du den n:e veckodagen i månaden

Det här avsnittet är anpassat för Workfront Fusion från webbsidan Exceljet som förklarar hur du hämtar den nionde veckodagen i en månad.

Om du behöver beräkna ett datum som motsvarar den n:e veckodagen i månaden (till exempel den första tisdagen, den tredje fredagen och så vidare) kan du använda följande formel:

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

Formeln innehåller följande artiklar:

Om du bara vill beräkna ett specifikt fall, till exempel varje onsdag, kan du ersätta objekten 1.n och 2.dow i formeln med motsvarande tal. För den andra onsdagen i den aktuella månaden använder du följande värden:

Förklaring:

Beräkna dagar mellan datum

En möjlighet är att använda följande uttryck:

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

Så här beräknar du sista dagen/millisekunden i månaden

När du anger ett datumintervall, till exempel i en sökmodul, måste du beräkna den sista dagen i månaden om intervallet sträcker sig över hela föregående månad som ett slutet intervall (det intervall som innehåller båda gränspunkterna).

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

Formeln nedan visar ett sätt att beräkna den sista dagen i föregående månad:

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

I vissa fall behöver du inte bara beräkna den sista dagen i månaden, utan bokstavligen dess sista millisekund:

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

Den här formeln visar ett sätt att beräkna den sista millisekunddelen i föregående månad:

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

Om du behöver resultatet för att använda tidszonsinställningen utelämnar du UTC-argumentet:

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

Det är dock bättre att använda ett halvöppet intervall i stället (det intervall som utesluter en av sina gränspunkter), ange den första dagen i nästa månad i stället och ersätta operatorn "mindre än eller lika med" med "mindre än" enligt följande:

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

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