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

Abrir Chat

Abra o Chat para acessar todos os seus Canais e mensagens diretas. A disponibilidade e os limites de recursos variam de acordo com o plano e o papel do usuário. Saiba mais Ative o Chat ClickApp Para usar o Chat, o ClickApp deve ser ativado em seu Workspace. Para ativar

Permissões padrão de função do usuário

Cada plano possui o mesmo conjunto de permissões padrão de nível de Workspace para convidados, membros limitados, membros e administradores. Os proprietários do Workspace têm todas essas permissões. Membros limitados têm permissão apenas para visualizar itens e locais que foram compartilhados com eles. A disponibilidade e os limites das funções

Formate o texto usando a barra de ferramentas de texto

Use a barra de ferramentas de texto e as configurações para criar conteúdo envolvente e consistente para qualquer público. Formate o texto com elementos que se destacam, como banners, cabeçalhos, destaques, blocos de código e citações em destaque. Insira botões e divisores para adicionar estilo ou use uma tabela de

Crie e compartilhe uma visualização de Dashboard

A visualização do Dashboard coloca seus Dashboards bem ao lado do seu trabalho. Use a visualização do Dashboard para garantir que sua equipe possa encontrar facilmente os dados de que precisa.   As visualizações do Dashboard podem ser adicionadas a Espaços, Pastas, Pastas de Sprint, Listas e Listas de Sprint. A