DATE

  • Artigo

Aplica-se a:Colunacalculada Tabelacalculada MedidaCá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 argumento do valor do ano pode incluir de um a quatro dígitos. O argumento ano é interpretado de acordo com o sistema de data usado pelo seu computador.

Datas a partir de 1º de março de 1900 são suportadas.

Se introduzir um número com casas decimais, o número é arredondado.

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

Se o valor do ano estiver entre 0 e 1899, o valor é adicionado a 1900 para produzir o valor final. Veja os exemplos abaixo. Nota: Você deve usar quatro dígitos para o argumento ano sempre que possível para evitar resultados indesejados. Por exemplo, usar 07 retorna 1907 como o valor do 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 1-12.

Se mês é um número de 1 a 12, então representa um mês do ano. 1 representa janeiro, 2 representa fevereiro, e assim por diante até 12 que representa dezembro.

Se você inserir um número inteiro maior que 12, ocorrerá o seguinte cálculo: a data é calculada adicionando o valor do mês ao ano. Por exemplo, se você tiver DATE( 2008, 18, 1), a função retornará um valor datetime equivalente a 1º de junho de 2009, porque 18 meses são adicionados ao início de 2008 produzindo um valor de 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 1-31.

Se dia é um número de 1 até o último dia do mês dado, então ele representa um dia do mês.

Se você inserir um número inteiro maior do que o último dia do mês determinado, ocorrerá o seguinte cálculo: a data é calculada adicionando o valor de dia a mês. Por exemplo, na fórmula DATE( 2008, 3, 32), a função DATA retorna um valor datetime equivalente a 1º de abril de 2008, porque 32 dias são adicionados ao início de março produzindo um valor de 1º de abril.

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

Valor devolvido

Retorna a data especificada (datetime).

Observações

  • A função DATE usa os inteiros que são inseridos como argumentos e gera a data correspondente. A função DATA é mais útil em situações em que o ano, mês e 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 AAAAMMDD. 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ê pode usar a formatação para exibir datas como números de série, se desejar.

  • Data e data/hora também podem ser especificadas como literais no formato 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, consulte Sintaxe DAX | Data e hora.

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplos

Data simples

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

= DATE(2009,7,8)

Anos antes de 1899

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

= DATE(08,1,2)

Anos depois de 1899

Se o ano for entre 1900 e 9999 (inclusive), esse valor é usado como ano. A fórmula a seguir retorna 2 de janeiro de 2008:

= DATE(2008,1,2)

Meses

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

= DATE(2008,14,2)

Dias

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

= DATE(2008,1,35)

Conteúdos relacionados

Funções de data e hora
Função DIA
Função HOJE