Retorna o ano de uma determinada data.
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 deX. Essa propriedade é opcional quandoXestá 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 |
|
|
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.