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.