Compartilhar via


Função YEAR (DAX)

Retorna o ano de uma data como um inteiro de quatro dígitos no intervalo 1900 a 9999.

Sintaxe

YEAR(<date>)

Parâmetros

Termo

Definição

date

Uma data no formato datetime ou texto contendo o ano a ser localizado.

Valor de retorno

Um inteiro no intervalo de 1900 a 9999.

Comentários

Em contraste com o Microsoft Excel, que armazena datas como números de série, o DAX usa um tipo de dados datetime para trabalhar com datas e horas.

As datas devem ser inseridas usando uma função DATE ou como resultado de outras fórmulas ou funções. Você também pode inserir datas em representações de texto aceitas de uma data, como 3 de março de 2003 ou 3-março-2003.

Valores retornados pelas funções YEAR, MONTH e DAY serão valores do calendário gregoriano, seja qual for o formato de exibição do valor de data fornecido. Por exemplo, se o formato de exibição da data fornecida usar o calendário Hijri, os valores retornados para as funções YEAR, MONTH e DAY serão valores associados à data equivalente no calendário gregoriano.

Quando o argumento de data for uma representação de texto da data, a função usará as configurações de localidade e data/hora, do computador cliente, para compreender o valor de texto a fim de executar a conversão. Os erros poderão surgir se o formato das cadeias de caracteres for incompatível com as configurações das localidade atuais. Por exemplo, se a localidade definir datas a serem formatadas como mês/dia/ano e a data for fornecida como dia/mês/ano, 25/1/2009 não será interpretada como 25 de janeiro de 2009, mas como uma data inválida.

Exemplo

O exemplo a seguir retorna 2003.

=YEAR("March 2003")

Exemplo: data como resultado de expressão

Descrição

O exemplo a seguir retorna o ano da data de hoje.

Código

=YEAR(TODAY())