Funzioni data/ora date-time
Le funzioni di data e ora vengono utilizzate per eseguire operazioni di data e ora sui valori all'interno di Journey Optimizer.
Aggiungi giorni add-days
La funzione addDays regola una data specificata di un numero specificato di giorni, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.
Sintassi
{%= addDays(date, number) %}
- Input:
{%= addDays(stringToDate("2024-11-01T17:19:51Z"),10) %} - Output:
2024-11-11T17:19:51Z
Aggiungi ore add-hours
La funzione addHours regola una data specificata di un numero specificato di ore, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.
Sintassi
{%= addHours(date, number) %}
- Input:
{%= addHours(stringToDate("2024-11-01T17:19:51Z"),1) %} - Output:
2024-11-01T18:19:51Z
Aggiungi minuti add-minutes
La funzione addMinutes regola una data specificata di un numero specificato di minuti, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.
Sintassi
{%= addMinutes(date, number) %}
- Input:
{%= addMinutes(stringToDate("2024-11-01T17:59:51Z"),10) %} - Output:
2024-11-01T18:09:51Z
Aggiungi mesi add-months
La funzione addMonths regola una data specificata di un numero specificato di mesi, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.
Sintassi
{%= addMonths(date, number) %}
- Input:
{%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %} - Output:
2025-01-01T17:19:51Z
Aggiungi secondi add-seconds
La funzione addSeconds regola una data specificata di un numero specificato di secondi, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.
Sintassi
{%= addSeconds(date, number) %}
- Input:
{%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %} - Output:
2024-11-01T17:20:01Z
Aggiungi anni add-years
La funzione addYears regola una data specificata di un numero specificato di anni, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.
Sintassi
{%= addYears(date, number) %}
- Input:
{%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %} - Output:
2026-11-01T17:19:51Z
Età age
La funzione age viene utilizzata per recuperare l'età da una data specificata.
Sintassi
{%= age(datetime) %}
Età in giorni age-days
La funzione ageInDays calcola l'età di una data specificata in giorni, ovvero il numero di giorni trascorsi tra la data specificata e la data corrente, negativo per le date future e positivo per le date passate.
Sintassi
{%= ageInDays(date) %}
currentDate = 2025-01-07T12:17:10.720122+05:30 (Asia/Calcutta)
- Input:
{%= ageInDays(stringToDate("2025-01-01T17:19:51Z"))%} - Output:
5
Età in mesi age-months
La funzione ageInMonths calcola l'età di una data specificata in mesi, ovvero il numero di mesi trascorsi tra la data specificata e la data corrente, negativo per le date future e positivo per le date passate.
Sintassi
{%= ageInMonths(date) %}
currentDate = 2025-01-07T12:22:46.993748+05:30(Asia/Calcutta)
- Input:
{%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%} - Output:
12
Confronta date compare-dates
La funzione compareDates confronta la prima data di input con l'altra. Restituisce 0 se data1 è uguale a data2, -1 se data1 precede data2 e 1 se data1 segue data2.
Sintassi
{%= compareDates(date1, date2) %}
- Input:
{%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%} - Output:
-1
Converti DataOraZona convert-zoned-date-time
La funzione convertZonedDateTime converte una data/ora in un determinato fuso orario.
Sintassi
{%= convertZonedDateTime(dateTime, timezone) %}
- Input:
{%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%} - Output:
2019-02-19T11:39+03:30[Asia/Tehran]
Ora corrente in millisecondi current-time
La funzione currentTimeInMillis viene utilizzata per recuperare il tempo corrente in millisecondi epoca.
Sintassi
{%= currentTimeInMillis() %}
Differenza data date-diff
La funzione dateDiff viene utilizzata per recuperare la differenza tra due date in un numero di giorni.
Sintassi
{%= dateDiff(datetime,datetime) %}
Giorno del mese day-month
dayOfMonth restituisce il numero che rappresenta il giorno del mese.
Sintassi
{%= dayOfMonth(datetime) %}
- Input:
{%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %} - Output:
5
Giorno della settimana day-week
La funzione dayOfWeek viene utilizzata per recuperare il giorno della settimana.
Sintassi
{%= dayOfWeek(datetime) %}
Giorno dell’anno day-year
La funzione dayOfYear viene utilizzata per recuperare il giorno dell'anno.
Sintassi
{%= dayOfYear(datetime) %}
Differenza In Secondi diff-seconds
La funzione diffInSeconds restituisce la differenza tra due date in secondi.
Sintassi
{%= diffInSeconds(endDate, startDate) %}
- Input:
{%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%} - Output:
50
Estrai ore extract-hours
La funzione extractHours estrae il componente Ora da un determinato timestamp.
Sintassi
{%= extractHours(date) %}
- Input:
{%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%} - Output:
17
Estrai minuti extract-minutes
La funzione extractMinutes estrae il componente del minuto da un determinato timestamp.
Sintassi
{%= extractMinutes(date) %}
- Input:
{%= extractMinutes(stringToDate("2024-11-01T17:19:51Z"))%} - Output:
19
Estrai mesi extract-months
La funzione extractMonth estrae il componente mese da un determinato timestamp.
Sintassi
{%= extractMonths(date) %}
- Input:
{%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%} - Output:
11
Estrai secondi extract-seconds
La funzione extractSeconds estrae il secondo componente da un determinato timestamp.
Sintassi
{%= extractSeconds(date) %}
- Input:
{%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%} - Output:
51
Formato data format-date
La funzione formatDate viene utilizzata per formattare un valore di data e ora. Il formato deve essere un pattern Java DateTimeFormat valido.
Sintassi
{%= formatDate(datetime, format) %}
Dove la prima stringa è l’attributo data e il secondo valore è il modo in cui desideri che la data venga convertita e visualizzata.
Esempio
L'operazione seguente restituisce la data nel formato seguente: MM/GG/AA.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}
Caratteri pattern pattern-characters
Alcune lettere di serie possono avere un aspetto simile ma rappresentare concetti diversi.
2023-12-31T10:15:30Z)y2023Y2024 (dal 31 dicembre 2023 cade nella prima settimana del 2024)MJan, January)12 o Decm15d31D365Formattare la data con il supporto delle impostazioni internazionali format-date-locale
La funzione formatDate può essere utilizzata per formattare un valore di data e ora nella corrispondente rappresentazione sensibile alla lingua, ovvero in una lingua desiderata. Il formato deve essere un pattern Java DateTimeFormat valido.
Sintassi
{%= formatDate(datetime, format, locale) %}
Dove la prima stringa è l’attributo data, il secondo valore corrisponde al modo in cui la data deve essere convertita e visualizzata e il terzo valore rappresenta la lingua in formato stringa.
Esempio
L'operazione seguente restituisce la data nel formato seguente: MM/gg/AA e impostazioni internazionali FRANCE.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY", "fr_FR") %}
Ottieni CurrentZonedDateTime get-current-zoned-date-time
La funzione getCurrentZonedDateTime restituisce la data e l'ora correnti con le informazioni sul fuso orario.
Sintassi
{%= getCurrentZonedDateTime() %}
- Input:
{%= getCurrentZonedDateTime() %} - Output:
2024-12-06T17:22:02.281067+05:30[Asia/Kolkata]
Differenza ore hours-difference
La funzione diffInHours restituisce la differenza tra due date in termini di ore.
Sintassi
{%= diffInHours(endDate, startDate) %}
- Input:
{%= diffInHours(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T07:19:51Z"))%} - Output:
10
Differenza minuti diff-minutes
La funzione diffInMinutes viene utilizzata per restituire la differenza tra due date in termini di minuti.
Sintassi
{%= diffInMinutes(endDate, startDate) %}
- Input:
{%= diffInMinutes(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T16:19:51Z"))%} - Output:
60
Differenza mesi months-difference
La funzione diffInMonths restituisce la differenza tra due date in termini di mesi.
Sintassi
{%= diffInMonths(endDate, startDate) %}
- Input:
{%=diffInMonths(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-08-01T17:19:51Z"))%} - Output:
3
Imposta giorni set-days
La funzione setDays viene utilizzata per impostare il giorno del mese per la data/ora specificata.
Sintassi
{%= setDays(datetime, day) %}
Imposta ore set-hours
La funzione setHours viene utilizzata per impostare l'ora della data/ora.
Sintassi
{%= setHours(datetime, hour) %}
A Data/Ora to-date-time
La funzione ToDateTime converte la stringa in data. In caso di input non valido, restituisce la data epoca come output.
Sintassi
{%= toDateTime(string, string) %}
- Input:
{%=toDateTime("2024-11-01T17:19:51Z")%} - Output:
2024-11-01T17:19:51Z
A UTC to-utc
La funzione toUTC viene utilizzata per convertire un datetime in UTC.
Sintassi
{%= toUTC(datetime) %}
Tronca all'inizio del giorno truncate-day
La funzione truncateToStartOfDay viene utilizzata per modificare una data/ora specificata impostandola sull'inizio del giorno con l'ora impostata su 00:00.
Sintassi
{%= truncateToStartOfDay(date) %}
- Input:
{%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %} - Output:
2024-11-01T00:00Z
truncateToStartOfQuarter truncate-quarter
La funzione truncateToStartOfQuarter viene utilizzata per troncare una data/ora al primo giorno del trimestre (ad esempio 1 gennaio, 1 aprile, 1 luglio, 1 ottobre) alle 00:00.
Sintassi
{%= truncateToStartOfQuarter(dateTime) %}
- Input:
{%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%} - Output:
2024-10-01T00:00Z
truncateToStartOfWeek truncate-week
La funzione truncateToStartOfWeek modifica una data/ora specificata impostandola all'inizio della settimana (lunedì alle 00:00).
Sintassi
{%= truncateToStartOfWeek(dateTime) %}
- Input:
{%= truncateToStartOfWeek(stringToDate("2024-11-19T17:19:51Z"))%} // tuesday - Output:
2024-11-18T00:00Z // monday
truncateToStartOfYear truncate-year
La funzione truncateToStartOfYear viene utilizzata per modificare una data/ora specificata troncandola al primo giorno dell'anno (1 gennaio) alle 00:00.
Sintassi
{%= truncateToStartOfYear(dateTime) %}
- Input:
{%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%} - Output:
2024-01-01T00:00Z
Settimana dell’anno week-of-year
La funzione weekOfYear viene utilizzata per recuperare la settimana dell'anno.
Sintassi
{%= weekOfYear(datetime) %}
Differenza anni diff-years
La funzione diffInYears viene utilizzata per restituire la differenza tra due date in termini di anni.
Sintassi
{%= diffInYears(endDate, startDate) %}: int
- Input:
{%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%} - Output:
5