Datumfunktioner date-functions
Med datumfunktionerna kan du ändra och arbeta med datum- och tidsvärden i dina reseuttryck. Dessa funktioner är viktiga för tidsbaserade förhållanden, schemaläggning och tidsberäkningar i kundresor.
Använd datumfunktioner när du behöver:
- Hämta aktuell tid eller aktuellt datum med specifik hantering av tidszoner (nu, nowWithDelta, currentTimeInMillis)
- Kontrollera om ett datum ligger inom ett visst tidsintervall (inLastDays, inLastHours, inLastMonths, inLastYears, inNextDays, inNextHours, in Nästa månad , inNästaÅr)
- Ändra datum- och tidskomponenter (setHours, setDays, updateTimeZone)
- Tidsbaserade beräkningar och jämförelser
- Konvertera mellan olika tidsformat och representationer
Datumfunktioner ger exakt kontroll över tidslogiken, vilket gör att du kan skapa tidskänsliga resvägar och villkor som svarar på specifika tidsramar och tidsplaner.
currentTimeInMillis currentTimeInMillis
Returnerar aktuell tid i epok i millisekunder.
currentTimeInMillis()currentTimeInMillis()
Returnerar ett heltal.
currentTimeInMillis()
Returnerar "1544712617131".
inLastDays inLastDays
Returnerar true om en viss dateTime är mellan nu och nu - delta-dagar.
inLastDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| delta | heltal |
inLastDays(<dateTime>,<integer>)
Returnerar ett booleskt värde.
inLastDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Returnerar true.
inLastHours inLastHours
Returnerar true om den angivna datumtiden är mellan nu och nu - deltatimmar.
inLastHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| delta | heltal |
inLastHours(<dateTime>,<integer>)
Returnerar ett booleskt värde.
inLastHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Returnerar true.
inLastHours(@event{MyEvent.timestamp}, 4)
Returnerar true.
inLastMonths inLastMonths
Returnerar true om ett givet datum eller dateTime är mellan nu och nu - delta-månader.
inLastMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| delta | heltal |
inLastMonths(<dateTime>,<integer>)
Returnerar ett booleskt värde.
inLastMonths(toDateTime('2023-12-12T01:11:00Z'), 4)
Returnerar true.
inLastYears inLastYears
Returnerar true om ett givet datum eller dateTime är mellan nu och nu - delta-år.
inLastYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| delta | heltal |
inLastYears(<dateTime>,<integer>)
Returnerar ett booleskt värde.
inLastYears(toDateTime('2023-12-12T01:11:00Z'), 4)
Returnerar true.
inNextDays inNextDays
Returnerar true om ett givet datum eller dateTime är mellan nu och nu + delta-dagar.
inNextDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| delta | heltal |
inNextDays(<dateTime>,<integer>)
Returnerar ett booleskt värde.
inNextDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Returnerar true.
inNextHours inNextHours
Returnerar true om ett givet datum eller dateTime är mellan nu och nu + delta-timmar.
inNextHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| delta | heltal |
inNextHours(<dateTime>,<integer>)
Returnerar ett booleskt värde.
inNextHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Returnerar true.
inNextMonths inNextMonths
Returnerar true om ett givet datum eller dateTime är mellan nu och nu + delta-månader.
inNextMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| delta | heltal |
inNextMonths(<dateTime>,<integer>)
Returnerar ett booleskt värde.
inNextMonths(toDateTime('2023-01-12T01:11:00Z'), 4)
Returnerar true.
inNextYears inNextYears
Returnerar true om ett givet datum eller dateTime är mellan nu och nu + delta-år.
inNextYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| delta | heltal |
inNextYears(<dateTime>,<integer>)
Returnerar ett booleskt värde.
inNextYears(toDateTime('2021-12-12T01:11:00Z'), 4)
Returnerar true.
now now
Returnerar aktuellt datum i tidsformat för datum. Mer information om datatyper finns på den här sidan.
now(<parameter>)| table 0-row-2 1-row-2 | |
|---|---|
| Parameter | Beskrivning |
| string | Identifierare för tidszon (valfritt) |
now()
now("<timeZone id>")
Returnerar ett dateTime.
now()
Returnerar 2023-06-03T06:30Z.
toString(now())
Returnerar "2023-06-03T06:30Z"
now("Europe/Paris")
Returnerar 2023-06-03T08 :30+02:00.
nowWithDelta nowWithDelta
Returnerar aktuell datetime inklusive en offset. Om ett tidszon-ID anges används tidszonsförskjutningen. Mer information om datatyper finns på den här sidan.
nowWithDelta(<parameters>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Beskrivning |
| delta | positivt eller negativt heltalsvärde |
| datumdel | år, månader, dagar, timmar, minuter eller sekunder som en sträng |
| tidszon-id | strängbeteckning för tidszonsvärdet. Mer information finns i Datatyper. Tidszons-ID måste vara en strängkonstant. Det kan inte vara en fältreferens eller ett uttryck. |
nowWithDelta(<delta>,<date part>
nowWithDelta(<delta>,<date part>,"<timeZone id>")
Returnerar ett dateTime.
nowWithDelta(-2, "hours")
nowWithDelta(-2, "hours", "Europe/Paris")
Returnerar ett dateTime för exakt 2 timmar sedan.
setHours setHours
Anger endast timmar för datum och tid. Om du till exempel vill vänta en viss timme i morgon kan du tvinga timmen.
setHours(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| datum tid utan att överväga tidszon | dateTimeOnly |
| timmar | heltal |
setHours(<dateTime>,<hours>)
Returnerar en datetime.
setHours(<dateTimeOnly>,<hours>)
Returnerar en datetime utan att ta hänsyn till tidszon.
setHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Returnerar 2023-12-12T04:11:00Z.
setHours(nowWithDelta(1, "days"), 20)
Returnerar imorgon kl. 8:XY PM, XY är minuter vid tidpunkten för den aktuella tidsutvärderingen. Om utvärderingen görs kl. 2:45 är den returnerade tiden 8:45 PM.
setDays setDays
Anger endast dag för datum och tid. Om du t.ex. vill vänta till en viss dag i månaden kan du tvinga fram dagen.
setDays(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Typ |
| tid | dateTime |
| datum tid utan att överväga tidszon | dateTimeOnly |
| dagar | heltal |
setDays(<dateTime>,<days>)
Returnerar en datetime.
setDays(<dateTimeOnly>,<days>)
Returnerar en datetime utan att ta hänsyn till tidszon.
setDays(toDateTime('2023-12-12T01:11:00Z'), 25)
Returnerar 2023-12-25T01:11:00Z.
setDays(toDateTimeOnly(@event{MyEvent.registrationDate}), 1)
updateTimeZone updateTimeZone
Returnerar en ny datumtid, med en ny tidszon på samma gång.
updateTimeZone(<parameters>)- tidszon-id: sträng
- dateTime
updateTimeZone(<dateTime>,<timeZone id>)
Returnerar en datetime.
updateTimeZone( toDateTime("2023-08-28T08:15:30.123-07:00"), "Europe/Paris"))
Returnerar 2023-08-28T17:15:30.123+02:00.
updateTimeZone(@event{MyExpEvent.timestamp}, "Australia/Sydney")
Om tidsstämpelfältets värde är 2021-11-16T16:55:12.939318+01:00 returnerar funktionen 2021-11-17T02:55:12.942115+11:00.