Use funções de data e hora em Fórmulas

Publicado em 8 maio

Use fórmulas avançadas para fazer cálculos usando funções de data e hora.

O que você precisará

Variáveis cercadas por {} nas seções a seguir são variáveis opcionais e podem ser deixadas de fora de uma função sem que a função quebre. Certifique-se de que os parênteses sejam reconhecidos em suas Fórmulas ou você receberá uma mensagem de erro.

Funções simples de data e hora

Abaixo está uma tabela das nossas funções de data e hora mais simples. Todas as entradas são objetos de data e todas as saídas são números, exceto por TODAY() que não tem entradas e simplesmente retorna uma data correspondente à data do dia atual.

Sintaxe Exemplo Resultado Esperado
DAY(data) DAY('7/15/21') 15
DAYS(data_fim, data_inicio) DAYS('7/15/21', '6/15/21') 30
MONTH(data) MONTH('7/15/21') 7
TODAY() TODAY() Hoje
YEAR(data) YEAR('7/15/21') 2021

Funções complexas de data e hora

Abaixo está uma tabela de funções de data e hora mais complexas.

Sintaxe Descrição Exemplo Resultado Esperado
DATE(ano, mês, dia) Esta função recebe três números e retorna um objeto de data correspondente aos números que foram inseridos. DATE(2021, 7, 15) 7/15/21
EDATE(data_inicio, meses)

Esta função recebe um objeto de data (data_inicio) e um número (meses), e retorna uma data representando um número especificado de meses antes ou depois da data_inicio. Números negativos permitirão acessar meses antes da data_inicio.

Como esta função retorna um número serial em vez de um objeto de data, você precisará usar a função DATE() para convertê-lo em um objeto de data.

DATE(YEAR(EDATE('7/15/2021', -1)), MONTH(EDATE('7/15/2021', -1)), DAY(EDATE('7/15/2021', -1))) 6/15/21
EOMONTH(data_inicio, meses)

Esta função recebe um objeto de data (data_inicio) e um número (meses) e retorna uma data representando o último dia de um mês que cai um número especificado de meses antes ou depois da data_inicio. Números negativos permitirão acessar meses antes da data_inicio.

Como esta função retorna um número serial em vez de um objeto de data, você precisará usar a função DATE() para convertê-lo em um objeto de data.

DATE(YEAR(EOMONTH('7/15/21', 0)), MONTH(EOMONTH('7/15/21', 0)), DAY(EOMONTH('7/15/21', 0))) 7/31/21
HOUR(hora) Esta função recebe um objeto de data que inclui hora e retorna um número correspondente à hora da entrada. O resultado numérico será baseado em um relógio de 24 horas. HOUR('7/15/21 7:45:00 PM') 19
MINUTE(hora) Esta função recebe um objeto de data que inclui hora e retorna um número correspondente ao minuto da entrada. MINUTE('7/15/21 7:45:00 PM') 45
NETWORKDAYS(data_inicio, data_fim, {feriados}) Esta função recebe dois objetos de data e um array de objetos de data, e retorna um número correspondente aos dias úteis entre data_inicio e data_fim, excluindo fins de semana e quaisquer feriados especificados. NETWORKDAYS('7/15/21', '7/22/21', ['7/19/21', '7/20/21']) 4
WORKDAY(data_inicio, num_dias, {feriados}) Esta função recebe um objeto de data, um número e um array de objetos de data, e retorna um objeto de data correspondente ao número de dias úteis após data_inicio, excluindo fins de semana e quaisquer feriados especificados. WORKDAY('7/15/21', 7, ['7/19/21', '7/20/21']) 7/28/21
WEEKDAY(data, {tipo})

Esta função recebe um objeto de data e um número e retorna um número representando o dia da semana em que a data especificada cai.

A variável tipo é um pouco mais complexa. Aqui está uma tabela mostrando o que cada número significa para esta função:

Tipo Número Retornado
1 ou omitido Números de 1 (Domingo) a 7 (Sábado).
2 Números de 1 (Segunda-feira) a 7 (Domingo).
3 Números de 0 (Segunda-feira) a 6 (Domingo).
11 Números de 1 (Segunda-feira) a 7 (Domingo).
12 Números de 1 (Terça-feira) a 7 (Segunda-feira).
13 Números de 1 (Quarta-feira) a 7 (Terça-feira).
14 Números de 1 (Quinta-feira) a 7 (Quarta-feira).
15 Números de 1 (Sexta-feira) a 7 (Quinta-feira).
16 Números de 1 (Sábado) a 7 (Sexta-feira).
17 Números de 1 (Domingo) a 7 (Sábado).
WEEKDAY('7/15/21', 2) 4
WEEKNUM(data, {tipo})

Esta função recebe um objeto de data e um número e retorna um número representando a semana do ano em que a data especificada cai.

Tipo 21 segue a metodologia especificada pela ISO 8601, que é comumente conhecida como o sistema europeu de numeração de semanas. A semana que contém a primeira quinta-feira do ano é a primeira semana do ano e é numerada como semana 1.

Prazo em dia útil, não em dia corrido

Cálculo de prazo com data é onde a operação brasileira diverge do padrão internacional: contrato fala em dias úteis, o calendário tem feriado municipal, e o mês fecha em data que não é o último dia. Fórmula que conta dia corrido entrega número que ninguém usa.

Vale montar o cálculo com a regra real do contrato e conferir contra um caso conhecido antes de confiar. Ajustar cálculos de prazo à sua realidade.

Tipo A Semana Começa
1 ou omitido Domingo
2 Segunda-feira
11 Segunda-feira
12 Terça-feira
13 Quarta-feira
14 Quinta-feira
15 Sexta-feira
16 Sábado
17 Domingo
21 Segunda-feira*
WEEKNUM('7/15/21', 1)  29

Resultados inesperados para funções de data e hora

Se sua Fórmula não estiver calculando o resultado esperado, tente o seguinte:

  • Certifique-se de que as tarefas tenham datas de vencimento. Fórmulas com funções de data de vencimento retornarão um erro quando as tarefas não tiverem datas de vencimento.
  • Abra o editor de Fórmulas e certifique-se de que a Fórmula esteja referenciando os campos corretos.
  • Se seu Campo de Fórmula tiver o mesmo nome que outro Campo Personalizado, certifique-se de que você está usando o Campo de Fórmula verificando seu tipo de campo no Gerenciador de Campos Personalizados.

Ainda tem dúvidas? Entre em contato com o suporte oficial do ClickUp.

Quer implementar o ClickUp com mais eficiência na sua empresa? A Audatia é parceira oficial do ClickUp no Brasil e oferece serviços de consultoria, treinamento e revenda de licenças. Entre em contato →

Conteúdo relacionado

Personalizar o AI Notetaker

Personalize seu AI Notetaker. Escolha incluir gravações e transcrições, renomear seu AI Notetaker e muito mais! Inclua gravações e transcrições em suas notas Escolha se deseja ou não incluir gravações e transcrições em suas notas de reunião: Abra seu Planner. No canto superior direito, clique em AI Notes e selecione Configurações. Ative ou

Cartões de Metas

Mostre seus Objetivos e Metas em Painéis e Visões Gerais. Edite rapidamente os Objetivos e crie ou atualize Metas ao lado das métricas de relatórios da sua equipe ou detalhes do projeto. A disponibilidade e os limites da funcionalidade de cartões de Objetivos variam de acordo com o plano e

Use a visualização de Calendário no celular

Veja suas tarefas agendadas em qualquer lugar usando a visualização de Calendário no celular! As tarefas que aparecem na visualização de Calendário são codificadas por cores com base no status da tarefa. As alterações feitas na visualização de Calendário no celular atualizam a mesma visualização em outros dispositivos. Depois de

Configurações do formulário na Barra Lateral Inicial e na Barra Lateral de Espaços

Acesse as configurações da visualização de Formulário a partir da Barra Lateral Inicial e da Barra Lateral de Espaços. Você pode acessar o menu de configurações da visualização de Formulário para Formulários adicionados a: Favoritos Seções personalizadas Espaços ou Pastas Você também pode acessar configurações do Formulário para controlar o