Añadir meses

La función addMonths ajusta una fecha determinada en un número determinado de meses, utilizando valores positivos para aumentar y valores negativos para disminuir.

Sintaxis

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

Añadir segundos

El addSeconds ajusta una fecha determinada en un número determinado de segundos, utilizando valores positivos para aumentar y valores negativos para disminuir.

Sintaxis

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

Añadir años

El addYears ajusta una fecha determinada en un número determinado de años, utilizando valores positivos para aumentar y valores negativos para disminuir.

Sintaxis

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

Edad

La función age se usa para recuperar la edad de una fecha determinada.

Sintaxis

 {%= age(datetime) %}

Antigüedad en días

La función ageInDays calcula la antigüedad de una fecha determinada en días, es decir, el número de días transcurridos entre la fecha determinada y la fecha actual, negativos para fechas futuras y positivos para fechas pasadas.

Sintaxis

{%= ageInDays(date) %}
Ejemplo

currentDate = 2025-01-07T12:17:10.720122+05:30 (Asia/Calcuta)

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

Antigüedad en meses

La función ageInMonths calcula la edad de una fecha determinada en meses, es decir, el número de meses transcurridos entre la fecha determinada y la fecha actual, negativos para fechas futuras y positivos para fechas pasadas.

Sintaxis

{%= ageInMonths(date) %}
Ejemplo

currentDate = 2025-01-07T12:22:46.993748+05:30 (Asia/Calcuta)

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

Comparar fechas

La función compareDates compara la fecha de la primera entrada con la otra. Devuelve 0 si fecha1 es igual a fecha2, -1 si fecha1 es anterior a fecha2 y 1 si fecha1 es posterior a fecha2.

Sintaxis

{%= compareDates(date1, date2) %}
Ejemplo
  • Entrada: {%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%}
  • Salida: -1

Convertir ZonedDateTime

La función convertZonedDateTime convierte una fecha y hora en una zona horaria determinada.

Sintaxis

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

Hora actual en milisegundos

La función currentTimeInMillis se usa para recuperar el tiempo actual en milisegundos epoch.

Sintaxis

{%= currentTimeInMillis() %}

Diferencia de fechas

La función dateDiff se usa para recuperar la diferencia entre dos fechas en número de días.

Sintaxis

{%= dateDiff(datetime,datetime) %}

Día del mes

dayOfWeek devuelve el número que representa el día del mes.

Sintaxis

{%= dayOfMonth(datetime) %}
Ejemplo
  • Entrada: {%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %}
  • Salida: 5

Día de la semana

La función dayOfWeek se usa para recuperar el día de la semana.

Sintaxis

{%= dayOfWeek(datetime) %}

Día del año

La función dayOfYear se usa para recuperar el día del año.

Sintaxis

{%= dayOfYear(datetime) %}

Diferencia en segundos

La función diffInSeconds devuelve la diferencia entre dos fechas en términos de segundos.

Sintaxis

{%= diffInSeconds(endDate, startDate) %}
Ejemplo
  • Entrada: {%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%}
  • Salida: 50

Extraer horas

La función extractHours extrae el componente de hora de una marca de tiempo determinada.

Sintaxis

{%= extractHours(date) %}
Ejemplo
  • Entrada: {%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%}
  • Salida: 17

Extraer minutos

La función extractMinutes extrae el componente de minuto de una marca de tiempo determinada.

Sintaxis

{%= extractMinutes(date) %}
Ejemplo
  • Entrada: {%= extractMinute(stringToDate("2024-11-01T17:19:51Z"))%}
  • Salida: 19

Extraer meses

La función extractMonth extrae el componente de mes de una marca de tiempo determinada.

Sintaxis

{%= extractMonths(date) %}
Ejemplo
  • Entrada: {%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%}
  • Salida: 11

Extraer segundos

La función extractSeconds extrae el segundo componente de una marca de tiempo determinada.

Sintaxis

{%= extractSeconds(date) %}
Ejemplo
  • Entrada: {%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%}
  • Salida: 51

Dar formato a fecha

La función formatDate se usa para dar formato a un valor de fecha y hora. El formato debe ser un patrón DateTimeFormat de Java válido.

Sintaxis

{%= formatDate(datetime, format) %}

Donde la primera cadena es el atributo de fecha y el segundo valor es cómo desea que se convierta y muestre la fecha.

NOTE
Si un patrón de fecha no es válido, la fecha volverá a estar en el formato estándar ISO.
Puede utilizar funciones de formato de fecha de Java como se resume en Documentación de Oracle

Ejemplo

La siguiente operación devuelve la fecha con el siguiente formato: MM/DD/AA.

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

Formato de fecha con compatibilidad con configuración regional

La función formatDate se usa para dar formato a un valor de fecha y hora en su representación correspondiente con distinción de idioma, es decir, en una configuración regional deseada. El formato debe ser un patrón DateTimeFormat de Java válido.

Sintaxis

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

Cuando la primera cadena es el atributo de fecha, el segundo valor es cómo desea que se convierta y muestre la fecha y el tercer valor representa la configuración regional en formato de cadena.

NOTE
Si un patrón de fecha no es válido, la fecha volverá a estar en el formato estándar ISO.
Puede utilizar funciones de formato de fecha Java como se resume en Documentación de Oracle.
Puede usar formato y configuraciones regionales válidas, tal como se resume en Documentación de Oracle y Configuraciones regionales compatibles.

Ejemplo

La siguiente operación devuelve la fecha con el siguiente formato: MM/DD/AA y configuración regional FRANCIA.

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

Obtener CurrentZonedDateTime

La función getCurrentZonedDateTime devuelve la fecha y la hora actuales con información de zona horaria.

Sintaxis

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

Diferencia de horas

La función diffInHours devuelve la diferencia entre dos fechas en términos de horas.

Sintaxis

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

Diferencia de minutos

La función diffInMinutes se usa para devolver la diferencia entre dos fechas en términos de minutos.

Sintaxis

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

Diferencia de meses

La función diffInMonths devuelve la diferencia entre dos fechas en términos de meses.

Sintaxis

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

Establecer días

La función setDays se usa para establecer el día del mes para la fecha y hora determinadas.

Sintaxis

{%= setDays(datetime, day) %}

Establecer horas

La función setHours se usa para establecer la hora de la fecha y hora.

Sintaxis

{%= setHours(datetime, hour) %}

A Fecha Hora

La función ToDateTime convierte la cadena en fecha. Devuelve la fecha epoch como salida para una entrada no válida.

Sintaxis

{%= toDateTime(string, string) %}
Ejemplo
  • Entrada: {%=toDateTime("2024-11-01T17:19:51Z")%}
  • Salida: 2024-11-01T17:19:51Z

A UTC

La función toUTC se usa para convertir una fecha y hora en UTC.

Sintaxis

{%= toUTC(datetime) %}

Truncar al inicio del día

La función truncateToStartOfDay se usa para modificar una fecha y hora determinadas al establecerla en el inicio del día con la hora establecida en 00:00.

Sintaxis

{%= truncateToStartOfDay(date) %}
Ejemplo
  • Entrada: {%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %}
  • Salida: 2024-11-01T00:00Z

truncateToStartOfQuarter

La función truncateToStartOfQuarter se usa para truncar una fecha y hora al primer día de su trimestre (por ejemplo, 1 de enero, 1 de abril, 1 de julio, 1 de octubre) a las 00:00.

Sintaxis

{%= truncateToStartOfQuarter(dateTime) %}
Ejemplo
  • Entrada: {%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%}
  • Salida: 2024-10-01T00:00Z

truncateToStartOfWeek

La función truncateToStartOfWeek modifica una fecha y hora determinada al establecerla en el inicio de la semana (lunes a las 00:00).

Sintaxis

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

truncateToStartOfYear

La función truncateToStartOfYear se usa para modificar una fecha y hora determinadas truncándolas al primer día del año (1 de enero) a las 00:00.

Sintaxis

{%= truncateToStartOfYear(dateTime) %}
Ejemplo
  • Entrada: {%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%}
  • Salida: 2024-01-01T00:00Z

Semana del año

La función weekOfYear se usa para recuperar la semana del año.

Sintaxis

{%= weekOfYear(datetime) %}

Diferencia de años

La función diffInYears se usa para devolver la diferencia entre dos fechas en términos de años.

Sintaxis

{%= diffInYears(endDate, startDate) %}: int
Ejemplo
  • Entrada: {%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%}
  • Salida: 5
Página anteriorFunciones de matrices y listas
Página siguienteFunciones booleanas y de comparación

Journey Optimizer