DATE
aplica-se a:
coluna calculadatabela calculadamedidacálculo visual
Retorna a data especificada no formato datetime.
Sintaxe
DATE(<year>, <month>, <day>)
Parâmetros
| Prazo | Definição |
|---|---|
year |
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 datas usado pelo computador.Há suporte para datas a partir de 1º de março de 1900. Se você inserir um número que tenha casas decimais, o número será arredondado. Para valores maiores que 9999 ou menores que zero (valores negativos), a função retorna um erro #VALUE!.Se o valor year estiver entre 0 e 1899, o valor será adicionado a 1900 para produzir o valor final. Veja os exemplos abaixo.
Observação: Você deve 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 do ano. |
month |
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 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á a seguinte computação: 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, pois 18 meses são adicionados ao início de 2008, gerando um valor de junho de 2009. Veja os exemplos abaixo. |
day |
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 a 31. Se day for um número de 1 até o último dia do mês determinado, ele representará um dia do mês.Se você inserir um inteiro maior que o último dia do mês determinado, ocorrerá a seguinte computação: a data será calculada adicionando o valor de day a month. Por exemplo, na fórmula DATE( 2008, 3, 32), a função DATE retorna um valor datetime equivalente a 1º de abril de 2008, pois 32 dias são adicionados ao início de março, gerando um valor de 1º de abril.Se day contiver uma parte decimal, ela será arredondada para o valor inteiro mais próximo. |
Valor de retorno
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 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, DAX funções de data 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 datetime também podem ser especificados como literais no formato
dt"YYYY-MM-DD",dt"YYYY-MM-DDThh:mm:ss"oudt"YYYY-MM-DD hh:mm:ss". Quando especificado como literal, o uso da função DATE na expressão não é necessário. Para saber mais, consulte DAX Sintaxe | Data e hora.Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).
Exemplos
Data Simples
A fórmula a seguir retorna a data de 8 de julho de 2009:
= DATE(2009,7,8)
Anos antes de 1899
Se o valor inserido para o argumento year estiver entre 0 (zero) e 1899 (inclusive), esse valor será adicionado a 1900 para calcular o ano. A fórmula a seguir retorna 2 de janeiro de 1908: (1900+08).
= DATE(08,1,2)
Anos após 1899
Se year estiver entre 1900 e 9999 (inclusivo), esse valor será usado como o ano. A fórmula a seguir retorna 2 de janeiro de 2008:
= DATE(2008,1,2)
Meses
Se month for maior que 12, month adicionará esse número de meses ao primeiro mês do ano especificado. A fórmula a seguir retorna a data de 2 de fevereiro de 2009:
= DATE(2008,14,2)
Dias
Se day for maior do que o número de dias no mês especificado, day adicionará esse número de dias ao primeiro dia do mês. A fórmula a seguir retorna a data de 4 de fevereiro de 2008:
= DATE(2008,1,35)