Datumtijdfuncties date-time

Datum- en tijdfuncties worden gebruikt om datum- en tijdbewerkingen uit te voeren op waarden in Journey Optimizer.

Dagen toevoegen add-days

De functie addDays past een bepaalde datum met een bepaald aantal dagen aan, gebruikend positieve waarden aan toename en negatieve waarden aan decrement.

Syntaxis

{%= addDays(date, number) %}
Voorbeeld
  • Invoer: {%= addDays(stringToDate("2024-11-01T17:19:51Z"),10) %}
  • Uitvoer: 2024-11-11T17:19:51Z

Uren toevoegen add-hours

De functie addHours past een bepaalde datum met een bepaald aantal uren aan, gebruikend positieve waarden aan toename en negatieve waarden aan decrement.

Syntaxis

{%= addHours(date, number) %}
Voorbeeld
  • Invoer: {%= addHours(stringToDate("2024-11-01T17:19:51Z"),1) %}
  • Uitvoer: 2024-11-01T18:19:51Z

Minuten toevoegen add-minutes

De functie addMinutes past een bepaalde datum met een opgegeven aantal minuten aan, waarbij positieve waarden worden gebruikt voor verhogen en negatieve waarden voor verlagen.

Syntaxis

{%= addMinutes(date, number) %}
Voorbeeld
  • Invoer: {%= addMinutes(stringToDate("2024-11-01T17:59:51Z"),10) %}
  • Uitvoer: 2024-11-01T18:09:51Z

Maanden toevoegen add-months

De functie addMonths past een bepaalde datum met een bepaald aantal maanden aan, gebruikend positieve waarden aan toename en negatieve waarden aan decrement.

Syntaxis

{%= addMonths(date, number) %}
Voorbeeld
  • Invoer: {%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %}
  • Uitvoer: 2025-01-01T17:19:51Z

Seconden toevoegen add-seconds

De functie addSeconds past een bepaalde datum met een bepaald aantal seconden aan, waarbij positieve waarden worden gebruikt om te verhogen en negatieve waarden om te verlagen.

Syntaxis

{%= addSeconds(date, number) %}
Voorbeeld
  • Invoer: {%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %}
  • Uitvoer: 2024-11-01T17:20:01Z

Jaren toevoegen add-years

De functie addYears past een bepaalde datum met een bepaald aantal jaren aan, gebruikend positieve waarden aan toename en negatieve waarden aan decrement.

Syntaxis

{%= addYears(date, number) %}
Voorbeeld
  • Invoer: {%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %}
  • Uitvoer: 2026-11-01T17:19:51Z

Leeftijd age

De functie age wordt gebruikt om de leeftijd vanaf een bepaalde datum op te halen.

Syntaxis

 {%= age(datetime) %}

Leeftijd in dagen age-days

De functie ageInDays berekent de leeftijd van een bepaalde datum in dagen, d.w.z. het aantal dagen dat is verstreken tussen de gegeven datum en de huidige datum, negatief voor toekomstige datums en positief voor eerdere datums.

Syntaxis

{%= ageInDays(date) %}
Voorbeeld

currentDate = 2025-01-07T12 :17: 10.720122+05 :30 (Azië/Kolkata)

  • Invoer: {%= ageInDays(stringToDate("2025-01-01T17:19:51Z"))%}
  • Uitvoer: 5

Leeftijd in maanden age-months

De functie ageInMonths berekent de leeftijd van een bepaalde datum in maanden, d.w.z. het aantal maanden dat is verstreken tussen de gegeven datum en de huidige datum, negatief voor toekomstige datums en positief voor datums in het verleden.

Syntaxis

{%= ageInMonths(date) %}
Voorbeeld

currentDate = 2025-01-07T12 :22: 46.993748+05 :30 (Azië/Kolkata)

  • Invoer: {%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%}
  • Uitvoer: 12

Datums vergelijken compare-dates

De functie compareDates vergelijkt de eerste invoerdatum met de andere. Retourneert 0 als date1 gelijk is aan date2, -1 als date1 voor date2 komt en 1 als date1 na date2 komt.

Syntaxis

{%= compareDates(date1, date2) %}
Voorbeeld
  • Invoer: {%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%}
  • Uitvoer: -1

ZonedDateTime converteren convert-zoned-date-time

De functie convertZonedDateTime zet een datum-tijd om in een bepaalde tijdzone.

Syntaxis

{%= convertZonedDateTime(dateTime, timezone) %}
Voorbeeld
  • Invoer: {%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%}
  • Uitvoer: 2019-02-19T11:39+03:30[Asia/Tehran]

Huidige tijd in milliseconden current-time

De functie currentTimeInMillis wordt gebruikt om de huidige tijd in epoch milliseconds terug te winnen.

Syntaxis

{%= currentTimeInMillis() %}

Datumverschil date-diff

De functie dateDiff wordt gebruikt om het verschil tussen twee datums in aantal dagen op te halen.

Syntaxis

{%= dateDiff(datetime,datetime) %}

Dag van de maand day-month

De dayOfMonth retourneert het getal dat de dag van de maand vertegenwoordigt.

Syntaxis

{%= dayOfMonth(datetime) %}
Voorbeeld
  • Invoer: {%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %}
  • Uitvoer: 5

Dag van de week day-week

De functie dayOfWeek wordt gebruikt om de dag van de week terug te winnen.

Syntaxis

{%= dayOfWeek(datetime) %}

Dag van jaar day-year

De functie dayOfYear wordt gebruikt om de dag van het jaar op te halen.

Syntaxis

{%= dayOfYear(datetime) %}

Binnen seconden diff diff-seconds

De functie diffInSeconds retourneert het verschil tussen twee datums in seconden.

Syntaxis

{%= diffInSeconds(endDate, startDate) %}
Voorbeeld
  • Invoer: {%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%}
  • Uitvoer: 50

Uren extraheren extract-hours

De functie extractHours extraheert de uurcomponent uit een bepaald tijdstempel.

Syntaxis

{%= extractHours(date) %}
Voorbeeld
  • Invoer: {%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 17

Minuten extraheren extract-minutes

De functie extractMinutes extraheert de component minute uit een bepaald tijdstempel.

Syntaxis

{%= extractMinutes(date) %}
Voorbeeld
  • Invoer: {%= extractMinutes(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 19

Maanden uitnemen extract-months

De functie extractMonth extraheert de component month uit een opgegeven tijdstempel.

Syntaxis

{%= extractMonths(date) %}
Voorbeeld
  • Invoer: {%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 11

Seconden extraheren extract-seconds

De functie extractSeconds extraheert de tweede component uit een bepaald tijdstempel.

Syntaxis

{%= extractSeconds(date) %}
Voorbeeld
  • Invoer: {%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 51

Indelingsdatum format-date

De functie formatDate wordt gebruikt om een datumtijdwaarde op te maken. De indeling moet een geldig Java DateTimeFormat-patroon zijn.

Syntaxis

{%= formatDate(datetime, format) %}

Waar de eerste tekenreeks het datumkenmerk is en de tweede waarde hoe u de datum wilt omzetten en weergeven.

NOTE
Als een datumpatroon ongeldig is, wordt de datum teruggezet naar de ISO-standaardindeling.
U kunt de datum die functies gebruiken Java zoals samengevat in ​ documentatie van Oracle ​

Voorbeeld

De volgende bewerking retourneert de datum in de volgende notatie: MM/DD/YY.

{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}

Patroontekens pattern-characters

Sommige patroonletters kunnen er hetzelfde uitzien, maar vertegenwoordigen verschillende concepten.

Patroon
Betekenis
Voorbeeld (voor 2023-12-31T10:15:30Z)
y
Kalenderjaar (standaardjaar)
2023
Y
Weekjaar (ISO 8601). Kan per jaar verschillen.
2024 (sinds 31 december 2023 in de eerste week van 2024 valt)
M
Maand van jaar (1-12 of tekst zoals Jan, January)
12 of Dec
m
Minuut-van-uur (0-59)
15
d
Dag van de maand (1-31)
31
D
Jaar (1-366)
365

Datumnotatie met ondersteuning voor landinstellingen format-date-locale

De functie formatDate kan worden gebruikt om een datumtijdwaarde op te maken in de corresponderende taalgevoelige representatie, d.w.z. in een gewenste landinstelling. De indeling moet een geldig Java DateTimeFormat-patroon zijn.

Syntaxis

{%= formatDate(datetime, format, locale) %}

Waar de eerste tekenreeks het datumkenmerk is, is de tweede waarde hoe u de datum wilt converteren en weergeven en de derde waarde de landinstelling in tekenreeksindeling.

NOTE
Als een datumpatroon ongeldig is, wordt de datum teruggezet naar de ISO-standaardindeling.
U kunt de datum het formatteren functies van Java zoals samengevat in ​ documentatie van Oracle ​ gebruiken.
U kunt het formatteren en geldige scènes gebruiken zoals samengevat in ​ documentatie van Oracle ​ en ​ Gesteunde scènes ​.

Voorbeeld

De volgende bewerking retourneert de datum in de volgende notatie: MM/dd/YY en landinstelling FRANKRIJK.

{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY", "fr_FR") %}

Get CurrentZonedDateTime get-current-zoned-date-time

De functie getCurrentZonedDateTime retourneert de huidige datum en tijd met informatie over de tijdzone.

Syntaxis

{%= getCurrentZonedDateTime() %}
Voorbeeld
  • Invoer: {%= getCurrentZonedDateTime() %}
  • Uitvoer: 2024-12-06T17:22:02.281067+05:30[Asia/Kolkata]

Verschil in uren hours-difference

De functie diffInHours retourneert het verschil tussen twee datums in termen van uren.

Syntaxis

{%= diffInHours(endDate, startDate) %}
Voorbeeld
  • Invoer: {%= diffInHours(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T07:19:51Z"))%}
  • Uitvoer: 10

Verschil in minuten diff-minutes

De functie diffInMinutes wordt gebruikt om het verschil tussen twee datums in termen van minuten te retourneren.

Syntaxis

{%= diffInMinutes(endDate, startDate) %}
Voorbeeld
  • Invoer: {%= diffInMinutes(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T16:19:51Z"))%}
  • Uitvoer: 60

Verschil in maanden months-difference

De functie diffInMonths retourneert het verschil tussen twee datums in termen van maanden.

Syntaxis

{%= diffInMonths(endDate, startDate) %}
Voorbeeld
  • Invoer: {%=diffInMonths(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-08-01T17:19:51Z"))%}
  • Uitvoer: 3

Aantal dagen instellen set-days

De functie setDays wordt gebruikt om de dag van de maand voor de bepaalde datum-tijd te plaatsen.

Syntaxis

{%= setDays(datetime, day) %}

Uren instellen set-hours

De functie setHours wordt gebruikt om het uur van de datum-tijd te plaatsen.

Syntaxis

{%= setHours(datetime, hour) %}

Tot op heden to-date-time

De functie ToDateTime zet een tekenreeks om in datum. De epochdatum wordt geretourneerd als uitvoer voor ongeldige invoer.

Syntaxis

{%= toDateTime(string, string) %}
Voorbeeld
  • Invoer: {%=toDateTime("2024-11-01T17:19:51Z")%}
  • Uitvoer: 2024-11-01T17:19:51Z

Naar UTC to-utc

De functie toUTC wordt gebruikt om een datetime in UTC om te zetten.

Syntaxis

{%= toUTC(datetime) %}

Korten naar begin van dag truncate-day

De truncateToStartOfDay functie wordt gebruikt om een bepaalde datum-tijd te wijzigen door het aan het begin van de dag met de tijd te plaatsen die aan 00 :00 wordt geplaatst.

Syntaxis

{%= truncateToStartOfDay(date) %}
Voorbeeld
  • Invoer: {%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %}
  • Uitvoer: 2024-11-01T00:00Z

truncateToStartOfQuarter truncate-quarter

De functie truncateToStartOfQuarter wordt gebruikt om een datum-tijd tot de eerste dag van zijn kwart (b.v., 1 Jan, 1 Apr, 1 jul, 1 okt 1) om 00 te beknotten :00.

Syntaxis

{%= truncateToStartOfQuarter(dateTime) %}
Voorbeeld
  • Invoer: {%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 2024-10-01T00:00Z

truncateToStartOfWeek truncate-week

De functie truncateToStartOfWeek wijzigt een bepaalde datum-tijd door het aan het begin van de week (Maandag bij 00 :00 te plaatsen).

Syntaxis

{%= truncateToStartOfWeek(dateTime) %}
Voorbeeld
  • Invoer: {%= truncateToStartOfWeek(stringToDate("2024-11-19T17:19:51Z"))%} // tuesday
  • Uitvoer: 2024-11-18T00:00Z // monday

truncateToStartOfYear truncate-year

De truncateToStartOfYear functie wordt gebruikt om een bepaalde datum-tijd te wijzigen door het te beknotten aan de eerste dag van het jaar (Januari 1) bij 00 :00.

Syntaxis

{%= truncateToStartOfYear(dateTime) %}
Voorbeeld
  • Invoer: {%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 2024-01-01T00:00Z

Week van jaar week-of-year

De functie weekOfYear wordt gebruikt om de week van het jaar op te halen.

Syntaxis

{%= weekOfYear(datetime) %}

Verschil in jaren diff-years

De functie diffInYears wordt gebruikt om het verschil tussen twee datums in termen van jaren te retourneren.

Syntaxis

{%= diffInYears(endDate, startDate) %}: int
Voorbeeld
  • Invoer: {%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%}
  • Uitvoer: 5
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76