Nesta página
> recursos > documentação > expressões > Funções de data e hora

Funções de data e hora

Funções para extrair componentes de data e hora e realizar operações aritméticas com datas.

Trabalhando com timestamps

No ProcessMind, os timestamps são armazenados como números que representam milissegundos desde 1º de janeiro de 1970 (época Unix). As funções de data trabalham com esses valores de timestamp.

Padrões comuns

  • Extrair partes da data:

    year(StartTime)       // 2024
month(StartTime)      // 3 (March)
day(StartTime)        // 15

  • Calcular duração:

    dateDiff(StartTime, EndTime, "minute")
dateDiff(StartTime, EndTime, "hour")
dateDiff(StartTime, EndTime, "day")

  • Criar intervalos de tempo:

    bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening")

  • Adicionar tempo a uma data:

    dateAdd(StartTime, 7, "day")     // Add 7 days
dateAdd(StartTime, -1, "month")  // Subtract 1 month

now

()

Retorna o timestamp UTC atual, em milissegundos desde a época Unix.

Retorno número
Exemplos
now() → 1708963200000

Timestamp atual

year

(timestamp)

Extrai o ano de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
year(StartTime) → 2024
Veja também
monthdayquarter

month

(timestamp)

Extrai o mês, de 1 a 12, de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
month(StartTime) → 3

Março
Veja também
yeardaymonthName

day

(timestamp)

Extrai o dia do mês, de 1 a 31, de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
day(StartTime) → 18
Veja também
yearmonthdayOfWeek

hour

(timestamp)

Extrai a hora, de 0 a 23, de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
hour(StartTime) → 14

2 PM
Veja também
minutesecond

minute

(timestamp)

Extrai o minuto, de 0 a 59, de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
minute(StartTime) → 30
Veja também
hoursecond

second

(timestamp)

Extrai o segundo, de 0 a 59, de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
second(StartTime) → 45
Veja também
hourminute

dayOfWeek

(timestamp)

Retorna o dia da semana, em que 1 é segunda-feira e 7 é domingo, a partir de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
dayOfWeek(StartTime) → 1

Segunda-feira
Veja também
dayNameday

dayName

(timestamp)

Retorna o nome do dia da semana a partir de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno texto
Exemplos
dayName(StartTime) → Segunda-feira
Veja também
dayOfWeekmonthName

monthName

(timestamp)

Retorna o nome do mês a partir de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno texto
Exemplos
monthName(StartTime) → Março
Veja também
monthdayName

quarter

(timestamp)

Retorna o trimestre, de 1 a 4, a partir de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
quarter(StartTime) → 1

T1 (jan-mar)
Veja também
yearmonth

weekOfYear

(timestamp)

Retorna o número da semana ISO, de 1 a 53, a partir de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
weekOfYear(StartTime) → 12

Semana 12 de 2024
Veja também
dayOfYearyear

dayOfYear

(timestamp)

Retorna o dia do ano, de 1 a 366, a partir de um timestamp.

Parâmetros
timestamp number O valor do timestamp
Retorno número
Exemplos
dayOfYear(StartTime) → 78

78º dia do ano (18 de março de 2024)
Veja também
weekOfYearday

dateAdd

(timestamp, amount, unit)

Adiciona um período especificado a um timestamp.

Parâmetros
timestamp number O timestamp inicial
amount number A quantidade a adicionar, que pode ser negativa
unit string A unidade: 'year', 'month', 'day', 'hour', 'minute', 'second'
Retorno número
Exemplos
dateAdd(StartTime, 7, "day") → timestamp + 7 dias
dateAdd(StartTime, -1, "month") → timestamp - 1 mês
dateAdd(1710766245000, 1, "day") → 1710852645000

Adicionar 1 dia a 18 de março de 2024
Veja também
dateDiff

dateDiff

(startTimestamp, endTimestamp, unit)

Calcula a diferença entre dois timestamps na unidade especificada.

Parâmetros
startTimestamp number O timestamp inicial
endTimestamp number O timestamp final
unit string A unidade: 'day', 'hour', 'minute', 'second'
Retorno número
Exemplos
dateDiff(StartTime, EndTime, "minute") → 150

Duração em minutos

dateDiff(StartTime, EndTime, "hour") → 2.5
Observações

Retorna um valor decimal que representa a diferença exata.
Veja também
dateAdd

isBusinessDay

(timestamp)

Verifica se um timestamp cai em um dia útil, de segunda a sexta-feira.

Parâmetros
timestamp number O timestamp a ser verificado
Retorno booleano
Exemplos
isBusinessDay(StartTime) → true

Se StartTime for um dia útil
Veja também
workingDaysBetweendayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

Conta os dias úteis, de segunda a sexta-feira, entre dois timestamps.

Parâmetros
startTimestamp number O timestamp inicial
endTimestamp number O timestamp final
Retorno número
Exemplos
workingDaysBetween(StartTime, EndTime) → Número de dias úteis entre as datas
workingDaysBetween(1710766245000, 1711371045000) → 5

5 dias úteis entre segunda-feira, 18 de março, e segunda-feira, 25 de março de 2024
Observações

Auxiliar aproximado de backend/calendário comercial. Não considera feriados, apenas fins de semana.
Veja também
isBusinessDaydateDiff

toUtc

(timestamp, offsetHours)

Converte um timestamp local para UTC subtraindo o deslocamento.

Parâmetros
timestamp number O timestamp local
offsetHours number A diferença de fuso horário em horas
Retorno número
Exemplos
toUtc(StartTime, 2) → StartTime - 2 horas

Converter de UTC+2

toUtc(1710766245000, 2) → 1710759045000

Converter o timestamp de UTC+2 para UTC
Observações

A conversão de fuso horário atualmente aceita diferenças numéricas de UTC em horas, não nomes de fusos horários da IANA.
Veja também
toLocalconvertTimezone

toLocal

(timestamp, offsetHours)

Converte um timestamp UTC para o horário local adicionando o deslocamento.

Parâmetros
timestamp number O timestamp UTC
offsetHours number A diferença de fuso horário em horas
Retorno número
Exemplos
toLocal(StartTime, -5) → StartTime - 5 horas

Converter para EST

toLocal(1710766245000, -5) → 1710748245000

Converter timestamp UTC para EST (UTC-5)
Observações

A conversão de fuso horário atualmente aceita diferenças numéricas de UTC em horas, não nomes de fusos horários da IANA.
Veja também
toUtcconvertTimezone

convertTimezone

(timestamp, fromOffset, toOffset)

Converte um timestamp de um fuso horário para outro.

Parâmetros
timestamp number O timestamp a ser convertido
fromOffset number Diferença do fuso horário de origem em horas
toOffset number Diferença do fuso horário de destino em horas
Retorno número
Exemplos
convertTimezone(StartTime, 1, -5) → timestamp ajustado em -6 horas

CET para EST

convertTimezone(1710766245000, 1, -5) → 1710744645000

Converter de UTC+1 para UTC-5
Observações

A conversão de fuso horário atualmente aceita diferenças numéricas de UTC em horas, não nomes de fusos horários da IANA.
Veja também
toUtctoLocal

Tópicos relacionados