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.

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

Defina Campos Personalizados em tarefas

Defina os valores de Campos Personalizados a partir de tarefas, visualizações ou da Barra de Ação em Massa. As opções disponíveis variam de acordo com o tipo de Campo Personalizado. Você pode definir Campos Personalizados por localização e Campos Personalizados por tipo de tarefa da mesma forma. O que você

Verificador de Marca

O Brand Checker garante uma voz de marca consistente ao revisar rascunhos de marketing em relação às diretrizes, pontuando a conformidade e entregando reescritas concisas e prontas para uso. Este Super Agente de marketing e criatividade faz parte do nosso pacote ClickUp Accelerator. O ClickUp Accelerator é uma oferta focada

Cartões de Gráfico de Linhas

O cartão do Dashboard de Gráfico de Linhas é um cartão personalizado disponível em nossa funcionalidade de Dashboard que permite visualizar mudanças nos dados ao longo do tempo. Os cartões de gráfico de linhas usam Tempo ou Datas no eixo x para exibir dados de tarefas ao longo do tempo.

Salve um comentário ou mensagem para depois

Não tem tempo para responder a um comentário ou mensagem do Chat? Precisa revisitar uma conversa no futuro? Salve para depois! O que você vai precisar Você pode salvar comentários e mensagens para depois em todos os planos. Todos, incluindo convidados, podem salvar comentários e mensagens para depois. Salvar um