ANNÉE

Renvoie l'année correspondant à une date donnée.

Exemple d'utilisation

YEAR(Date)

Syntaxe

La syntaxe suivante renvoie l'année à partir d'une valeur "Date".

YEAR( date_expression )

La syntaxe suivante renvoie l'année à partir d'une valeur "Date" en mode compatibilité.

YEAR( X [, format_string ])

Paramètres

  • date_expression : expression ou champ de type "Date" ou "Date et heure".
  • X : champ ou expression dont le résultat de l'évaluation correspond à du texte, un nombre ou une date en mode de compatibilité.
  • format_string : format de X. Facultatif si X est correctement configuré en tant que champ de date sémantique.

Chaînes de format pour les dates en mode de compatibilité

Les fonctions de date compatibles acceptent les formats d'entrée suivants si X est un champ ou une expression textuels, ou une date en mode de compatibilité:

  • BASIC: %Y/%m/%d-%H:%M:%S
  • DEFAULT_DASH: %Y-%m-%d [%H:%M:%S]
  • DEFAULT_SLASH: %Y/%m/%d [%H:%M:%S]
  • DEFAULT_DECIMAL: %Y%m%d [%H:%M:%S]
  • RFC_1123: par exemple, Sam, 24 mai 2008 20:09:47 GMT
  • RFC_3339: par exemple, 2008-05-24T20:09:47Z
  • DECIMAL_DATE: identique à DEFAULT_DECIMAL

Tout format strptime valide est accepté.

Les fonctions d'heure compatibles acceptent le format d'entrée suivant si X est un champ ou une expression numériques:

  • SECONDS: secondes depuis l'epoch
  • MILLIS: millisecondes depuis l'epoch
  • MICROS: microsecondes depuis l'epoch
  • NANOS: nanosecondes depuis l'epoch
  • JULIAN_DATE: jours depuis l'epoch

Examples

Example formula Input Output
YEAR(Date) Jan 1, 2019 2019
YEAR(Date as Text, 'BASIC') 2019/01/01-09:40:45 2019
YEAR(Date as Number, 'SECONDS') 1561784874 2019

YEAR(Date as lots of Numbers, 'MILLIS')

1562004058620 2019

Remarques

Cette fonction peut être utilisée à la fois avec les dates en mode de compatibilité et avec les types de données "Date" et "Date et heure" mis à niveau.