DATE
Aplica-se a:
Coluna calculadaTabela calculadaMedidaCálculo visual
Devolve a data especificada no formato datetime.
Sintaxe
DATE(<year>, <month>, <day>)
Parâmetros
| Vigência | 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 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 year 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 year sempre que possível para evitar resultados indesejados. Por exemplo, usar 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-12. Se month é 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 de month ao year. Por exemplo, se você tiver DATE( 2008, 18, 1), a função retorna 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. |
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-31. Se day é 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 day a 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, 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, ela será arredondada para o valor inteiro mais próximo. |
Valor de retorno
Devolve 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, 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, 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 data/hora também podem ser especificadas como literais no formato
dt"YYYY-MM-DD",dt"YYYY-MM-DDThh:mm:ss"oudt"YYYY-MM-DD hh:mm:ss". Quando especificado como um literal, usar a função DATE na expressão não é necessário. Para saber mais, consulte DAX Sintaxe | 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 year 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 year estiver 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 month for maior que 12, month 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 day for maior do que o número de dias no mês especificado, day adiciona 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)