Datum- och tidsfunktioner

Variabler

nu

Hämtar aktuell tid i formatet YYYY-MM-DD-hhss.

tidsstämpel

Hämtar den aktuella tiden som en Unix-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.

Exempel:

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.

Exempel:

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.

Exempel:

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.

Exempel:

addWeekDays(date; number)

[Nytt!]{class="badge informative"}

Lägger till antalet veckodagar till datumet. Endast heltalsvärden läggs till (decimalvärden avrundas nedåt).

Exempel:

addWeekDays("2016-12-08T15:55:57.536Z"; 2)

Returnerar 2016-12-12T15:55:57.536Z
addWeekDays("2016-12-08T15:55:57.536Z"; -2)
Returnerar 2016-12-06T15:55:57.536Z

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.

Exempel:

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.

Exempel:

dayOfMonth(date)

[Nytt!]{class="badge informative"}

Returnerar dagen i månaden för datumet som ett tal mellan 1 och 31.

Exempel:

dayOfWeek(date)

[Nytt!]{class="badge informative"}

Returnerar veckodagen för datumet som ett tal mellan 1 (söndag) och 7 (lördag).

Exempel:

daysInMonth(date)

[Nytt!]{class="badge informative"}

Returnerar det totala antalet dagar i månaden för det angivna datumet.

Exempel:

daysInSplitWeek(date)

[Nytt!]{class="badge informative"}

Returnerar det totala antalet veckodagar mellan datumet och slutet av veckan, eller slutet av månaden, beroende på vilket som inträffar först.

Exempel:

daysInYear(date)

[Nytt!]{class="badge informative"}

Returnerar det totala antalet dagar under året för det angivna datumet (365 för ett regelbundet år, 366 för ett skottår).

Exempel:

dateMax(date1; date2; …)

[Nytt!]{class="badge informative"}

Returnerar det senaste (senaste) datumet från listan.

Exempel:

dateMin(date1; date2; …)

[Nytt!]{class="badge informative"}

Returnerar det tidigaste datumet från listan.

Exempel:

endOfMonth(date)

[Nytt!]{class="badge informative"}

Returnerar det sista momentet i månaden för det angivna datumet - den sista millisekunddelen av den sista dagen (23:59:59.999). Räknar automatiskt med antalet dagar i månaden, inklusive skottår.

Exempel:

hour(date)

[Nytt!]{class="badge informative"}

Returnerar timmen för datumet som ett tal mellan 0 och 23.

Exempel:

isWeekend(date)

[Nytt!]{class="badge informative"}

Returnerar true om datumet infaller på en lördag eller söndag och false för en annan dag. Resultatet avgörs i scenariots konfigurerade tidszon.

Exempel:

minute(date)

[Nytt!]{class="badge informative"}

Returnerar minuten för datumet som ett tal mellan 0 och 59.

Exempel:

month(date)

[Nytt!]{class="badge informative"}

Returnerar månaden för datumet som ett tal mellan 1 och 12.

Exempel:

second(date)

[Nytt!]{class="badge informative"}

Returnerar datumets sekund som ett tal mellan 0 och 59.

Exempel:

startOfMonth(date)

[Nytt!]{class="badge informative"}

Returnerar det första momentet i månaden för det angivna datumet - midnatt den första dagen (00:00:000). Resultatet är tidszonsmedveten.

Exempel:

weekDayDiff(date2; date1)

[Nytt!]{class="badge informative"}

Returnerar antalet veckodagar mellan två datum, vilket motsvarar tidsstämplarna för dessa dagar. Om starttiden till exempel är 3 PM räknas inte startdagen som en hel dag.

Exempel:

workMinutesDiff(date1; date2)

[Nytt!]{class="badge informative"}

Returnerar antalet schemalagda arbetstimmar mellan två datum, baserat på ett standardschema som är måndag-fredag, 09:00-17:00.

Exempel:

year(date)

[Nytt!]{class="badge informative"}

Returnerar datumåret som ett fyrsiffrigt tal.

Exempel:

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; tal).

Exempel:

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; tal).

Exempel:

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; tal).

Exempel:

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; tal).

Exempel:

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).

Exempel:

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).

Exempel:

setYear (date; number)

Returnerar ett nytt datum med året angivet i parametrar.

Exempel:

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.

Parametrar

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

Returvärde och typ

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

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

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.

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.

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

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.

Exempel: I följande exempel uttrycks det returnerade Date-värdet enligt ISO 8601, men datatypen för resultatet ä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.

Exempel:

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