Funciones de fecha y hora
Funciones para extraer componentes de fecha y hora y realizar operaciones aritméticas con fechas.
Uso de 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 operan con estos valores.
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") -
Sumar 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 el inicio de la época Unix.
| Devuelve | number |
| Ejemplos | now() → 1708963200000 Marca de tiempo actual |
year
(timestamp)Extrae el año de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | year(StartTime) → 2024 | |||
| Véase también |
month
(timestamp)Extrae el mes (1-12) de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | month(StartTime) → 3 Marzo | |||
| Véase también |
day
(timestamp)Extrae el día del mes (1-31) de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | day(StartTime) → 18 | |||
| Véase también |
hour
(timestamp)Extrae la hora (0-23) de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | hour(StartTime) → 14 14:00 | |||
| Véase también |
minute
(timestamp)Extrae los minutos (0-59) de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | minute(StartTime) → 30 | |||
| Véase también |
second
(timestamp)Extrae los segundos (0-59) de una marca de tiempo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | second(StartTime) → 45 | |||
| Véase también |
dayOfWeek
(timestamp)Devuelve el día de la semana de una marca de tiempo, donde 1 corresponde al lunes y 7 al domingo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | dayOfWeek(StartTime) → 1 Lunes | |||
| Véase también |
dayName
(timestamp)Devuelve el nombre del día de la semana correspondiente a una marca de tiempo.
| Parámetros |
| |||
| Devuelve | string | |||
| Ejemplos | dayName(StartTime) → Lunes | |||
| Véase también |
monthName
(timestamp)Devuelve el nombre del mes correspondiente a una marca de tiempo.
| Parámetros |
| |||
| Devuelve | string | |||
| Ejemplos | monthName(StartTime) → Marzo | |||
| Véase también |
quarter
(timestamp)Devuelve el trimestre (1-4) correspondiente a una marca de tiempo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | quarter(StartTime) → 1 T1 (ene-mar) | |||
| Véase también |
weekOfYear
(timestamp)Devuelve el número de semana ISO (1-53) correspondiente a una marca de tiempo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | weekOfYear(StartTime) → 12 Semana 12 de 2024 | |||
| Véase también |
dayOfYear
(timestamp)Devuelve el día del año (1-366) correspondiente a una marca de tiempo.
| Parámetros |
| |||
| Devuelve | number | |||
| Ejemplos | dayOfYear(StartTime) → 78 Día 78 del año (18 de marzo de 2024) | |||
| Véase también |
dateAdd
(timestamp, amount, unit)Suma una cantidad especificada de tiempo a una marca de tiempo.
| Parámetros |
| |||||||||
| Devuelve | number | |||||||||
| 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 Sumar 1 día al 18/03/2024 | |||||||||
| Véase también |
dateDiff
(startTimestamp, endTimestamp, unit)Calcula la diferencia entre dos marcas de tiempo en la unidad especificada.
| Parámetros |
| |||||||||
| Devuelve | number | |||||||||
| 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 | boolean | |||
| Ejemplos | isBusinessDay(StartTime) → true Si StartTime corresponde a un día entre semana | |||
| Véase también |
workingDaysBetween
(startTimestamp, endTimestamp)Cuenta los días laborables (de lunes a viernes) entre dos marcas de tiempo.
| Parámetros |
| ||||||
| Devuelve | number | ||||||
| Ejemplos | workingDaysBetween(StartTime, EndTime) → Número de días entre semana entre las fechas workingDaysBetween(1710766245000, 1711371045000) → 5 5 días laborables entre el lunes 18 y el lunes 25 de marzo de 2024 | ||||||
| Notas | Función auxiliar aproximada para el backend y el calendario laboral. 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 la diferencia horaria.
| Parámetros |
| ||||||
| Devuelve | number | ||||||
| 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 diferencias numéricas respecto a UTC en horas, pero no nombres de zonas horarias de IANA. | ||||||
| Véase también |
toLocal
(timestamp, offsetHours)Convierte una marca de tiempo UTC a la hora local sumando la diferencia horaria.
| Parámetros |
| ||||||
| Devuelve | number | ||||||
| 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 diferencias numéricas respecto a UTC en horas, pero no nombres de zonas horarias de IANA. | ||||||
| Véase también |
convertTimezone
(timestamp, fromOffset, toOffset)Convierte una marca de tiempo de una zona horaria a otra.
| Parámetros |
| |||||||||
| Devuelve | number | |||||||||
| Ejemplos | convertTimezone(StartTime, 1, -5) → marca de tiempo ajustada -6 horas CET a EST convertTimezone(1710766245000, 1, -5) → 1710744645000 Convertir de UTC+1 a UTC-5 | |||||||||
| Notas | La conversión de zona horaria admite actualmente diferencias numéricas respecto a UTC en horas, pero no nombres de zonas horarias de IANA. | |||||||||
| Véase también |
Temas relacionados
- Descripción general de expresiones: todas las funciones de expresiones.
Diseñe mejores procesos. Conecte su arquitectura. Mantenga el control.
Acceda de inmediato, sin tarjeta de crédito ni esperas. Transforme la forma de trabajar de su organización en diseños de procesos claros y conectados.
Defina la arquitectura de procesos, los responsables y los controles, y alinee las funciones y responsabilidades en todos los niveles.
Comience su prueba gratuita y establezca una base fiable para gobernar, gestionar y mejorar continuamente sus procesos.