Guide de création de scripts ACL 14.1

Fonction YEAR( )

Extrait l'année d'une date ou d'une DateHeure spécifiée et la renvoie sous forme de valeur numérique à l'aide du format AAAA.

YEAR(date/DateHeure)
Nom Type Description
date/DateHeure

DateHeure

Le champ, l'expression, ou la valeur littérale à partir desquels extraire l'année.

Numérique.

Exemples basiques

Renvoie 2014 :

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

Renvoie l'année pour chaque valeur dans le champ Date_facture :

YEAR(Date_facture)

Informations sur les paramètres

Un champ indiqué pour date/DateHeure peut utiliser n'importe quel format de date ou de DateHeure, tant que la définition de champ définit correctement le format.

Spécification d'une valeur littérale de date ou de DateHeure

Lorsque vous indiquez une valeur littérale de date ou de DateHeure pour date/DateHeure, vous êtes limité aux formats de la table ci-dessous, et vous devez entourer la valeur de guillemets inversés – par exemple, `20141231`.

N'utilisez aucun séparateur comme les barres obliques (/) ou les deux points (:) entre les composants individuels des dates ou des heures.

  • Valeurs DateHeure : vous pouvez utiliser n'importe laquelle des combinaisons de formats de date, de séparateur et d'heure répertoriées dans le tableau ci-dessous. La date doit précéder l'heure, et vous devez utiliser un séparateur entre les deux. Les séparateurs valides sont un espace unique, la lettre « t » ou la lettre « T ».

  • Valeurs heure : vous devez indiquer l'heure à l'aide de l'horloge de 24 heures. Les décalages par rapport à l'heure universelle coordonnée (UTC) doivent être préfacés d'un signe plus (+) ou d'un signe moins (-).

    Exemples de formats

    Exemples de valeurs littérales

    AAAAMMJJ

    `20141231`

    AAMMJJ

    `141231`

    AAAAMMJJ hhmmss

    `20141231 235959`

    AAMMJJthhmm

    `141231t2359`

    AAAAMMJJThh

    `20141231T23`

    AAAAMMJJ hhmmss+/-hhmm

    (décalage UTC)

    `20141231 235959-0500`

    AAMMJJ hhmm+/-hh

    (décalage UTC)

    `141231 2359+01`

    Remarque

    N'utilisez pas hh seul dans le format d'heure principal avec des données qui ont un décalage UTC. Par exemple, évitez : hh+hhmm. Il se peut que les résultats ne soient pas fiables.