---
schema_version: "1"
id: 63ff145c6beccb01524802292836e3cdd1a8330eaaccc63d70b92ee545358424
title: Funções de data
collection: tableau
version: next
locale: pt-br
portal_url: https://docs.salesforce.com/tableau/next/pt-br/public/desktop/functions_functions_date.md
canonical_url: https://help.tableau.com/v0.0/public/desktop/pt-br/functions_functions_date.htm
source_site: help.tableau.com
content_type: documentation
content_hash: bb72ed1242423f9fa749a4b9636038451d4d769710092c94c43896d457cb5496
description: Reference for Tableau date functions used in calculations.
---
[Pular para o conteúdo principal](#main-content)

# Funções de data

As datas são um elemento comum em muitas fontes de dados. Se um campo contiver datas reconhecíveis, ele terá um tipo de dados **data** ou **data e hora**. Quando os campos de data são usados na visualização, eles obtêm um conjunto especial de funcionalidades, incluindo um detalhamento automático da hierarquia de datas, opções de filtro específicas de data e opções especializadas de formatação de data. O uso de datas em cálculos geralmente requer o uso de funções específicas de data.

## Familiarize-se com outros conceitos de data

As funções de data às vezes fazem referência a elementos específicos de data, incluindo o argumento `date_part`, o parâmetro opcional`[start_of_week]` e literais de data (#). Eles são abordados com mais detalhes no final deste tópico.

Existem vários outros tópicos que podem ser de interesse, mas não fazem parte das funções de data:

- Formatar como uma data é exibida em uma visualização: [Formatos de data personalizados](https://help.tableau.com/v0.0/public/desktop/pt-br/dates_custom_date_formats.htm)
- Definir as propriedades de data padrão: [Propriedades de data para uma fonte de dados](https://help.tableau.com/v0.0/public/desktop/pt-br/date_properties.htm).
- Trabalhar com datas fiscais: [Datas fiscais](https://help.tableau.com/v0.0/public/desktop/pt-br/dates_fiscal.htm)
- Usar o calendário ISO-8601: [Calendário ISO-8601 baseado em semana](https://help.tableau.com/v0.0/public/desktop/pt-br/dates_calendar.htm)

> [!TIP]
> 
> **Dica**: seu campo já foi reconhecido como uma data (ele tem um ícone de data no painel Dados) e você tenta controlar como ele aparece na visualização? Talvez seja necessário formatá-lo em vez de usar uma função de data. Por exemplo, você quer mostrar 22/09/2024 como 24/09. Isso é feito por meio da formatação da data, não de um cálculo.  
>   
> Ver [Formatos de data personalizados](https://help.tableau.com/v0.0/public/desktop/pt-br/dates_custom_date_formats.htm) e tópicos relacionados para trabalhar com campos de data. As funções de data nesta página permitem manipular campos calculados de datas, e não definir sua formatação de exibição.

## Funções de data disponíveis no Tableau

### DATE

Função de conversão de tipo que altera as expressões de cadia de caracteres e número em datas, desde que estejam em um formato reconhecível.

<table class="table--plain"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DATE(expression)</code></td></tr><tr><td>Saída</td><td>Data</td></tr><tr><td>Definição</td><td>Retorna uma data de acordo com um número, cadeia de caracteres ou de data <code>&lt;expression&gt;</code>.</td></tr><tr><td>Exemplo</td><td><pre>DATE([Employee Start Date])</pre><pre>DATE("September 22, 2018") </pre><pre xml:space="preserve">DATE("9/22/2018")</pre><pre>DATE(#2018-09-22 14:52#)</pre></td></tr><tr><td>Observações</td><td><p>Ao contrário de <code><a href="#DATEPARS" class="xref">DATEPARSE</a></code>, não há necessidade de fornecer um padrão como <code>DATE</code>, pois reconhece automaticamente muitos formatos de data padrão. Se <code>DATE</code> não reconhecer a entrada, no entanto, tente usar <code>DATEPARSE</code> e especificar o formato.</p><p><code><a href="#MAKEDATE" class="xref">MAKEDATE</a></code> é outra função semelhante, mas <code>MAKEDATE</code> requer a entrada de valores numéricos para ano, mês e dia.</p></td></tr></tbody></table>

### DATEADD

Adiciona um número especificado de partes de data (meses, dias etc) à data de início.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DATEADD(date_part, interval, date)</code></td></tr><tr><td>Saída</td><td>Data</td></tr><tr><td>Definição</td><td>Retorna a <code>&lt;date&gt;</code> com o <code>&lt;interval&gt;</code> do número especificado, adicionado a <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code> especificada dessa data. Por exemplo, adicionar três meses ou 12 dias a uma data de início.</td></tr><tr><td>Exemplo</td><td><p>Adie todas as datas de vencimento em uma semana</p><pre>DATEADD('week', 1, [due date])</pre><p>Adicione 280 dias à data 20 de fevereiro de 2021</p><pre xml:space="preserve">DATEADD('day', 280, #2/20/21#) = #November 27, 2021#</pre></td></tr><tr><td>Observações</td><td>Oferece suporte às datas de ISO 8601.</td></tr></tbody></table>

### DATEDIFF

Retorna o número de partes da data (semanas, anos etc.) entre duas datas.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DATEDIFF(date_part, date1, date2, [start_of_week])</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna a diferença entre <code>&lt;date1&gt;</code> e <code>&lt;date2&gt;</code> expressa em unidades de <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code>. Por exemplo, subtraindo as datas que alguém entrou e saiu de uma banda para ver quanto tempo eles estavam na banda.</td></tr><tr><td>Exemplo</td><td><p>Número de dias entre 25 de março de 1986 e 20 de fevereiro de 2021</p><pre>DATEDIFF('day', #3/25/1986#, #2/20/2021#) = 12,751</pre><p>Quantos meses alguém estava em uma banda</p><pre>DATEDIFF('month', [date joined band], [date left band])</pre></td></tr><tr><td>Observações</td><td>Oferece suporte às datas de ISO 8601.</td></tr></tbody></table>

### DATENAME

Retorna o nome da parte de data especificada como uma cadeia de caracteres discreta.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DATENAME(date_part, date, [start_of_week])</code></td></tr><tr><td>Saída</td><td>Cadeia de caracteres</td></tr><tr><td>Definição</td><td>Retorna <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code> de <code>&lt;date&gt;</code> como uma cadeia de caracteres.</td></tr><tr><td>Exemplo</td><td><pre>DATENAME('year', #3/25/1986#) = "1986"</pre><pre>DATENAME('month', #1986-03-25#) = "March"</pre></td></tr><tr><td>Observações</td><td><p>Oferece suporte às datas de ISO 8601.</p><p>Um cálculo muito semelhante é <a href="#DATEPART" class="xref">DATEPART</a>, que retorna o valor da parte da data especificada como um inteiro contínuo. <code>DATEPART</code> pode ser mais rápido porque é uma operação numérica.</p><p>Alterando os atributos do resultado do cálculo (dimensão ou medida, contínua ou discreta) e a formatação da data, os resultados de <code>DATEPART</code> e <code>DATENAME</code> podem ser formatados para serem idênticos.</p><p>Uma função inversa é <a href="#DATEPARS" class="xref">DATEPARSE</a>, que recebe um valor de cadeia de caracteres e o formata como uma data.</p></td></tr></tbody></table>

### DATEPARSE

Retorna cadeias de caracteres especificamente formatadas como datas.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DATEPARSE(date_format, date_string)</code></td></tr><tr><td>Saída</td><td>Data</td></tr><tr><td>Definição</td><td>O argumento <code>&lt;date_format&gt;</code> como o campo <code>&lt;date_string&gt;</code> é organizado. Devido à variedade de maneiras que o campo de cadeia de caracteres pode ser ordenado, o <code>&lt;date_format&gt;</code> precisa ter correspondência exata. Para obter uma explicação completa e os detalhes de formatação, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/data_dateparse.htm" target="_blank">Converter um campo em um campo de data</a>.</td></tr><tr><td>Exemplo</td><td><pre xml:space="preserve">DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986#</pre></td></tr><tr><td>Observações</td><td><p><code><a href="#top" class="xref">DATE</a></code> é uma função semelhante que reconhece automaticamente muitos formatos de data padrão. <code>DATEPARSE</code> pode ser uma opção melhor se <code>DATE</code> não reconhecer o padrão de entrada.</p><p><code><a href="#MAKEDATE" class="xref">MAKEDATE</a></code> é outra função semelhante, mas <code>MAKEDATE</code> requer a entrada de valores numéricos para ano, mês e dia.</p><p>As funções inversas, que separam datas e retornam o valor de suas partes, são <code><a href="#DATEPART" class="xref">DATEPART</a></code> (saída de inteiro) e <code><a href="#DATENAME" class="xref">DATENAME</a></code> (saída de cadeia de caracteres).</p></td></tr><tr><td>Limitações do banco de dados</td><td><p><code>DATEPARSE</code> está disponível para os seguintes conectores:&nbsp;conexões não herdadas de arquivos de texto e do Excel, Amazon EMR, Hadoop Hive, Cloudera Hadoop, Planilhas Google, Hortonworks Hadoop Hive, MapR Hadoop Hive, MySQL, Oracle, PostgreSQL e extrações do Tableau. Alguns formatos talvez não estejam disponíveis para todas as conexões.</p><p><code>DATEPARSE</code> não é compatível nas variantes de Hive. Apenas Denodo, Drill e Snowflake são aceitos.</p></td></tr></tbody></table>

### DATEPART

Retorna o nome da parte de data especificada como um inteiro.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DATEPART(date_part, date, [start_of_week])</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code> de <code>&lt;date&gt;</code> como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre>DATEPART('year', #1986-03-25#) = 1986</pre><pre>DATEPART('month', #1986-03-25#) = 3</pre></td></tr><tr><td>Observações</td><td><p>Oferece suporte às datas de ISO 8601.</p><p>Um cálculo muito semelhante é <code><a href="#DATENAME" class="xref">DATENAME</a></code>, que retorna o nome da parte da data especificada como uma cadeia de caracteres discreta. <code>DATEPART</code> pode ser mais rápido porque é uma operação numérica. Alterando os atributos do resultado do campo (dimensão ou medida, contínua ou discreta) e a formatação da data, os resultados de <code>DATEPART</code> e <code>DATENAME</code> podem ser formatados para serem idênticos.</p><p>Uma função inversa é <code><a href="#DATEPARS" class="xref">DATEPARSE</a></code>, que recebe um valor de cadeia de caracteres e o formata como uma data.</p></td></tr></tbody></table>

### DATETRUNC

Esta função pode ser considerada como arredondamento de data. Leva uma data específica e retorna uma versão dessa data na especificidade desejada. Como cada data deve ter um valor para dia, mês, trimestre e ano, `DATETRUNC` define os valores como o valor mais baixo para cada parte da data até a parte da data especificada. Consulte o exemplo para obter mais informações.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DATETRUNC(date_part, date, [start_of_week])</code></td></tr><tr><td>Saída</td><td>Data</td></tr><tr><td>Definição</td><td>Trunca a <code>&lt;date&gt;</code> na precisão definida por <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code>. Esta função retorna uma nova data. Por exemplo, quando você trunca uma data no meio do mês no nível do mês, essa função retorna o primeiro dia do mês.</td></tr><tr><td>Exemplo</td><td><pre xml:space="preserve">DATETRUNC('day', #9/22/2018#) = #9/22/2018#</pre><pre xml:space="preserve">DATETRUNC('iso-week', #9/22/2018#) = #9/17/2018#</pre><p>(a segunda-feira da semana contendo 9/22/2018)</p><pre xml:space="preserve">DATETRUNC(quarter, #9/22/2018#) = #7/1/2018# </pre><p>(primeiro dia do trimestre contendo 9/22/2018)</p><p class="note">Observação: para semana e iso-semana, o <code>start_of_week</code> é usado. Os dias da semana do ISO sempre começam na segunda-feira. Para a localidade deste exemplo, um <code>start_of_week</code> não especificado significa que a semana começa no domingo.</p></td></tr><tr><td>Observações</td><td><p>Oferece suporte às datas de ISO 8601.</p><p>Você não deveria usar <code>DATETRUNC</code> para, por exemplo, parar de mostrar a hora de um campo de data e hora em uma visualização. Se você quiser truncar as exibições de uma data em vez de arredondar sua precisão, <a href="https://help.tableau.com/current/pro/desktop/pt-br/dates_custom_date_formats.htm" target="_blank">ajuste a formatação</a>.</p><p>Por exemplo, <code>DATETRUNC('day', #5/17/2022 3:12:48 PM#)</code>, se formatado na visualização para exibir segundos, seria exibido como <code>5/17/2022 12:00:00 AM</code>. O valor é truncado para o dia, mas a exibição vai para os segundos.</p></td></tr></tbody></table>

### DAY

Retorna o dia do mês (1 a 31) especificada como um inteiro.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DAY(date)</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna o dia da <code>&lt;date&gt;</code> especificada como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre>Day(#September 22, 2018#) = 22</pre></td></tr><tr><td>Observações</td><td>Consulte também <code><a href="#WEEK" class="xref">WEEK</a></code>, <code><a href="#MONTH" class="xref">MONTH</a></code>, <code><a href="#QUARTER" class="xref">TRIMESTRE</a></code>, <code><a href="#YEAR" class="xref">YEAR</a></code> e os equivalentes ISO.</td></tr></tbody></table>

### ISDATE

Verifica se a cadeia de caracteres é um formato de data válido.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>ISDATE(string)</code></td></tr><tr><td>Saída</td><td>Booliano</td></tr><tr><td>Definição</td><td>Retornará true se uma determinada <code>&lt;string&gt;</code> for uma data válida.</td></tr><tr><td>Exemplo</td><td><pre>ISDATE(09/22/2018) = true</pre><pre>ISDATE(22SEP18) = false</pre></td></tr><tr><td>Observações</td><td>O argumento necessário deve ser uma cadeia de caracteres. ISDATE não pode ser usado para um campo com um tipo de dados de data – o cálculo retornará um erro.</td></tr></tbody></table>

### ISOQUARTER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>ISOQUARTER(date)</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna o trimestre baseado em semana ISO8601 de uma <code>&lt;date&gt;</code> especificada como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre>ISOQUARTER(#1986-03-25#) = 1</pre></td></tr><tr><td>Observações</td><td>Consulte também <code><a href="#ISOWEEK" class="xref">ISOWEEK</a></code>, <code><a href="#ISOWEEKDAY" class="xref">ISOWEEKDAY</a></code>, <code><a href="#ISOYEAR" class="xref">ISOYEAR</a></code>, e não equivalentes ao ISO.</td></tr></tbody></table>

### ISOWEEK

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>ISOWEEK(date)</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna a semana baseada em semana ISO8601 especificada de <code>&lt;date&gt;</code> como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre>ISOWEEK(#1986-03-25#) = 13</pre></td></tr><tr><td>Observações</td><td>Consulte também <code><a href="#ISOWEEKDAY" class="xref">ISOWEEKDAY</a></code>, <code><a href="#ISOQUARTER" class="xref">ISOQUARTER</a></code>, <code><a href="#ISOYEAR" class="xref">ISOYEAR</a></code>, e não equivalentes ao ISO.</td></tr></tbody></table>

### ISOWEEKDAY

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>ISOWEEKDAY(date)</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna dia da semana baseado em semana ISO8601 de uma <code>&lt;date&gt;</code> especificada como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre>ISOWEEKDAY(#1986-03-25#) = 2</pre></td></tr><tr><td>Observações</td><td>Consulte também <code><a href="#ISOWEEK" class="xref">ISOWEEK</a></code>, <code><a href="#ISOQUARTER" class="xref">ISOQUARTER</a></code>, <code><a href="#ISOYEAR" class="xref">ISOYEAR</a></code>, e não equivalentes ao ISO.</td></tr></tbody></table>

### ISOYEAR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>ISOYEAR(date)</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna ano baseado em semana ISO8601 de uma <code>&lt;date&gt;</code> especificada como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre>ISOYEAR(#1986-03-25#) = 1,986</pre></td></tr><tr><td>Observações</td><td>Consulte também <code><a href="#ISOWEEK" class="xref">ISOWEEK</a></code>, <code><a href="#ISOWEEKDAY" class="xref">ISOWEEKDAY</a></code>, <code><a href="#ISOQUARTER" class="xref">ISOQUARTER</a></code>, e não equivalentes ao ISO.</td></tr></tbody></table>

### MAKEDATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>MAKEDATE(year, month, day)</code></td></tr><tr><td>Saída</td><td>Data</td></tr><tr><td>Definição</td><td>Retorna um valor de data composto por <code>&lt;year&gt;</code>, <code>&lt;month&gt;</code> e <code>&lt;day&gt;</code> especificados.</td></tr><tr><td>Exemplo</td><td><pre xml:space="preserve">MAKEDATE(1986,3,25) = #1986-03-25#</pre></td></tr><tr><td>Observações</td><td><p class="note"><b>Observação</b>: os valores inseridos incorretamente serão ajustados em uma data, como <code>MAKEDATE(2020,4,31) = May 1, 2020</code> em vez de retornar um erro informando que não há 31 de abril.</p><p>Disponível para as Extrações de dados do Tableau. Verifique a disponibilidade em outras fontes de dados.</p><p><code>MAKEDATE</code> requer entradas numéricas para as partes de uma data. Se os dados são uma cadeia de caracteres que deveria ser uma data, tente a função <code><a href="#top" class="xref">DATE</a></code>. <code>DATE</code> reconhece automaticamente muitos formatos de data padrão. Se <code>DATE</code> não reconhecer a entrada, tente usar <code><a href="#DATEPARS" class="xref">DATEPARSE</a></code>.</p></td></tr></tbody></table>

### MAKEDATETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>MAKEDATETIME(date, time)</code></td></tr><tr><td>Saída</td><td>Datetime</td></tr><tr><td>Definição</td><td>Retorna um datetime que combina <code>&lt;date&gt;</code> e <code>&lt;time&gt;</code>. A data pode ser um tipo date, datetime ou string. A hora deve ser um datetime.</td></tr><tr><td>Exemplo</td><td><pre>MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#</pre><pre>MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#</pre></td></tr><tr><td>Observações</td><td><p>Esta função está disponível somente para conexões compatíveis com o MySQL (que, para o Tableau, são o MySQL e o Amazon Aurora).</p><p><code><a href="#MAKETIME" class="xref">MAKETIME</a></code> é uma função semelhante disponível para Extrações de dados do Tableau e algumas outras fontes de dados.</p></td></tr></tbody></table>

### MAKETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>MAKETIME(hour, minute, second)</code></td></tr><tr><td>Saída</td><td>Datetime</td></tr><tr><td>Definição</td><td>Retorna um valor de data composto por <code>&lt;hour&gt;</code>, <code>&lt;minute&gt;</code> e <code>&lt;second&gt;</code> especificados.</td></tr><tr><td>Exemplo</td><td><pre>MAKETIME(14, 52, 40) = #1/1/1899 14:52:40#</pre></td></tr><tr><td>Observações</td><td><p>Como o Tableau não oferece suporte a um tipo de dados de hora, apenas DATETIME e hora, a saída é uma datetime. A parte de data do campo será 1/1/1899.</p><p>Função semelhante a <code><a href="#MAKEDATETIME" class="xref">MAKEDATETIME</a></code>, que só está disponível para conexões compatíveis com MYSQL.</p></td></tr></tbody></table>

### MAX

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>MAX(expression)</code> ou <code>MAX(expr1, expr2)</code></td></tr><tr><td>Saída</td><td>Mesmo tipo de dados do argumento ou <code>NULL</code> se alguma parte do argumento for nula.</td></tr><tr><td>Definição</td><td><p>Retorna o máximo de dois argumentos, que devem ser do mesmo tipo de dados.</p><p><code>MAX</code> também pode ser aplicada a um único campo em uma agregação.</p></td></tr><tr><td>Exemplo</td><td><pre xml:space="preserve">MAX(4,7) = 7<br>MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# <br>MAX([Name]) = "Zander"</pre></td></tr><tr><td>Observações</td><td><p><b>Para cadeia de caracteres</b></p><p><code>MAX</code> geralmente é o valor que vem por último em ordem alfabética.</p><p class="note">Para fontes de dados de bancos de dados, o valor de cadeia de caracteres <code>MAX</code> é o mais alto na sequência de classificação definida pelo banco de dados para essa coluna.</p><p><b>Para datas</b></p><p>Para datas, <code>MAX</code> é a data mais recente. Se <code>MAX</code> for uma agregação, o resultado não terá uma hierarquia de datas. Se <code>MAX</code> for uma comparação, o resultado manterá a hierarquia de datas.</p><p><b>Como uma agregação</b></p><p><code>MAX(expression)</code> é uma função agregada e retorna um único resultado agregado. Isso é exibido como <code>AGG(expression)</code> na visualização.</p><p><b>Como comparação</b></p><p><code>MAX(expr1, expr2)</code> compara os dois valores e retorna um valor em nível de linha.</p><p>Consulte também <code><a href="#MIN" class="xref">MIN</a></code>.</p></td></tr></tbody></table>

### MIN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>MIN(expression)</code> ou <code>MIN(expr1, expr2)</code></td></tr><tr><td>Saída</td><td>Mesmo tipo de dados do argumento ou <code>NULL&nbsp;</code> se alguma parte do argumento for nula.</td></tr><tr><td>Definição</td><td><p>Retorna, no mínimo, dois argumentos, que devem ser do mesmo tipo de dados.</p><p><code>MIN </code> também pode ser aplicada a um único campo em uma agregação.</p></td></tr><tr><td>Exemplo</td><td><pre xml:space="preserve">MIN(4,7) = 4<br>MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#<br>MIN([Name]) = "Abebi"</pre></td></tr><tr><td>Observações</td><td><p><b>Para cadeia de caracteres</b></p><p><code>MIN</code> geralmente é o valor que vem primeiro em ordem alfabética.</p><p class="note">Para fontes de dados de bancos de dados, o valor de cadeia de caracteres <code>MIN</code> é o mais baixo na sequência de classificação definida pelo banco de dados para essa coluna.</p><p><b>Para datas</b></p><p>Para datas, o <code>MIN</code> é a data mais antiga. Se <code>MIN</code> for uma agregação, o resultado não terá uma hierarquia de datas. Se <code>MIN</code> for uma comparação, o resultado manterá a hierarquia de datas.</p><p><b>Como uma agregação</b></p><p><code>MIN(expression)</code> é uma função agregada e retorna um único resultado agregado. Isso é exibido como <code>AGG(expression)</code> na visualização.</p><p><b>Como comparação</b></p><p><code>MIN(expr1, expr2)</code> compara os dois valores e retorna um valor em nível de linha.</p><p>Consulte também <code><a href="#MAX" class="xref">MAX</a></code>.</p></td></tr></tbody></table>

### MONTH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>MONTH(date)</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna o mês da <code>&lt;date&gt;</code> especificada como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre>MONTH(#1986-03-25#) = 3</pre></td></tr><tr><td>Observações</td><td>Consulte também <code><a href="#DAY" class="xref">DAY</a></code>, <code><a href="#WEEK" class="xref">WEEK</a></code>, <code><a href="#QUARTER" class="xref">TRIMESTRE</a></code>, <code><a href="#YEAR" class="xref">YEAR</a></code> e os equivalentes ISO</td></tr></tbody></table>

### NOW

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>NOW()</code></td></tr><tr><td>Saída</td><td>Datetime</td></tr><tr><td>Definição</td><td>Retorna a data e a hora atuais do sistema local.</td></tr><tr><td>Exemplo</td><td><pre>NOW() = 1986-03-25 1:08:21 PM</pre></td></tr><tr><td>Observações</td><td><p><code>NOW</code> não aceita um argumento.</p><p>Consulte também <code><a href="#TODAY" class="xref">TODAY</a></code>, um cálculo semelhante que retorna uma data em vez de uma data e hora.</p><p>Se a fonte de dados for uma conexão ativa, a data e a hora do sistema podem estar em outro fuso horário. Para obter mais informações sobre como abordar isso, consulte <a href="https://kb.tableau.com/articles/issue/now-function-returns-utc-time?lang=pt-br">Base de dados de conhecimento</a>.</p></td></tr></tbody></table>

### TRIMESTRE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>QUARTER(date)</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna o trimestre da <code>&lt;date&gt;</code> especificada como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre>QUARTER(#1986-03-25#) = 1</pre></td></tr><tr><td>Observações</td><td>Consulte também <code><a href="#DAY" class="xref">DAY</a></code>, <code><a href="#WEEK" class="xref">WEEK</a></code>, <code><a href="#MONTH" class="xref">MONTH</a></code>, <code><a href="#YEAR" class="xref">YEAR</a></code> e os equivalentes ISO</td></tr></tbody></table>

### TODAY

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>TODAY()</code></td></tr><tr><td>Saída</td><td>Data</td></tr><tr><td>Definição</td><td>Retorna a data atual do sistema local.</td></tr><tr><td>Exemplo</td><td><pre>TODAY() = 1986-03-25</pre></td></tr><tr><td>Observações</td><td><p><code>TODAY</code> não aceita um argumento.</p><p>Consulte também <a href="#NOW" class="xref">NOW</a>, um cálculo semelhante que retorna uma data e hora em vez de uma data.</p><p>Se a fonte de dados for uma conexão em tempo real, a data do sistema pode estar em outro fuso horário. Para obter mais informações sobre como abordar isso, consulte <a href="https://kb.tableau.com/articles/issue/now-function-returns-utc-time?lang=pt-br">Base de dados de conhecimento</a>.</p></td></tr></tbody></table>

### WEEK

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>WEEK(date)</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna a semana da <code>&lt;date&gt;</code> especificada como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre>WEEK(#1986-03-25#) = 13</pre></td></tr><tr><td>Observações</td><td>Consulte também <code><a href="#DAY" class="xref">DAY</a></code>, <code><a href="#MONTH" class="xref">MONTH</a></code>, <code><a href="#QUARTER" class="xref">TRIMESTRE</a></code>, <code><a href="#YEAR" class="xref">YEAR</a></code> e os equivalentes ISO</td></tr></tbody></table>

### YEAR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>YEAR(date)</code></td></tr><tr><td>Saída</td><td>Inteiro</td></tr><tr><td>Definição</td><td>Retorna o ano da <code>&lt;date&gt;</code> especificada como um inteiro.</td></tr><tr><td>Exemplo</td><td><pre xml:space="preserve">YEAR(#1986-03-25#) = 1,986</pre></td></tr><tr><td>Observações</td><td>Consulte também <code><a href="#DAY" class="xref">DAY</a></code>, <code><a href="#WEEK" class="xref">WEEK</a></code>, <code><a href="#MONTH" class="xref">MONTH</a></code>, <code><a href="#QUARTER" class="xref">TRIMESTRE</a></code> e os equivalentes ISO</td></tr></tbody></table>

## date\_part

Muitas funções de data no Tableau aceitam o argumento `date_part`, que é uma constante de cadeia de caracteres que informa à função qual parte de uma data deve ser considerada, como dia, semana, trimestre, etc. O valores válidos de `date_part` que você pode usar são:

| date\_part | Valores |
| --- | --- |
| `'year'` | Ano de quatro dígitos |
| `'quarter'` | 1-4 |
| `'month'` | 1-12 ou "January", "February" e assim por diante |
| `'dayofyear'` | Dia do ano; 1 de janeiro é 1, 1 de fevereiro é 32 etc. |
| `'day'` | 1-31 |
| `'weekday'` | 1-7 ou "Sunday", "Monday" e assim por diante |
| `'week'` | 1-52 |
| `'hour'` | 0-23 |
| `'minute'` | 0-59 |
| `'second'` | 0-60 |
| `'iso-year'` | Ano de ISO 8601 com quatro dígitos |
| `'iso-quarter'` | 1-4 |
| `'iso-week'` | 1-52, o início da semana é sempre segunda-feira |
| `'iso-weekday'` | 1-7, o início da semana é sempre segunda-feira |

## O parâmetro `[start_of_week]`

Algumas funções possuem o parâmetro opcional `[start_of_week]`. O parâmetro `start_of_week` pode ser usado para especificar qual dia é considerado o primeiro dia da semana, como "Sunday" ou"Monday". Caso isso seja omitido, o início da semana é determinado pela fonte de dados. Consulte [Propriedades de data para uma fonte de dados](https://help.tableau.com/v0.0/public/desktop/pt-br/date_properties.htm).

Para os exemplos abaixo, 22 de setembro é um domingo e 24 de setembro é uma terça-feira. A função DATEDIFF está sendo usada para calcular as semanas entre essas datas.

`DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'monday') = 1`

- Como start\_of\_week é 'monday', essas datas estão em semanas diferentes.

`DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'sunday') = 0`

- Como start\_of\_week é 'sunday', essas datas são na mesma semana.

## O literal de data (#)

Os exemplos geralmente usam o símbolo de libra (#) com expressões de data. Esse é o literal de data, semelhante ao uso de aspas para strings de texto, e informa ao Tableau que o valor dentro dos símbolos é uma data.

Sem os literais de data, as datas podem ser interpretadas como vários outros tipos de dados. Por exemplo:

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Formato</td><td style="font-weight: bold;">Tipo de dados</td><td style="font-weight: bold;">Valor</td></tr><tr><td>'March 25, 1986'</td><td>Cadeia de caracteres</td><td>'March 25, 1986'</td></tr><tr><td>#25/03/1986#</td><td>Data</td><td>#25/03/1986#</td></tr><tr><td>25/03/1986</td><td>Decimal flutuante</td><td>0.00006042</td></tr><tr><td>1986-03-25</td><td>Inteiro</td><td>1,958</td></tr><tr><td>25 de março de 1986</td><td>-</td><td>inválido</td></tr></tbody></table>

![Painel de dados com vários ícones de formato de data destacados.](/tableau/next/pt-br/public/desktop/pt-br/Img/datefunc_dateformats.png)

Para obter mais informações, consulte [Sintaxe de expressão literal](https://help.tableau.com/v0.0/public/desktop/pt-br/functions_operators.htm#literals).

## Criar um cálculo de data

Pratique a criação de um cálculo de data usando a fonte de dados de amostra Superstore.

1. No Tableau Desktop, conecte-se à fonte de dados salva **Sample-Superstore**, incluída no Tableau.
2. Abra uma planilha.
3. No painel **Dados**, em Dimensões, arraste Data do pedido até a divisória Linhas.
4. Na prateleira **Linhas**, clique no ícone mais (**+**) no campo **YEAR(Order Date)**.
    
    QUARTER(Order Date) é adicionado à divisória Linhas e às atualizações da exibição.
    
    ![Uma tabela que exibe dados de pedidos por ano e trimestre.](/tableau/next/pt-br/public/desktop/pt-br/Img/datefunctions2.png)
5. Na divisória Linhas, clique no ícone mais (**+**) no campo QUARTER(Order Date) para detalhar a MONTH(Order Date).
    
    ![Uma tabela que mostra o ano, trimestre e mês das datas dos pedidos.](/tableau/next/pt-br/public/desktop/pt-br/Img/datefunctions3.png)
6. Selecione Análise > Criar campo calculado.
7. No editor de cálculo aberto, faça o seguinte:

- Nomeie o campo calculado, Data do trimestre.
- Insira a fórmula a seguir: `DATETRUNC('quarter', [Order Date])`
- Ao terminar, clique em **OK**.
    
    O novo campo calculado de data aparece em **Dimensões** no painel **Dados**. Assim como os outros campos, é possível usá-lo em uma ou mais visualizações.

9. No painel **Dados**, em Dimensões, arraste Data do trimestre para a divisória Linhas e coloque-a à direita de MONTH(Order Date). A visualização é atualizada com os valores de ano. Isso é porque o Tableau leva a data para o nível de detalhe mais alto.
10. Na divisória Linhas, clique com o botão direito do mouse no campo YEAR(Quarter Date) e selecione Data exata.
11. Na divisória Linhas, clique com o botão direito do mouse no campo YEAR(Quarter Date) e selecione Discreto.
    
    A visualização é atualizada com a data de trimestre exato para cada linha na tabela.
    
    ![Uma tabela que exibe as datas dos pedidos por ano, trimestre, mês e data do trimestre.](/tableau/next/pt-br/public/desktop/pt-br/Img/datefunctions1.png)