Funktioner för datum och tid date-time
Datum- och tidsfunktioner används för att utföra datum- och tidsåtgärder på värden inom Journey Optimizer.
Lägg till dagar add-days
Funktionen addDays justerar ett givet datum med ett angivet antal dagar och använder positiva värden för att öka och negativa värden för minskning.
Syntax
{%= addDays(date, number) %}
- Indata:
{%= addDays(stringToDate("2024-11-01T17:19:51Z"),10) %} - Utdata:
2024-11-11T17:19:51Z
Lägg till timmar add-hours
Funktionen addHours justerar ett givet datum med ett angivet antal timmar, och använder positiva värden för att öka och negativa värden för minskning.
Syntax
{%= addHours(date, number) %}
- Indata:
{%= addHours(stringToDate("2024-11-01T17:19:51Z"),1) %} - Utdata:
2024-11-01T18:19:51Z
Lägg till minuter add-minutes
Funktionen addMinutes justerar ett givet datum med ett angivet antal minuter och använder positiva värden för att öka och negativa värden för minskning.
Syntax
{%= addMinutes(date, number) %}
- Indata:
{%= addMinutes(stringToDate("2024-11-01T17:59:51Z"),10) %} - Utdata:
2024-11-01T18:09:51Z
Lägg till månader add-months
Funktionen addMonths justerar ett givet datum med ett angivet antal månader och använder positiva värden för att öka och negativa värden för minskning.
Syntax
{%= addMonths(date, number) %}
- Indata:
{%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %} - Utdata:
2025-01-01T17:19:51Z
Lägg till sekunder add-seconds
Funktionen addSeconds justerar ett givet datum med ett angivet antal sekunder och använder positiva värden för att öka och negativa värden för minskning.
Syntax
{%= addSeconds(date, number) %}
- Indata:
{%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %} - Utdata:
2024-11-01T17:20:01Z
Lägg till år add-years
Funktionen addYears justerar ett givet datum med ett angivet antal år och använder positiva värden för att öka och negativa värden för minskning.
Syntax
{%= addYears(date, number) %}
- Indata:
{%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %} - Utdata:
2026-11-01T17:19:51Z
Ålder age
Funktionen age används för att hämta åldern från ett visst datum.
Syntax
{%= age(datetime) %}
Ålder i dagar age-days
Funktionen ageInDays beräknar ett visst datums ålder i dagar, dvs. antalet dagar som förflutit mellan det angivna datumet och det aktuella datumet, negativa för framtida datum och positiva för tidigare datum.
Syntax
{%= ageInDays(date) %}
currentDate = 2025-01-07T12:17:10.720122+05:30 (Asien/Kolkata)
- Indata:
{%= ageInDays(stringToDate("2025-01-01T17:19:51Z"))%} - Utdata:
5
Ålder i månader age-months
Funktionen ageInMonths beräknar åldern för ett givet datum i månader, dvs. antalet månader som förflutit mellan det angivna datumet och det aktuella datumet, negativa för framtida datum och positiva för tidigare datum.
Syntax
{%= ageInMonths(date) %}
currentDate = 2025-01-07T12:22:46.993748+05:30(Asia/Kolkata)
- Indata:
{%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%} - Utdata:
12
Jämför datum compare-dates
Funktionen compareDates jämför det första indatadatumet med det andra. Returnerar 0 om date1 är lika med date2, -1 om date1 kommer före date2 och 1 om date1 kommer efter date2.
Syntax
{%= compareDates(date1, date2) %}
- Indata:
{%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%} - Utdata:
-1
Konvertera ZonedDateTime convert-zoned-date-time
Funktionen convertZonedDateTime konverterar ett datum/tid till en given tidszon.
Syntax
{%= convertZonedDateTime(dateTime, timezone) %}
- Indata:
{%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%} - Utdata:
2019-02-19T11:39+03:30[Asia/Tehran]
Aktuell tid i millisekunder current-time
Funktionen currentTimeInMillis används för att hämta aktuell tid i epok i millisekunder.
Syntax
{%= currentTimeInMillis() %}
Datumdifferens date-diff
Funktionen dateDiff används för att hämta skillnaden mellan två datum i antal dagar.
Syntax
{%= dateDiff(datetime,datetime) %}
Dag i månaden day-month
dayOfMonth returnerar talet som representerar dagen i månaden.
Syntax
{%= dayOfMonth(datetime) %}
- Indata:
{%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %} - Utdata:
5
Veckodag day-week
Funktionen dayOfWeek används för att hämta veckodag.
Syntax
{%= dayOfWeek(datetime) %}
Dag på året day-year
Funktionen dayOfYear används för att hämta dagen på året.
Syntax
{%= dayOfYear(datetime) %}
Skillnad i sekunder diff-seconds
Funktionen diffInSeconds returnerar skillnaden mellan två datum i sekunder.
Syntax
{%= diffInSeconds(endDate, startDate) %}
- Indata:
{%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%} - Utdata:
50
Extrahera timmar extract-hours
Funktionen extractHours extraherar timkomponenten från en given tidsstämpel.
Syntax
{%= extractHours(date) %}
- Indata:
{%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%} - Utdata:
17
Extrahera minuter extract-minutes
Funktionen extractMinutes extraherar minutkomponenten från en given tidsstämpel.
Syntax
{%= extractMinutes(date) %}
- Indata:
{%= extractMinutes(stringToDate("2024-11-01T17:19:51Z"))%} - Utdata:
19
Extrahera månader extract-months
Funktionen extractMonth extraherar månadskomponenten från en viss tidsstämpel.
Syntax
{%= extractMonths(date) %}
- Indata:
{%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%} - Utdata:
11
Extrahera sekunder extract-seconds
Funktionen extractSeconds extraherar den andra komponenten från en viss tidsstämpel.
Syntax
{%= extractSeconds(date) %}
- Indata:
{%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%} - Utdata:
51
Formateringsdatum format-date
Funktionen formatDate används för att formatera ett datum/tid-värde. Formatet ska vara ett giltigt Java DateTimeFormat-mönster.
Syntax
{%= formatDate(datetime, format) %}
Där den första strängen är datumattributet och det andra värdet är hur du vill att datumet ska konverteras och visas.
Exempel
Följande åtgärd returnerar datumet i följande format: MM/DD/YY.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}
Mönstertecken pattern-characters
Vissa mönsterbokstäver kan se likadana ut men representerar olika koncept.
2023-12-31T10:15:30Z)y2023Y2024 (sedan 31 december 2023 infaller under den första veckan 2024)MJan, January)12 eller Decm15d31D365Formatera datum med språkstöd format-date-locale
Funktionen formatDate kan användas för att formatera ett datum- och tidvärde till motsvarande språkkänsliga representation, dvs. i ett önskat språkområde. Formatet ska vara ett giltigt Java DateTimeFormat-mönster.
Syntax
{%= formatDate(datetime, format, locale) %}
Där den första strängen är datumattributet är det andra värdet hur du vill att datumet ska konverteras och visas och det tredje värdet representerar språkinställningen i strängformat.
Exempel
Följande åtgärd returnerar datumet i följande format: MM/dd/YY och språkområde FRANCE.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY", "fr_FR") %}
Hämta CurrentZonedDateTime get-current-zoned-date-time
Funktionen getCurrentZonedDateTime returnerar aktuellt datum och aktuell tid med tidszonsinformation.
Syntax
{%= getCurrentZonedDateTime() %}
- Indata:
{%= getCurrentZonedDateTime() %} - Utdata:
2024-12-06T17:22:02.281067+05:30[Asia/Kolkata]
Timskillnad hours-difference
Funktionen diffInHours returnerar skillnaden mellan två datum i timmar.
Syntax
{%= diffInHours(endDate, startDate) %}
- Indata:
{%= diffInHours(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T07:19:51Z"))%} - Utdata:
10
Minutdifferens diff-minutes
Funktionen diffInMinutes används för att returnera skillnaden mellan två datum i minuter.
Syntax
{%= diffInMinutes(endDate, startDate) %}
- Indata:
{%= diffInMinutes(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T16:19:51Z"))%} - Utdata:
60
Månadsskillnad months-difference
Funktionen diffInMonths returnerar skillnaden mellan två datum i månader.
Syntax
{%= diffInMonths(endDate, startDate) %}
- Indata:
{%=diffInMonths(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-08-01T17:19:51Z"))%} - Utdata:
3
Ange dagar set-days
Funktionen setDays används för att ange dag i månaden för angivet datum/tid.
Syntax
{%= setDays(datetime, day) %}
Ange timmar set-hours
Funktionen setHours används för att ange timmen för datum-tid.
Syntax
{%= setHours(datetime, hour) %}
Till datum och tid to-date-time
Funktionen ToDateTime konverterar sträng till datum. Det returnerar epokdatumet som utdata för ogiltiga indata.
Syntax
{%= toDateTime(string, string) %}
- Indata:
{%=toDateTime("2024-11-01T17:19:51Z")%} - Utdata:
2024-11-01T17:19:51Z
Till UTC to-utc
Funktionen toUTC används för att konvertera en datetime till UTC.
Syntax
{%= toUTC(datetime) %}
Trunkera till början av dagen truncate-day
Funktionen truncateToStartOfDay används för att ändra ett givet datum/tid genom att ställa in den på början av dagen med tiden inställd på 0:00.
Syntax
{%= truncateToStartOfDay(date) %}
- Indata:
{%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %} - Utdata:
2024-11-01T00:00Z
truncateToStartOfQuarter truncate-quarter
Funktionen truncateToStartOfQuarter används för att korta av ett datum/tid till den första dagen i kvarteret (t.ex. Jan 1, Apr 1, Jul 1, Oct 1) kl. 00:00.
Syntax
{%= truncateToStartOfQuarter(dateTime) %}
- Indata:
{%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%} - Utdata:
2024-10-01T00:00Z
truncateToStartOfWeek truncate-week
Funktionen truncateToStartOfWeek ändrar ett visst datum/tid genom att ställa in det till veckans början (måndag 0:00).
Syntax
{%= truncateToStartOfWeek(dateTime) %}
- Indata:
{%= truncateToStartOfWeek(stringToDate("2024-11-19T17:19:51Z"))%} // tuesday - Utdata:
2024-11-18T00:00Z // monday
truncateToStartOfYear truncate-year
Funktionen truncateToStartOfYear används för att ändra ett visst datum-tid genom att trunkera den till årets första dag (1 januari) kl. 00:00.
Syntax
{%= truncateToStartOfYear(dateTime) %}
- Indata:
{%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%} - Utdata:
2024-01-01T00:00Z
Vecka på året week-of-year
Funktionen weekOfYear används för att hämta årets vecka.
Syntax
{%= weekOfYear(datetime) %}
Årets skillnad diff-years
Funktionen diffInYears används för att returnera skillnaden mellan två datum i termer av år.
Syntax
{%= diffInYears(endDate, startDate) %}: int
- Indata:
{%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%} - Utdata:
5