Funciones de fecha y hora
Funciones para extraer componentes de fecha y hora y realizar operaciones aritméticas con fechas.
Trabajar con marcas de tiempo
En ProcessMind, las marcas de tiempo se almacenan como números que representan los milisegundos transcurridos desde el 1 de enero de 1970 (época Unix). Las funciones de fecha trabajan con estos valores de marca de tiempo.
Patrones habituales
-
Extraer partes de una fecha:
year(StartTime) // 2024 month(StartTime) // 3 (March) day(StartTime) // 15 -
Calcular la duración:
dateDiff(StartTime, EndTime, "minute") dateDiff(StartTime, EndTime, "hour") dateDiff(StartTime, EndTime, "day") -
Crear intervalos de tiempo:
bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening") -
Añadir tiempo a una fecha:
dateAdd(StartTime, 7, "day") // Add 7 days dateAdd(StartTime, -1, "month") // Subtract 1 month
now
()Devuelve la marca de tiempo UTC actual, en milisegundos desde la época Unix.
| Devuelve | número |
| Ejemplos | now() → 1708963200000 Marca de tiempo actual |
year
(timestamp)Extrae el año de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | year(StartTime) → 2024 | |||
| Véase también |
month
(timestamp)Extrae el mes, del 1 al 12, de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | month(StartTime) → 3 Marzo | |||
| Véase también |
day
(timestamp)Extrae el día del mes, del 1 al 31, de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | day(StartTime) → 18 | |||
| Véase también |
hour
(timestamp)Extrae la hora, de 0 a 23, de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | hour(StartTime) → 14 14:00 | |||
| Véase también |
minute
(timestamp)Extrae el minuto, de 0 a 59, de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | minute(StartTime) → 30 | |||
| Véase también |
second
(timestamp)Extrae el segundo, de 0 a 59, de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | second(StartTime) → 45 | |||
| Véase también |
dayOfWeek
(timestamp)Devuelve el día de la semana, donde 1 es lunes y 7 es domingo, a partir de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | dayOfWeek(StartTime) → 1 Lunes | |||
| Véase también |
dayName
(timestamp)Devuelve el día de la semana por nombre a partir de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | cadena | |||
| Ejemplos | dayName(StartTime) → Lunes | |||
| Véase también |
monthName
(timestamp)Devuelve el nombre del mes a partir de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | cadena | |||
| Ejemplos | monthName(StartTime) → Marzo | |||
| Véase también |
quarter
(timestamp)Devuelve el trimestre, del 1 al 4, a partir de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | quarter(StartTime) → 1 T1 (ene-mar) | |||
| Véase también |
weekOfYear
(timestamp)Devuelve el número de semana ISO, del 1 al 53, a partir de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | weekOfYear(StartTime) → 12 Semana 12 de 2024 | |||
| Véase también |
dayOfYear
(timestamp)Devuelve el día del año, del 1 al 366, a partir de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | número | |||
| Ejemplos | dayOfYear(StartTime) → 78 Día 78 del año (18 de marzo de 2024) | |||
| Véase también |
dateAdd
(timestamp, amount, unit)Añade una cantidad determinada de tiempo a una marca de tiempo.
| Parámetros |
| |||||||||
| Devuelve | número | |||||||||
| Ejemplos | dateAdd(StartTime, 7, "day") → marca de tiempo + 7 días dateAdd(StartTime, -1, "month") → marca de tiempo - 1 mes dateAdd(1710766245000, 1, "day") → 1710852645000 Añadir 1 día al 18 de marzo de 2024 | |||||||||
| Véase también |
dateDiff
(startTimestamp, endTimestamp, unit)Calcula la diferencia entre dos marcas de tiempo en la unidad especificada.
| Parámetros |
| |||||||||
| Devuelve | número | |||||||||
| Ejemplos | dateDiff(StartTime, EndTime, "minute") → 150 Duración en minutos dateDiff(StartTime, EndTime, "hour") → 2.5 | |||||||||
| Notas | Devuelve un valor decimal que representa la diferencia exacta. | |||||||||
| Véase también |
isBusinessDay
(timestamp)Comprueba si una marca de tiempo corresponde a un día laborable, de lunes a viernes.
| Parámetros |
| |||
| Devuelve | booleano | |||
| Ejemplos | isBusinessDay(StartTime) → true Si StartTime corresponde a un día laborable | |||
| Véase también |
workingDaysBetween
(startTimestamp, endTimestamp)Cuenta los días laborables, de lunes a viernes, entre dos marcas de tiempo.
| Parámetros |
| ||||||
| Devuelve | número | ||||||
| Ejemplos | workingDaysBetween(StartTime, EndTime) → Número de días laborables entre las fechas workingDaysBetween(1710766245000, 1711371045000) → 5 5 días laborables entre el lunes 18 de marzo y el lunes 25 de marzo de 2024 | ||||||
| Notas | Ayudante aproximado para el calendario empresarial del backend. No tiene en cuenta los días festivos, solo los fines de semana. | ||||||
| Véase también |
toUtc
(timestamp, offsetHours)Convierte una marca de tiempo local a UTC restando el desfase.
| Parámetros |
| ||||||
| Devuelve | número | ||||||
| Ejemplos | toUtc(StartTime, 2) → StartTime - 2 horas Convertir desde UTC+2 toUtc(1710766245000, 2) → 1710759045000 Convertir la marca de tiempo de UTC+2 a UTC | ||||||
| Notas | La conversión de zona horaria admite actualmente desfases UTC numéricos en horas, no nombres de zonas horarias IANA. | ||||||
| Véase también |
toLocal
(timestamp, offsetHours)Convierte una marca de tiempo UTC a la hora local sumando el desfase.
| Parámetros |
| ||||||
| Devuelve | número | ||||||
| Ejemplos | toLocal(StartTime, -5) → StartTime - 5 horas Convertir a EST toLocal(1710766245000, -5) → 1710748245000 Convertir la marca de tiempo UTC a EST (UTC-5) | ||||||
| Notas | La conversión de zona horaria admite actualmente desfases UTC numéricos en horas, no nombres de zonas horarias IANA. | ||||||
| Véase también |
convertTimezone
(timestamp, fromOffset, toOffset)Convierte una marca de tiempo de una zona horaria a otra.
| Parámetros |
| |||||||||
| Devuelve | número | |||||||||
| Ejemplos | convertTimezone(StartTime, 1, -5) → marca de tiempo ajustada -6 horas De CET a EST convertTimezone(1710766245000, 1, -5) → 1710744645000 Convertir de UTC+1 a UTC-5 | |||||||||
| Notas | La conversión de zona horaria admite actualmente desfases UTC numéricos en horas, no nombres de zonas horarias IANA. | |||||||||
| Véase también |
Temas relacionados
- Descripción general de las expresiones: todas las funciones de expresión.