Função DATE
Retorna a data especificada no formato datetime.
Sintaxe
DATE(<year>, <month>, <day>)
Parâmetros
Termo |
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 data usado pelo seu computador. Datas começando em 1 de março de 1900 são suportadas. Se você inserir um número com casas decimais, ele será arredondado. Para obter valores maiores que 9999 ou menores que zero (valores negativos), a função retorna um erro #VALOR!. Se o valor de year estiver entre 0 e 1899, ele será somado a 1900 para gerar o valor final. Veja os exemplos abaixo.
|
||
mês |
Um número que representa o mês ou um cálculo de acordo com estas regras: 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 sucessivamente, até 12, que representa dezembro. Se você inserir um inteiro maior que 12, ocorre o seguinte cálculo: a data é calculada somando-se o valor de mês ao ano. Por exemplo, se você tiver DATE (2008, 18, 1), a função retornará um valor de data/hora equivalente a 1º de junho de 2009, porque são acrescentados 18 meses ao início de 2008, o que rende um valor de junho de 2009. Veja exemplos abaixo. Se você inserir um inteiro negativo, ocorre o seguinte cálculo: a data é calculada subtraindo-se o valor de mês de ano. Por exemplo, se você tiver DATE(2008, -6, 15), a função retornará um valor de data/hora equivalente a 15 de junho de 2007, porque quando são subtraídos 6 meses do início de 2008, isso rende um valor de junho de 2007. Veja exemplos abaixo. |
||
dia |
Um número que representa o dia ou um cálculo de acordo com estas regras: Se dia for um número de 1 até o último dia do mês fornecido, então, ele representa um dia do mês. Se você inserir um inteiro maior que o último dia do mês fornecido, ocorrerá o seguinte cálculo: a data é calculada somando-se o valor de day a month. Por exemplo, na fórmula DATE( 2008, 3, 32), a função DATE retornará um valor de datetime equivalente a 1º de abril de 2008, pois são adicionados 32 dias ao início de março, o que gera um valor de 1º de abril. Se você inserir um inteiro negativo, ocorrerá o seguinte cálculo: a data é calculada subtraindo-se o valor de day de month. Por exemplo, na fórmula DATE( 2008, 5, -15), a função DATE retorna um valor de datetime equivalente a 15 de abril de 2008, pois são subtraídos 15 dias do início de maio de 2008, o que gera um valor de abril de 2008. Se day contiver uma parte decimal, o valor será arredondado para o valor inteiro mais próximo. |
.gif "Observação")
ObservaçãoValor de retorno
Retorna a data especificada (datetime).
Comentários
A função DATE considera 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, 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 YYYYMMDD. Você pode usar a função DATE junto com outras funções para converter as datas em um número que pode ser reconhecido como uma data.
Em contraste com o Microsoft Excel, que armazena datas como um número de série, funções de data do DAX sempre retornam um tipo de dados datetime. Entretanto, se você quiser, poderá usar a formatação para exibir datas como números de série.
Esta função DAX pode retornar resultados diferentes quando usada em um modelo que é implantado e consultado no modo DirectQuery. Para obter mais informações sobre diferenças semânticas no modo DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219171.
Exemplo: Retornando uma data simples
Descrição
A fórmula a seguir retorna a data de 8 de julho de 2009:
Código
=DATE(2009,7,8)
Exemplo: Anos antes de 1899
Descrição
Se o valor inserido para o argumento year estiver entre 0 (zero) e 1899 (inclusive), esse valor será somado a 1900 para calcular o ano. A fórmula a seguir retorna 2 de janeiro de 1908: (1900+08).
Código
=DATE(08,1,2)
Exemplo: Anos antes de 1899
Descrição
Se o valor inserido para o argumento year estiver entre 0 (zero) e 1899 (inclusive), esse valor será somado a 1900 para calcular o ano. A fórmula a seguir retorna 2 de janeiro de 3700: (1900+1800).
Código
=DATE(1800,1,2)
Exemplo: Anos depois de 1899
Descrição
Se year estiver entre 1900 e 9999 (inclusive), esse valor será usado como o ano. A fórmula a seguir retorna 2 de janeiro de 2008:
Código
=DATE(2008,1,2)
Exemplo: Trabalhando com meses
Descrição
Se month for maior que 12, month adicionará esse número de meses ao primeiro mês no ano especificado. A fórmula a seguir retorna a data de 2 de fevereiro de 2009:
Código
=DATE(2008,14,2)
Comentário
Se o valor month for menor que 1, a função DATE subtrairá a magnitude desse número de meses, mais 1, do primeiro mês no ano especificado. A fórmula a seguir retorna 2 de setembro de 2007:
=DATE(2008,-3,2)
Exemplo: Trabalhando com dias
Descrição
Se day for maior que o número de dias no mês especificado, day somará 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:
Código
=DATE(2008,1,35)
Comentário
Se day for menor que 1, day subtrairá a magnitude desse número de dias, mais um, do primeiro dia do mês especificado. A fórmula a seguir retorna 16 de dezembro de 2007:
=DATE(2008,1,-15)