Use Fórmulas avançadas para fazer cálculos com funções de data e hora.
O que você vai precisar
- 60 usos de Campos personalizados, incluindo Campos de fórmula, estão disponíveis no plano Free Forever.
- Usos ilimitados estão disponíveis em todos os planos pagos.
- Campos personalizados individuais podem ser ocultados de convidados.
- Convidados com permissões de edição ou edição completa podem editar Campos personalizados existentes, mas não podem criar novos.
- Campos de fórmula não aceitam Campos personalizados que contenham texto.
Variáveis cercadas por {} nas seções a seguir são opcionais e podem ser omitidas de uma função sem causar erros. Certifique-se de que os parênteses estão corretos nas suas Fórmulas, caso contrário você receberá uma mensagem de erro.
Funções simples de data e hora
Abaixo está uma tabela com as 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 TODAY(), que não tem entradas e simplesmente retorna uma data correspondente à data do dia atual.
| Sintaxe | Exemplo | Resultado esperado |
| DAY(date) | DAY('7/15/21') | 15 |
| DAYS(end_date, start_date) | DAYS('7/15/21', '6/15/21') | 30 |
| MONTH(date) | MONTH('7/15/21') | 7 |
| TODAY() | TODAY() | Hoje |
| YEAR(date) | YEAR('7/15/21') | 2021 |
Funções complexas de data e hora
Abaixo está uma tabela com funções de data e hora mais complexas.
| Sintaxe | Descrição | Exemplo | Resultado esperado |
| DATE(year, month, day) | Esta função recebe três números e retorna um objeto de data correspondente aos números informados. | DATE(2021, 7, 15) | 7/15/21 |
| EDATE(start_date, months) | Esta função recebe um objeto de data (start_date) e um número (months) e retorna uma data que representa um número específico de meses antes ou depois de start_date. Números negativos permitem acessar meses anteriores a start_date. 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(start_date, months) | Esta função recebe um objeto de data (start_date) e um número (months) e retorna uma data que representa o último dia do mês que ocorre um número específico de meses antes ou depois de start_date. Números negativos permitem acessar meses anteriores a start_date. 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(time) | Esta função recebe um objeto de data que inclui hora e retorna um número correspondente à hora do tempo informado. O resultado é baseado em um relógio de 24 horas. | HOUR('7/15/21 7:45:00 PM') | 19 |
| MINUTE(time) | Esta função recebe um objeto de data que inclui hora e retorna um número correspondente ao minuto do tempo informado. | MINUTE('7/15/21 7:45:00 PM') | 45 |
| NETWORKDAYS(start_date, end_date, {holidays}) | 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 start_date e end_date, excluindo fins de semana e feriados especificados. | NETWORKDAYS('7/15/21', '7/22/21', ['7/19/21', '7/20/21']) | 4 |
| WORKDAY(start_date, num_days, {holidays}) | 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 start_date, excluindo fins de semana e feriados especificados. | WORKDAY('7/15/21', 7, ['7/19/21', '7/20/21']) | 7/28/21 |
| WEEKDAY(date, {type}) | Esta função recebe um objeto de data e um número e retorna um número que representa o dia da semana em que a data especificada cai. A variável type é um pouco mais complexa. Veja a tabela abaixo com o significado de cada número para esta função: 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(date, {type}) | Esta função recebe um objeto de data e um número e retorna um número que representa a semana do ano em que a data especificada cai. 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 O tipo 21 segue a metodologia especificada pela ISO 8601, conhecida como 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. |
WEEKNUM('7/15/21', 1) | 29 |
Resultados inesperados para funções de data e hora
Se a sua Fórmula não estiver calculando o resultado esperado, tente o seguinte:
- Verifique se as tarefas têm 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 verifique se a Fórmula está referenciando os campos corretos.
- Se o seu Campo de fórmula tiver o mesmo nome que outro Campo personalizado, confirme que está usando o Campo de fórmula verificando o tipo de campo no Gerenciador de campos personalizados.