Retorna uma Variante (Inteiro) que contém um número inteiro representando o ano.
Sintaxe
Ano(data)
O argumento de datanecessária é qualquer Variante, expressão numérica, expressão de cadeia ou qualquer combinação destes que represente uma data. Se data contiver Nulo, Nulo é devolvido.
Observação
Se a definição da propriedade Calendar for Gregoriano, o valor inteiro devolvido representa o ano gregoriano para o argumento de data. Se o calendário for Hijiri, o valor inteiro devolvido representa o ano Hijiri para o argumento de data. Para datas de calendário Hijiri, o número de argumento é qualquer expressão numérica que possa representar uma data e/ou hora de 1/1/100 (2 de agosto de 718 do calendário Gregoriano) até 4/3/9666 (31 de dezembro de 9999 do calendário Gregoriano).
Exemplos de consulta
| Expressão. | Resultados |
|---|---|
| SELECT DatadaVenda, Ano([DatadaVenda]) COMO Expr1 FROM ProductSales; | Devolve os valores do campo "DatadaVenda" e o número que representa o "Ano" destes valores de data. |
| SELECT Year(#10/10/2018#) AS YearTest FROM ProductSales; | Devolve o número que representa o "Ano" da cadeia "10/10/2018". Resultado: 2018. |
Exemplo do VBA
Observação
Os exemplos seguintes demonstram a utilização desta função num módulo Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Pesquisar e introduza um ou mais termos na caixa de pesquisa.
Este exemplo utiliza 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.