Funciones de fecha date-functions
Las funciones de fecha permiten manipular y trabajar con valores de fecha y hora dentro de las expresiones de recorrido. Estas funciones son esenciales para las condiciones basadas en el tiempo, la programación y los cálculos temporales de los recorridos del cliente.
Utilice las funciones de fecha cuando necesite:
- Obtener la hora o fecha actual con el control específico de zona horaria (ahora, nowWithDelta, currentTimeInMillis)
- Compruebe si una fecha está dentro de un intervalo de tiempo específico (inLastDays, inLastHours, inLastMonths, inLastYears, inNextDays, inNextHours, inNextMonths, inNextYears)
- Modificar componentes de fecha y hora (setHours, setDays, updateTimeZone)
- Realizar cálculos y comparaciones basados en el tiempo
- Convertir entre diferentes formatos de tiempo y representaciones
Las funciones de fecha proporcionan un control preciso sobre la lógica temporal, lo que le permite crear rutas y condiciones de recorrido con distinción de tiempo que responden a marcos de tiempo y programaciones específicos.
currentTimeInMillis currentTimeInMillis
Devuelve el tiempo actual en milisegundos epoch.
currentTimeInMillis()currentTimeInMillis()
Devuelve un entero.
currentTimeInMillis()
Devuelve "1544712617131"
inLastDays inLastDays
Devuelve verdadero si un dateTime determinado está entre ahora y ahora (días delta).
inLastDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| delta | entero |
inLastDays(<dateTime>,<integer>)
Devuelve un valor booleano.
inLastDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Devuelve verdadero.
inLastHours inLastHours
Devuelve verdadero si la fecha y hora dadas son entre ahora y ahora (horas delta).
inLastHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| delta | entero |
inLastHours(<dateTime>,<integer>)
Devuelve un valor booleano.
inLastHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Devuelve verdadero.
inLastHours(@event{MyEvent.timestamp}, 4)
Devuelve verdadero.
inLastMonths inLastMonths
Devuelve true si una fecha o dateTime determinada está entre ahora y ahora (meses delta).
inLastMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| delta | entero |
inLastMonths(<dateTime>,<integer>)
Devuelve un valor booleano.
inLastMonths(toDateTime('2023-12-12T01:11:00Z'), 4)
Devuelve verdadero.
inLastYears inLastYears
Devuelve true si una fecha o dateTime determinada está entre ahora y ahora (años delta).
inLastYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| delta | entero |
inLastYears(<dateTime>,<integer>)
Devuelve un valor booleano.
inLastYears(toDateTime('2023-12-12T01:11:00Z'), 4)
Devuelve verdadero.
inNextDays inNextDays
Devuelve true si una fecha o dateTime determinados están entre ahora y ahora + días delta.
inNextDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| delta | entero |
inNextDays(<dateTime>,<integer>)
Devuelve un valor booleano.
inNextDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Devuelve verdadero.
inNextHours inNextHours
Devuelve true si una fecha o dateTime determinada está entre ahora y ahora + horas delta.
inNextHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| delta | entero |
inNextHours(<dateTime>,<integer>)
Devuelve un valor booleano.
inNextHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Devuelve verdadero.
inNextMonths inNextMonths
Devuelve verdadero si una fecha o fechaHora determinada está entre ahora y ahora + meses delta.
inNextMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| delta | entero |
inNextMonths(<dateTime>,<integer>)
Devuelve un valor booleano.
inNextMonths(toDateTime('2023-01-12T01:11:00Z'), 4)
Devuelve verdadero.
inNextYears inNextYears
Devuelve true si una fecha o dateTime determinada está entre ahora y ahora + años delta.
inNextYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| delta | entero |
inNextYears(<dateTime>,<integer>)
Devuelve un valor booleano.
inNextYears(toDateTime('2021-12-12T01:11:00Z'), 4)
Devuelve verdadero.
now now
Devuelve la fecha actual en formato de fecha y hora. Para obtener más información sobre los tipos de datos, consulte esta página.
now(<parameter>)| table 0-row-2 1-row-2 | |
|---|---|
| Parámetro | Descripción |
| cadena | Identificador de zona horaria (opcional) |
now()
now("<timeZone id>")
Devuelve un valor dateTime.
now()
Devuelve 2023-06-03T06:30Z.
toString(now())
Devuelve "2023-06-03T06:30Z"
now("Europe/Paris")
Devuelve 2023-06-03T08:30+02:00.
nowWithDelta nowWithDelta
Devuelve la fecha y hora actuales, incluido un desplazamiento. Si se especifica un ID de zona horaria, se aplica el desplazamiento de zona horaria. Para obtener más información sobre los tipos de datos, consulte esta página.
nowWithDelta(<parameters>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parámetro | Descripción |
| delta | valor entero positivo o negativo |
| parte de fecha | años, meses, días, horas, minutos o segundos como una cadena |
| id de zona horaria | representación de cadena del valor de zona horaria. Para obtener más información, consulte Tipos de datos. El ID de zona horaria debe ser una constante de cadena. No puede ser una referencia de campo ni una expresión. |
nowWithDelta(<delta>,<date part>
nowWithDelta(<delta>,<date part>,"<timeZone id>")
Devuelve un valor dateTime.
nowWithDelta(-2, "hours")
nowWithDelta(-2, "hours", "Europe/Paris")
Devuelve un valor dateTime de hace exactamente 2 horas.
setHours setHours
Establece solo las horas de una fecha, hora u hora. Por ejemplo, si desea esperar hasta una hora determinada mañana, puede forzar la hora.
setHours(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| fecha y hora sin considerar la zona horaria | dateTimeOnly |
| horas | entero |
setHours(<dateTime>,<hours>)
Devuelve una fecha y hora.
setHours(<dateTimeOnly>,<hours>)
Devuelve una fecha y hora sin considerar la zona horaria.
setHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Devuelve 2023-12-12T04:11:00Z.
setHours(nowWithDelta(1, "days"), 20)
Regresa mañana a las 8:XY p.m., siendo XY los minutos en el momento de la evaluación de la hora actual. Si la evaluación se realiza a las 2:45 a. m., la hora devuelta será las 8:45 p. m.
setDays setDays
Establece solo el día de una fecha y hora o la fecha y hora. Por ejemplo, si desea esperar hasta un día determinado del mes, puede forzar el día.
setDays(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parámetro | Tipo |
| fecha y hora | dateTime |
| fecha y hora sin considerar la zona horaria | dateTimeOnly |
| días | entero |
setDays(<dateTime>,<days>)
Devuelve una fecha y hora.
setDays(<dateTimeOnly>,<days>)
Devuelve una fecha y hora sin considerar la zona horaria.
setDays(toDateTime('2023-12-12T01:11:00Z'), 25)
Devuelve 2023-12-25T01:11:00Z.
setDays(toDateTimeOnly(@event{MyEvent.registrationDate}), 1)
updateTimeZone updateTimeZone
Devuelve una nueva fecha y hora, con una nueva zona horaria en el mismo instante.
updateTimeZone(<parameters>)- id de zona horaria: cadena
- dateTime
updateTimeZone(<dateTime>,<timeZone id>)
Devuelve una fecha y hora.
updateTimeZone( toDateTime("2023-08-28T08:15:30.123-07:00"), "Europe/Paris"))
Devuelve 2023-08-28T17:15:30.123+02:00.
updateTimeZone(@event{MyExpEvent.timestamp}, "Australia/Sydney")
Si el valor del campo de marca de tiempo es 2021-11-16T16:55:12.939318+01:00, la función devuelve 2021-11-17T02:55:12.942115+11:00.