DATE

  • Artigo

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna a data especificada no formato datetime.

Sintaxe

DATE(<year>, <month>, <day>)

Parâmetros

Termo Definição
ano Um número que representa o ano.

O valor do argumento year pode incluir de um a quatro dígitos. O argumento year é interpretado de acordo com o sistema de data usado pelo computador.

Há suporte para datas que começam em 1º de março de 1900.

Se você inserir um número que tenha casas decimais, o número será arredondado.

Para obter valores maiores que 9999 ou menores que zero (valores negativos), a função retorna um erro #VALUE!.

Se o valor de year estiver entre 0 e 1899, o valor será adicionado a 1900 para produzir o valor final. Confira os exemplos abaixo. Observação: Você deverá usar quatro dígitos para o argumento year sempre que possível para evitar resultados indesejados. Por exemplo, o uso de 07 retorna 1907 como o valor de ano.
mês Um número que representa o mês ou um cálculo de acordo com as seguintes regras:

Não há suporte para inteiros negativos. Os valores válidos são de 1 a 12.

Se month for um número de 1 a 12, ele representará um mês do ano. 1 representa janeiro, 2 representa fevereiro e assim por diante até 12, que representa dezembro.

Se você inserir um inteiro maior que 12, ocorrerá o seguinte cálculo: a data será calculada adicionando o valor de month ao year. Por exemplo, se você tiver DATE(2008, 18, 1), a função retornará um valor de datetime equivalente a 1º de junho de 2009, porque 18 meses são adicionados ao início de 2008, resultando em um valor igual a junho de 2009. Veja exemplos abaixo.
dia Um número que representa o dia ou um cálculo de acordo com as seguintes regras:

Não há suporte para inteiros negativos. Os valores válidos são de 1 a 31.

Se day for um número de 1 até o último dia do mês especificado, ele representará um dia do mês.

Se você inserir um inteiro maior que o último dia do mês especificado, ocorrerá o seguinte cálculo: a data será calculada adicionando o valor de day ao month. Por exemplo, na fórmula DATE( 2008, 3, 32), a função DATE retorna um valor de datetime equivalente a 1º de abril de 2008, pois 32 dias são adicionados ao início de março, resultando em um valor igual a 1º de abril.

Se day contiver uma parte decimal, ele será arredondado para o valor inteiro mais próximo.

Retornar valor

Retorna a data especificada (datetime).

Comentários

  • A função DATE usa os inteiros que são inseridos como argumentos e gera a data correspondente. A função DATE é mais útil em situações em que o ano, o mês e o dia são fornecidos por fórmulas. Por exemplo, os dados subjacentes podem conter datas em um formato que não é reconhecido como uma data, como YYYYMMDD. Você pode usar a função DATE em conjunto com outras funções para converter as datas em um número que pode ser reconhecido como uma data.

  • Ao contrário do Microsoft Excel, que armazena datas como um número de série, as funções de data DAX sempre retornam um tipo de dados datetime. No entanto, você poderá usar a formatação para exibir datas como números de série, se desejar.

  • Data e datetime também podem ser especificadas como literais nos formatos dt"YYYY-MM-DD", dt"YYYY-MM-DDThh:mm:ss" ou dt"YYYY-MM-DD hh:mm:ss". Quando especificado como um literal, o uso da função DATE na expressão não é necessário. Para saber mais, confira Sintaxe DAX | Data e hora.

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplos

Data Simples

A seguinte fórmula retorna a data 8 de julho de 2009:

= DATE(2009,7,8)

Anos anteriores a 1899

Se o valor inserido para o argumento year estiver entre 0 (zero) e 1899 (inclusive), esse valor será adicionado a 1900 para o cálculo do ano. A fórmula a seguir retorna 2 de janeiro de 1908: (1900+08).

= DATE(08,1,2)

Anos posteriores a 1899

Se year estiver entre 1900 e 9999 (inclusive), esse valor será usado como o ano. A seguinte fórmula retorna 2 de janeiro de 2008:

= DATE(2008,1,2)

Months

Se month for maior que 12, month adicionará esse número de meses ao primeiro mês do ano especificado. A seguinte fórmula retorna a data 2 de fevereiro de 2009:

= DATE(2008,14,2)

Dias

Se day for maior que o número de dias do mês especificado, day adicionará esse número de dias ao primeiro dia do mês. A seguinte fórmula retorna a data 4 de fevereiro de 2008:

= DATE(2008,1,35)

Conteúdo relacionado

Funções de data e hora
função DAY
Função TODAY