--- title: Date.prototype.getFullYear() slug: Web/JavaScript/Reference/Global_Objects/Date/getFullYear tags: - Date - JavaScript - Method - Prototype - Reference translation_of: Web/JavaScript/Reference/Global_Objects/Date/getFullYear ---
{{JSRef("Global_Objects", "Date")}}

Resumo

O método getFullYear() retorna o ano da data especificada de acordo com a hora local.

Use este método ao invés do {{jsxref("Date.prototype.getYear()", "getYear()")}}.

Sintaxe

dateObj.getFullYear()

Parâmetros

Nenhum.

Retorna

O valor retornado por getFullYear() é um número absoluto. Para datas entre os anos 1000 e 9999, getFullYear() retorna um número de quatro dígitos, por exemplo, 1995. Use esta função para ter certeza de que o ano é compatível com os anos depois de 2000.

Exemplos

Exemplo: Usando getFullYear()

O exemplo seguinte atribui o valor de quatro dígitos do ano corrente à variável year.

var today = new Date();
var year = today.getFullYear();

Especificações

Especificação Status Comentário
ECMAScript 1st Edition. Standard Definição inicial. Implementado em JavaScript 1.3.
{{SpecName('ES5.1', '#sec-15.9.5.10', 'Date.prototype.getFullYear')}} {{Spec2('ES5.1')}}  
{{SpecName('ES6', '#sec-date.prototype.getfullyear', 'Date.prototype.getFullYear')}} {{Spec2('ES6')}}  

Compatibilidade com navegadores

{{CompatibilityTable}}
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}

Veja também