Função YEAR (VisioShapeSheet)

Retorna um inteiro que representa o ano gregoriano em datetime ou expressão, formatado de acordo com o estilo de data curta definido pelas configurações atuais de Região e Idioma do sistema.

Sintaxe

YEAR(" datetime "| expressão [, lcid ])

Parâmetros

Name	Obrigatório/opcional	Tipo de dados	Descrição
datetime	Obrigatório	String	Qualquer cadeia de caracteres comumente reconhecida como uma data e hora ou uma referência a uma célula contendo uma data e hora.
expression	Obrigatório	Varia	Qualquer expressão que produza uma data e hora.
lcid	Opcional	Numérica	O identificador de local a ser utilizado na avaliação de uma data e hora não locais. O identificador de local é um número descrito nos arquivos de cabeçalho do sistema.

Valor de retorno

Número inteiro

Comentários

O componente de hora em datetime ou expression é desconsiderado.

Não são feitos arredondamentos. Se a datetime estiver faltando ou não puder ser interpretada como uma data ou hora válida, a função YEAR retornará um erro.

A função YEAR também aceita um valor de número único para expression em que a parte inteira do resultado representa o número de dias desde 30 de dezembro de 1899.

Exemplo 1

ANO("27/10/2007 13:45:24")

Retornará 2007.

Exemplo 2

YEAR(DATEVALUE("25 de dez de 2006") + 7 ed.)

Retornará 2007.

Exemplo 3

ANO(35580.6337)

Retornará 1997.