Função Year

Aplica-se a
Access para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Retorna uma Variante (Inteiro) que contém um número inteiro representando o ano.

Sintaxe

Ano(data)

O argumento de datanecessário é qualquer Variante, expressão numérica, expressão de cadeia ou qualquer combinação destes que possa representar uma data. Se a data contiver Nulo, será devolvido Nulo .

Observação

Se a definição da propriedade Calendar for Gregoriano, o número inteiro devolvido representa o ano Gregoriano para o argumento de data. Se o calendário for Hijri, o número inteiro devolvido representa o ano Hijri para o argumento de data. Para datas hijri, 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 3/4/9666 (31 de dezembro de 9999 gregoriano).

Exemplos de consulta

Expressão. Resultados
SELECT DateofSale, Year([DateofSale]) AS Expr1 FROM ProductSales; Devolve os valores do campo "DateofSale" 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 de VBA

Observação

Exemplos que se seguem 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 do Programador na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a função Ano para obter o ano a partir de uma data especificada. No ambiente de desenvolvimento, o literal de data é apresentado no formato de data abreviada com as definições de região do seu código.

Dim MyDate, MyYear
MyDate = #February 12, 1969#    ' Assign a date.
MyYear = Year(MyDate)    ' MyYear contains 1969.

Escolher a função de data certa