Funções de data

Este artigo apresenta as funções de data e os respectivos usos no Tableau. Ela também demonstra como criar um cálculo de data com um exemplo.

Neste artigo

Criar um cálculo de data

Siga as etapas abaixo para saber como criar um cálculo de data.

  1. No Tableau Desktop, conecte-se à fonte de dados salva Sample-Superstore, incluída no Tableau.

  2. Navegue até 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.

  5. Na divisória Linhas, clique no ícone mais (+) no campo QUARTER(Order Date) para detalhar a MONTH(Order Date).

  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.

  8. 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.

  9. Na divisória Linhas, clique com o botão direito do mouse no campo YEAR(Quarter Date) e selecione Data exata.

  10. 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.

Por que usar funções de data

As função de data permitem manipular as datas na sua fonte de dados.

Por exemplo, você pode ter um campo de data com ano, mês e dia para cada valor (2004-04-15). Com esses valores existentes, é possível criar novos valores de data com uma função de data, como a função DATETRUNC. Por exemplo, você pode encontrar a data do começo do trimestre para qualquer valor de data.

O cálculo de data pode ficar mais ou menos assim:

DATETRUNC('quarter', [Order Date])

Portanto, se a data original for “3/27/2011”, com o cálculo acima, “1/1/2011” será retornado para indicar que T1 começou em 1 de janeiro. Se a data original for "03/05/2011", então o cálculo retornará "01/04/2011" para indicar que o segundo trimestre começou em 1º de abril, quatro meses após o começo do ano.

Consulte a seção Criar um cálculo de data abaixo para obter um exemplo.

Calendário gregoriano versus a norma ISO 8601

Se você estiver usando uma extração .hyper, as funções de data podem ser calculadas usando o calendário gregoriano ou a norma ISO 8601. Para obter mais informações sobre a criação de extração .hyper, consulte Atualização de extrações para o formato .hyper.

O formato ISO 8601 é um padrão internacional para calcular datas e horas que difere do calendário gregoriano, devido a como a semana inicial de um ano (Semana 1) é calculada. No calendário Gregoriano, o usuário pode definir o dia de início de uma semana. Na norma ISO 8601, a semana sempre começa na segunda-feira.

Em um calendário Gregoriano, quando um novo ano começa, a Semana 1 do ano é contado como iniciando no dia primeiro de janeiro, independentemente do dia da semana. Se o dia primeiro de janeiro cair no sábado, então a Semana 1 terá um dia nele e a Semana 2 começará no domingo seguinte.

No formato ISO 8601, a Semana 1 de um novo ano começar na segunda-feira e tem quatro ou mais dias em janeiro. Por exemplo, se o dia primeiro de janeiro cair em um sábado, então a Semana 1 não começará até a próxima segunda-feira, 03 de janeiro. Calcular as datas dessa maneira garante que haja um número consistente de dias na Semana 1 do novo ano.

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

Função

Sintaxe

Descrição

DATEADD

DATEADD(date_part, interval, date)

Retorna a data especificada com o interval do número especificado, adicionado a date_part especificada dessa data.

Oferece suporte às datas de ISO 8601.

Exemplo:

DATEADD('month', 3, #2004-04-15#) = 2004-07-15 12:00:00 AM

Essa expressão adiciona três meses à data #2004-04-15#.

DATEDIFF

DATEDIFF(date_part, date1, date2, [start_of_week])

Retorna a diferença entre date1 e date2 expressa em unidades de date_part.

O parâmetro start_of_week, que você pode usar para especificar qual dia deve ser considerado o primeiro dia ou semana, é opcional. Os valores possíveis são 'monday' (segunda-feira), 'tuesday' (terça-feira) etc. Caso isso seja omitido, o início da semana é determinado pela fonte de dados. Consulte Propriedades de data para uma fonte de dados.

Oferece suporte às datas de ISO 8601.

Exemplos:

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

A primeira expressão retorna 1 porque quando start_of_week é 'monday', 22 de setembro (um domingo) e 24 de setembro (uma terça-feira) estão em semanas diferentes. A segunda expressão retorna 2 porque quando start_of_week é 'sunday', 22 de setembro (um domingo) e 24 de setembro (uma terça-feira) estão na mesma semana.

DATENAME

DATENAME(date_part, date, [start_of_week])

Retorna date_part de date como uma cadeia de caracteres. O parâmetro start_of_week, que você pode usar para especificar qual dia deve ser considerado o primeiro dia ou semana, é opcional. Os valores possíveis são 'monday' (segunda-feira), 'tuesday' (terça-feira) etc. Se start_of_week for emitido, o início da semana será determinado pela fonte de dados. Consulte Propriedades de data para uma fonte de dados.

Oferece suporte às datas de ISO 8601.

Exemplos:

DATENAME('year', #2004-04-15#) = "2004"
DATENAME('month', #2004-04-15#) = "April"

DATEPART

DATEPART(date_part, date, [start_of_week])

Retorna date_part de date como um inteiro.

O parâmetro start_of_week, que você pode usar para especificar qual dia deve ser considerado o primeiro dia ou semana, é opcional. Os valores possíveis são 'monday' (segunda-feira), 'tuesday' (terça-feira) etc. Se start_of_week for emitido, o início da semana será determinado pela fonte de dados. Consulte Propriedades de data para uma fonte de dados.

Observação: Quando date_part é um dia útil, o parâmetro start_of_week é ignorado. Isso é porque o Tableau usa uma ordenação de dias úteis fixa para aplicar desvios.

Oferece suporte às datas de ISO 8601.

Exemplos:

DATEPART('year', #2004-04-15#) = 2004
DATEPART('month', #2004-04-15#) = 4

DATETRUNC

DATETRUNC(date_part, date, [start_of_week])

Trunca a data especificada na precisão definida por date_part. 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. O parâmetro start_of_week, que você pode usar para especificar qual dia deve ser considerado o primeiro dia ou semana, é opcional. Os valores possíveis são 'monday' (segunda-feira), 'tuesday' (terça-feira) etc. Se start_of_week for emitido, o início da semana será determinado pela fonte de dados. Consulte Propriedades de data para uma fonte de dados.

Oferece suporte às datas de ISO 8601.

Exemplos:

DATETRUNC('quarter', #2004-08-15#) = 2004-07-01 12:00:00 AM
DATETRUNC('month', #2004-04-15#) = 2004-04-01 12:00:00 AM

DAY

DAY(date)

Retorna o dia da data especificada como um inteiro.

Exemplo:

DAY(#2004-04-12#) = 12

ISDATE

ISDATE(string)

Retornará true se uma determinada cadeia de caracteres for uma data válida.

Exemplo:

ISDATE("April 15, 2004") = true

MAKEDATE

MAKEDATE(year, month, day)

Retorna um valor de data composto por um ano, mês e dia específicos.

Disponível para as Extrações de dados do Tableau. Verifique a disponibilidade em outras fontes de dados.

Exemplo:

MAKEDATE(2004, 4, 15) = #April 15, 2004#

MAKEDATETIME

MAKEDATETIME(date, time)

Retorna um datetime que combina data e hora. A data pode ser um tipo date, datetime ou string. A hora deve ser um datetime.

Observação: 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).

Exemplos:

MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#
MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#

MAKETIME

MAKETIME(hour, minute, second)

Retorna um valor de data composto por uma hora, minuto e segundo específicos.

Disponível para as Extrações de dados do Tableau. Verifique a disponibilidade em outras fontes de dados.

Exemplo:

MAKETIME(14, 52, 40) = #14:52:40#

MAX

MAX(expression) or MAX(expr1, expr2)

Normalmente aplicado a números, mas também funciona em datas. Retorna o máximo de a e b (a e b devem ser do mesmo tipo). Retorna Null se um dos argumentos for Null.

Exemplos:

MAX(#2004-01-01# ,#2004-03-01#) = 2004-03-01 12:00:00 AM
MAX([ShipDate1], [ShipDate2])

MIN

MIN(expression) or MIN(expr1, expr2)

Normalmente aplicado a números, mas também funciona em datas. Retorna o mínimo de a e b (a e b devem ser do mesmo tipo). Retorna Null se um dos argumentos for Null.

Exemplos:

MIN(#2004-01-01# ,#2004-03-01#) = 2004-01-01 12:00:00 AM
MIN([ShipDate1], [ShipDate2])

MONTH

MONTH(date)

Retorna o mês da data especificada como um inteiro.

Exemplo:

MONTH(#2004-04-15#) = 4

NOW

NOW( )

Retorna a data e a hora atuais.

O retorno varia, dependendo da natureza da conexão:

  • Para uma conexão ao vivo não publicada, NOW retorna a hora do servidor da fonte de dados.

  • Para uma conexão ao vivo publicada, NOW retorna a hora do servidor da fonte de dados.

  • Para uma extração não publicada, NOW retorna a hora do sistema local.

  • Para uma extração publicada, NOW retorna a hora local do Processador de Dados do Tableau Server. Quando houver vários computadores de trabalho em diferentes fusos horários, isso pode criar resultados inconsistentes.

Exemplo:

NOW( ) = 2004-04-15 1:08:21 PM

TODAY

TODAY( )

Retorna a data atual.

Exemplo:

TODAY( ) = 2004-04-15

YEAR

YEAR (date)

Retorna o ano da data especificada como um inteiro.

Exemplo:

YEAR(#2004-04-15#) = 2004


Valores date_part

Muitas funções de data no Tableau usam date_part, que é um argumento de cadeia de caracteres constante. Os valores date_part válidos 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

Para obter mais informações sobre a formatação das função de data, consulte a seção Expressões literais na tabela Visão geral: sintaxe de cálculo.

Observação: As funções de data não consideram o início do ano fiscal configurado. Consulte Datas fiscais para obter mais informações.

Consulte também

Datas fiscais

Datas e horas

Propriedades de data para uma fonte de dados

Datas personalizadas

Formatos de data personalizados

Funções do Tableau (em ordem alfabética)

Funções do Tableau (por categoria)

Formatação de cálculos no Tableau

Funções no Tableau

Obrigado pelo feedback! Ocorreu um erro ao enviar seu feedback. Tente novamente ou envie-nos uma mensagem..