En esta página

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
timestamp number Valor de la marca de tiempo
Devuelve number
Ejemplos
year(StartTime) → 2024
Véase también

month

(timestamp)

Extrae el mes (1-12) de una marca de tiempo.

Parámetros
timestamp number Valor de la marca de tiempo
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
timestamp number Valor de la marca de tiempo
Devuelve number
Ejemplos
day(StartTime) → 18
Véase también

hour

(timestamp)

Extrae la hora (0-23) de una marca de tiempo.

Parámetros
timestamp number Valor de la marca de tiempo
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
timestamp number Valor de la marca de tiempo
Devuelve number
Ejemplos
minute(StartTime) → 30
Véase también

second

(timestamp)

Extrae los segundos (0-59) de una marca de tiempo.

Parámetros
timestamp number Valor de la marca de tiempo
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
timestamp number Valor de la marca de tiempo
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
timestamp number Valor de la marca de tiempo
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
timestamp number Valor de la marca de tiempo
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
timestamp number Valor de la marca de tiempo
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
timestamp number Valor de la marca de tiempo
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
timestamp number Valor de la marca de tiempo
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
timestamp number Marca de tiempo inicial
amount number Cantidad que se suma; puede ser negativa
unit string Unidad: 'year', 'month', 'day', 'hour', 'minute', 'second'
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
startTimestamp number Marca de tiempo inicial
endTimestamp number Marca de tiempo final
unit string Unidad: 'day', 'hour', 'minute', 'second'
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
timestamp number Marca de tiempo que se comprobará
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
startTimestamp number Marca de tiempo inicial
endTimestamp number Marca de tiempo final
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
timestamp number Marca de tiempo local
offsetHours number Diferencia horaria en horas
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
timestamp number Marca de tiempo UTC
offsetHours number Diferencia horaria en horas
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
timestamp number Marca de tiempo que se convertirá
fromOffset number Diferencia horaria de origen en horas
toOffset number Diferencia horaria de destino en horas
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

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.