DATE
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"oudt"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)