Histórico da Página

Sintaxe

YEAR( <expressão data> )

Propósito

Extrai o ano de uma determinada data.

Argumentos

<expressão data>

Define a data da qual se extrairá o ano.

Utilização

A função YEAR() opera sobre dados do tipo data, fornecendo o valor numérico que representa o ano da data em questão. Este valor poderá ser utilizado , por exemplo, para a realização de cálculos aritméticos.

A expressão data pode ser uma variável tipo data, um campo tipo data, uma expressão envolvendo datas, a data do sistema operacional, fornecida pela função DATE(), ou a data do sistema Protheus, fornecida pela variável dDataBase.

O valor do ano será sempre fornecido no formato “aaaa”, ou seja, incluindo os dígitos do século. Por exemplo: 2012.

Se a expressão data especificada resultar em uma data nula ou vazia, será fornecido o valor zero.

Dicas

A função YEAR() é muito útil para aplicações que requeiram cálculos com os anos de datas.

A função YEAR() está relacionada com as funções DAY() e MONTH(), que fornecem, respectivamente, o dia e o mês de uma data.

Exemplos

MsgAlert( DATE() )          // Resulta 28/03/12

MsgAlert( YEAR(DATE()) )          // Resulta o valor numérico 2012

dData := CTOD(“19/12/90”)

MsgAlert( YEAR(dData) )            // Resulta o valor numérico 1990

nAno := YEAR(dData)

MsgAlert( nAno)                             // Resulta o valor numérico 1990