YEAR

Devolve o ano de uma determinada data.

Exemplo de utilização

YEAR(Date)

Sintaxe

A seguinte sintaxe devolve o ano de um valor de data.

YEAR( date_expression )

A seguinte sintaxe devolve o ano de um valor de data do modo de compatibilidade.

YEAR( X [, format_string ])

Parâmetros

  • date_expression - um campo ou uma expressão de data ou data e hora.
  • X - um campo ou uma expressão que é avaliada como texto, número ou data do modo de compatibilidade.
  • format_string - formato de X. Opcional se X estiver configurado corretamente como um campo de data semântica.

Strings de formato para datas do modo de compatibilidade

As funções de data compatíveis aceitam os seguintes formatos de entrada se X for um campo ou uma expressão de texto, ou uma data do modo de compatibilidade:

  • 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: por exemplo, Sat, 24 May 2008 20:09:47 GMT
  • RFC_3339: por exemplo, 2008-05-24T20:09:47Z
  • DECIMAL_DATE: igual a DEFAULT_DECIMAL

É aceite qualquer formato strptime válido.

As funções de hora compatíveis aceitam o seguinte formato de entrada se X for um campo ou uma expressão de número:

  • SECONDS: segundos desde a época
  • MILLIS: milissegundos desde a época
  • MICROS: microssegundos desde a época
  • NANOS: nanosegundos desde a época
  • JULIAN_DATE: dias desde a época

Exemplos

Fórmula de exemplo Entrada Resultado
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

Notas

Esta função funciona com datas do modo de compatibilidade e com tipos de dados de data e hora atualizados.