YEAR

Exemplo de uso

YEAR(Date)

Sintaxe

1) Retorna o ano de um valor de "Data".

YEAR(date_expression)

2) Retorna o ano de um valor de "Data" do modo de compatibilidade.

YEAR(X [,format_string])

Parâmetros

• date_expression: uma expressão ou um campo "Data" ou "Data e hora".
• X: campo ou expressão que resulta em texto, número ou data do modo de compatibilidade.
• format_string: formato de X. Essa propriedade é opcional quando X está configurado corretamente como um campo geográfico.

Formatar strings para datas do modo de compatibilidade

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

• Qualquer formato strptime válido é aceito.
• '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'

Se X for uma expressão ou um campo numérico, as funções de hora compatíveis vão aceitar o seguinte formato de entrada:

• 'SECONDS': segundos desde a Era Unix
• 'MILLIS': milissegundos desde a Era Unix
• 'MICROS': microssegundos desde a Era Unix
• 'NANOS': nanossegundos desde a Era Unix
• 'JULIAN_DATE': dias desde a Era Unix

Exemplos

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

Observações

Essa função utiliza as datas do modo de compatibilidade e os tipos de dados de "Data" e "Data e hora" atualizados.

Recursos relacionados

• Datas e horas
• Campos calculados
• Lista de funções do Looker Studio