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 cálculos com datas.

Como trabalhar com datas e horas registradas

No ProcessMind, datas e horas registradas são armazenadas como números que representam milissegundos desde 1º de janeiro de 1970 (época Unix). As funções de data trabalham com esses valores.

Padrões comuns

  • Extrair partes da data:

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

  • Calcular a 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 o início da época Unix.

Retorno número
Exemplos
now() → 1708963200000

Timestamp atual

year

(timestamp)

Extrai o ano de um timestamp.

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

month

(timestamp)

Extrai o mês (1-12) de um timestamp.

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

Março
Veja também
yeardaymonthName

day

(timestamp)

Extrai o dia do mês (1-31) de um timestamp.

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

hour

(timestamp)

Extrai a hora (0-23) de um timestamp.

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

14h
Veja também
minutesecond

minute

(timestamp)

Extrai o minuto (0-59) de um timestamp.

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

second

(timestamp)

Extrai o segundo (0-59) de um timestamp.

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

dayOfWeek

(timestamp)

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

Parâmetros
timestamp number 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 correspondente a um timestamp.

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

monthName

(timestamp)

Retorna o nome do mês correspondente a um timestamp.

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

quarter

(timestamp)

Retorna o trimestre (1-4) correspondente a um timestamp.

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

1º trimestre (jan-mar)
Veja também
yearmonth

weekOfYear

(timestamp)

Retorna o número da semana ISO (1-53) correspondente a um timestamp.

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

12ª semana de 2024
Veja também
dayOfYearyear

dayOfYear

(timestamp)

Retorna o dia do ano (1-366) correspondente a um timestamp.

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

78º dia do ano (18/03/2024)
Veja também
weekOfYearday

dateAdd

(timestamp, amount, unit)

Adiciona um intervalo de tempo especificado a um timestamp.

Parâmetros
timestamp number Timestamp inicial
amount number Quantidade a adicionar; pode ser negativa
unit string 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 Data e hora de início
endTimestamp number Timestamp final
unit string 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 Timestamp a verificar
Retorno boolean
Exemplos
isBusinessDay(StartTime) → true

Se StartTime cair em um dia da semana
Veja também
workingDaysBetweendayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

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

Parâmetros
startTimestamp number Data e hora de início
endTimestamp number 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

Função auxiliar aproximada 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 do fuso horário.

Parâmetros
timestamp number Timestamp local
offsetHours number Deslocamento do fuso horário em horas
Retorno número
Exemplos
toUtc(StartTime, 2) → StartTime - 2 horas

Converter de UTC+2

toUtc(1710766245000, 2) → 1710759045000

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

No momento, a conversão de fuso horário aceita deslocamentos numéricos de UTC em horas, mas 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 do fuso horário.

Parâmetros
timestamp number Timestamp UTC
offsetHours number Deslocamento do 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

No momento, a conversão de fuso horário aceita deslocamentos numéricos de UTC em horas, mas 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 Timestamp a converter
fromOffset number Deslocamento do fuso horário de origem em horas
toOffset number Deslocamento 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

No momento, a conversão de fuso horário aceita deslocamentos numéricos de UTC em horas, mas não nomes de fusos horários da IANA.
Veja também
toUtctoLocal

Tópicos relacionados

Melhore seus processos. Crie uma arquitetura conectada. Mantenha o controle.

Acesse na hora, sem cartão de crédito nem espera. Transforme a forma como sua organização trabalha em modelos de processo claros e conectados.

Crie sua arquitetura de processos, defina responsabilidades e controles e alinhe papéis e atribuições em todos os níveis.

Comece o teste grátis e crie uma base confiável para governar, gerenciar e melhorar seus processos continuamente.

Comece hoje seu teste grátis.