Retorna uma Variante (Inteiro) que contém um número inteiro representando o ano.
Sintaxe
Year(date)
O argumento de datanecessário é qualquer Variant, expressão numérica, expressão de cadeia de caracteres ou qualquer combinação delas que possa representar uma data. Se date contiver Null, Null será retornado.
Observação
Se a configuração da propriedade Calendar for gregoriano, o inteiro retornado representará o ano gregoriano para o argumento de data. Se o calendário for islâmico, o inteiro retornado representará o ano islâmico para o argumento de data. Para datas islâmicas, o número do argumento é qualquer expressão numérica que pode representar uma data e/ou hora de 1/1/100 (gregoriano 2 de agosto de 718) a 4/3/9666 (gregoriano 31 de dezembro de 9999).
Exemplos de consulta
| Expressão. | Resultados |
|---|---|
| SELECT DateofSale, Year([DateofSale]) AS Expr1 FROM ProductSales; | Retorna os valores do campo "DataDeVenda" e o número que representa o 'Ano' desses valores de data. |
| SELECT Year(#10/10/2018#) AS YearTest FROM ProductSales; | Retorna o número que representa o 'Year' da cadeia "10/10/2018". Resultado: 2018. |
Exemplo de VBA
Observação
Os exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
Este exemplo usa a função Ano para obter o ano de uma data especificada. No ambiente de desenvolvimento, o literal de data é exibido no formato de data abreviada usando as configurações de localidade do seu código.
Dim MyDate, MyYear
MyDate = #February 12, 1969# ' Assign a date.
MyYear = Year(MyDate) ' MyYear contains 1969.