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

Crie listas de verificação de tarefas no celular

Adicione, edite e atribua checklists no aplicativo móvel. O que você vai precisar Checklists estão disponíveis em todos os planos do ClickUp.  Qualquer pessoa, incluindo convidados com permissões de edição ou edição total, pode criar checklists de tarefas.  As tarefas podem ter até 250 checklists. As checklists podem ter até

Ative o ClickApp de IA

Ative o ClickApp de IA para permitir que seus membros do Workspace e membros limitados usem nossos recursos de IA do ClickUp e Super Agents. A disponibilidade e os limites dos recursos de IA do ClickUp e dos Super Agents variam de acordo com o plano e o papel do

Participe de um SyncUp

Participe de um SyncUp para colaborar ao vivo com sua equipe! A disponibilidade e os limites de recursos variam de acordo com o plano e o papel do usuário. Saiba mais Participe de um SyncUp Participe de SyncUps e comece a conversar com seus colegas de equipe ao vivo. Após

Crie lembretes no celular

Com o aplicativo móvel ClickUp, você pode criar e editar lembretes de qualquer lugar! Os lembretes estão disponíveis em todos os planos ClickUp para todos os papéis de usuário. Você não pode recuperar lembretes excluídos.  Os lembretes podem ser criados em Modo Offline. Criar um lembrete no celular Crie lembretes