Histórico da Página
Sintaxis
YEAR( <expresión fecha> )
Propósito
Extrae el año de una determinada fecha.
Argumentos
<expresión fecha>
Define la fecha de la cual se extraerá el año.
Utilización
La función YEAR() opera sobre datos del tipo fecha, suministrando el valor numérico que representa el año de la referida fecha. Este valor podrá utilizarse, por ejemplo, para la realización de cálculos aritméticos.
La expresión fecha puede ser una variable tipo fecha, un campo tipo fecha, una expresión involucrando fechas, la fecha del sistema operativo, suministrada por la función DATE(), o la fecha del sistema Protheus, suministrada por la variable dDataBase.
El valor del año será siempre suministrado en el formato “aaaa”, es decir, incluyendo los dígitos del sigilo. Por ejemplo: 2012.
Si la expresión fecha especificada resulta una fecha nula o vacía, se suministrará el valor cero.
Sugerencias
La función YEAR() es muy útil para aplicaciones que requieran cálculos con los años de fechas.
La función YEAR() está relacionada con las funciones DAY() y MONTH(), que suministran, respectivamente, el día y el mes de una fecha.
Ejemplos
MsgAlert( DATE() ) // Resulta 28/03/12
MsgAlert( YEAR(DATE()) ) // Resulta el valor numérico 2012
dData := CTOD(“19/12/90”)
MsgAlert( YEAR(dData) ) // Resulta el valor numérico 1990
nAno := YEAR(dData)
MsgAlert( nAno) // Resulta el valor numérico 1990