Datumfuncties date-functions
Met Date-functies kunt u datum- en tijdwaarden bewerken en gebruiken in uw reisexpressies. Deze functies zijn essentieel voor op tijd-gebaseerde voorwaarden, planning, en tijdberekeningen in uw klantenreizen.
Gebruik datumfuncties wanneer u dit moet doen:
- Krijg de huidige tijd of de datum met specifieke timezone behandeling ( nu , nowWithDelta , currentTimeInMillis )
- Controle als een datum binnen een specifieke tijdwaaier valt ( inLastDays , inLastHours , inLastMonths , inLastYaren , inNextDays , inNextHours , NextMonths , inNextYear )
- Wijzig datum en tijdcomponenten ( setHours , setDays , updateTimeZone )
- Op tijd gebaseerde berekeningen en vergelijkingen uitvoeren
- Omzetten tussen verschillende tijdnotaties en weergaven
De functies van de datum verstrekken nauwkeurige controle over tijdslogica, toestaand u om tijd-gevoelige reiswegen en voorwaarden tot stand te brengen die aan specifieke tijdkaders en programma's antwoorden.
currentTimeInMillis currentTimeInMillis
Geeft de huidige tijd in epoch milliseconds.
currentTimeInMillis()currentTimeInMillis()
Retourneert een geheel getal.
currentTimeInMillis()
Retourneert "1544712617131".
inLastDays inLastDays
Geeft als resultaat waar als een bepaalde dateTime tussen nu en nu is - delta dagen.
inLastDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| delta | integer |
inLastDays(<dateTime>,<integer>)
Retourneert een Booleaanse waarde.
inLastDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Retourneert true.
inLastHours inLastHours
Retourneert true als de opgegeven datumtijd tussen nu en nu ligt - delta-uren.
inLastHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| delta | integer |
inLastHours(<dateTime>,<integer>)
Retourneert een Booleaanse waarde.
inLastHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Retourneert true.
inLastHours(@event{MyEvent.timestamp}, 4)
Retourneert true.
inLastMonths inLastMonths
Retourneert true als een bepaalde datum of dateTime zich tussen nu en nu bevindt - delta-maanden.
inLastMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| delta | integer |
inLastMonths(<dateTime>,<integer>)
Retourneert een Booleaanse waarde.
inLastMonths(toDateTime('2023-12-12T01:11:00Z'), 4)
Retourneert true.
inLastYears inLastYears
Retourneert true als een bepaalde datum of dateTime zich tussen nu en nu bevindt - delta-jaren.
inLastYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| delta | integer |
inLastYears(<dateTime>,<integer>)
Retourneert een Booleaanse waarde.
inLastYears(toDateTime('2023-12-12T01:11:00Z'), 4)
Retourneert true.
inNextDays inNextDays
Retourneert true als een bepaalde datum of dateTime zich tussen nu en nu + delta dagen bevindt.
inNextDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| delta | integer |
inNextDays(<dateTime>,<integer>)
Retourneert een Booleaanse waarde.
inNextDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Retourneert true.
inNextHours inNextHours
Retourneert true als een bepaalde datum of dateTime zich tussen nu en nu + delta-uren bevindt.
inNextHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| delta | integer |
inNextHours(<dateTime>,<integer>)
Retourneert een Booleaanse waarde.
inNextHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Retourneert true.
inNextMonths inNextMonths
Retourneert true als een bepaalde datum of dateTime zich tussen nu en nu + delta maanden bevindt.
inNextMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| delta | integer |
inNextMonths(<dateTime>,<integer>)
Retourneert een Booleaanse waarde.
inNextMonths(toDateTime('2023-01-12T01:11:00Z'), 4)
Retourneert true.
inNextYears inNextYears
Retourneert true als een bepaalde datum of dateTime zich tussen nu en nu + delta jaar bevindt.
inNextYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| delta | integer |
inNextYears(<dateTime>,<integer>)
Retourneert een Booleaanse waarde.
inNextYears(toDateTime('2021-12-12T01:11:00Z'), 4)
Retourneert true.
now now
Retourneert de huidige datum in de datumtijdnotatie. Voor meer informatie over gegevenstypes, verwijs naar deze pagina .
now(<parameter>)| table 0-row-2 1-row-2 | |
|---|---|
| Parameter | Beschrijving |
| string | Identificatiecode tijdzone (optioneel) |
now()
now("<timeZone id>")
Retourneert een dateTime.
now()
Keert 2023-06-03T06 :30Z terug.
toString(now())
Retourneert "2023-06-03T06 :30Z"
now("Europe/Paris")
Keert 2023-06-03T08 :30+02 :00 terug.
nowWithDelta nowWithDelta
Retourneert de huidige datumtijd inclusief een verschuiving. Als een tijdzone-id wordt opgegeven, wordt de verschuiving van de tijdzone toegepast. Voor meer informatie over gegevenstypes, verwijs naar deze pagina .
nowWithDelta(<parameters>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Beschrijving |
| delta | positieve of negatieve gehele waarde |
| datumonderdeel | jaar, maanden, dagen, uren, minuten of seconden als een tekenreeks |
| tijdzone-id | tekenreeksrepresentatie van de tijdzonewaarde. Voor meer, zie types van Gegevens . Tijdzone-id moet een tekenreeksconstante zijn. Het kan geen veldverwijzing of expressie zijn. |
nowWithDelta(<delta>,<date part>
nowWithDelta(<delta>,<date part>,"<timeZone id>")
Retourneert een dateTime.
nowWithDelta(-2, "hours")
nowWithDelta(-2, "hours", "Europe/Paris")
Retourneert precies 2 uur geleden een dateTime.
setHours setHours
Hiermee stelt u alleen de uren van een datumtijd of datumtijd in. Als u bijvoorbeeld tot een bepaald uur wilt wachten, kunt u het uur forceren.
setHours(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| datumtijd zonder tijdzone te overwegen | dateTimeOnly |
| uren | integer |
setHours(<dateTime>,<hours>)
Retourneert een datetime.
setHours(<dateTimeOnly>,<hours>)
Retourneert een datetime zonder rekening te houden met tijdzone.
setHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Keert 2023-12-12T04 :11: 00Z terug.
setHours(nowWithDelta(1, "days"), 20)
Keert morgen bij 8 :XY PM terug, XY die de notulen op het ogenblik van de huidige tijdevaluatie zijn. Als de evaluatie bij 2 :45 AM gebeurt, zal de teruggekeerde tijd 8 :45 PM zijn.
setDays setDays
Hiermee stelt u alleen de dag van een datumtijd of datumtijd in. Als u bijvoorbeeld wilt wachten tot een bepaalde dag van de maand, kunt u de dag forceren.
setDays(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Type |
| datumtijd | dateTime |
| datumtijd zonder tijdzone te overwegen | dateTimeOnly |
| dagen | integer |
setDays(<dateTime>,<days>)
Retourneert een datetime.
setDays(<dateTimeOnly>,<days>)
Retourneert een datetime zonder rekening te houden met tijdzone.
setDays(toDateTime('2023-12-12T01:11:00Z'), 25)
Keert 2023-12-25T01 :11: 00Z terug.
setDays(toDateTimeOnly(@event{MyEvent.registrationDate}), 1)
updateTimeZone updateTimeZone
Retourneert een nieuwe datumtijd met een nieuwe tijdzone op hetzelfde moment.
updateTimeZone(<parameters>)- tijdzone-id: tekenreeks
- dateTime
updateTimeZone(<dateTime>,<timeZone id>)
Retourneert een datetime.
updateTimeZone( toDateTime("2023-08-28T08:15:30.123-07:00"), "Europe/Paris"))
Keert 2023-08-28T17 :15: 30.123+02 :00 terug.
updateTimeZone(@event{MyExpEvent.timestamp}, "Australia/Sydney")
Als de waarde van het tijdstempelveld 2021-11-16T16:55:12.939318+01:00 is, retourneert de functie 2021-11-17T02:55:12.942115+11:00 .