Función YEAR( )

Extrae el año de una fecha o fechahora especificada y lo devuelve como un valor numérico con el formato YYYY.

Sintaxis

YEAR(fecha/fechahora)

Parámetros

Nombre Tipo Descripción
fecha/fechahora

fechahora

El campo, expresión o el valor literal de donde extraer el año.

Salida

Numérico.

Ejemplos

Ejemplos básicos

Devuelve 2014:

YEAR(`20141231`)
YEAR(`141231 235959`)

Devuelve el año para cada valor del campo Fecha_de_factura:

YEAR(Fecha_de_factura)

Observaciones

Detalles del parámetro

Un campo especificado para fecha/fechahora puede utilizar cualquier formato de fecha o fechahora, siempre que la definición del campo establezca correctamente el formato.

Especificar un valor de fechahora o fecha literal

Al especificar un valor literal de fecha o fechahora para fecha/fechahora, solo puede utilizar los formatos de la siguiente tabla y debe encerrar el valor entre acentos graves; por ejemplo, `20141231`.

No utilice ningún separador, como barras (/) o dos puntos (:), entre los componentes individuales de fechas u horas.

  • Valores de fechahora: puede utilizar cualquier combinación de formatos de fecha, separador y hora de la siguiente tabla. La fecha debe preceder a la hora y se debe utilizar un separador entre las dos. Los separadores válidos son un espacio en blanco, la letra 't' o la letra 'T'.

  • Valores de hora: debe especificar las horas con el reloj de 24 horas. Los desplazamientos respecto del Horario Universal Coordinado (UTC, por sus siglas en inglés) deben ir precedidos de un signo más (+) o un signo menos (-).

    Formatos de ejemplo

    Valores literales de ejemplo

    AAAAMMDD

    `20141231`

    AAMMDD

    `141231`

    AAAAMMDD hhmmss

    `20141231 235959`

    AAMMDDthhmm

    `141231t2359`

    AAAAMMDDThh

    `20141231T23`

    AAAAMMDD hhmmss+/-hhmm

    (desplazamiento de UTC)

    `20141231 235959-0500`

    AAMMDD hhmm+/-hh

    (desplazamiento de UTC)

    `141231 2359+01`

    Nota

    No use solo hh en el formato de la hora principal con datos que tienen un desplazamiento del UTC. Por ejemplo, evite: hh+hhmm. Los resultados pueden no ser confiables.

     

Guía de creación de scripts de ACL 14.1