Histórico da Página
Incluir 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