Date.prototype.setFullYear()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

O método setFullYear() atribui o ano completo para a data especificada de acordo com o horário universal (UTC). Retorna uma nova data e hora.

Experimente

Sintaxe

dateObj.setFullYear(yearValue[, monthValue[, dateValue]])

Parâmetros

yearValue

Um inteiro especificando o valor número de um ano, por exemplo, 1995.

monthValue

Opcional. Um inteiro entre 0 e 11 representando os meses Janeiro até Dezembro.

dateValue

Opcional. Um inteiro entre 1 e 31 representando o dia do mês. Se você especificar o parâmetro dateValue, você deve também especificar monthValue.

Valor retornado

O número de milisegundos entre 1 de Janeiro de 1970 00:00:00 UTC e a data atualizada.

Descrição

Se você não especificar os parâmetros monthValue e dateValue, os valores retornados dos métodos getMonth() e getDate() são usados.

Se um parâmetro que você especificou está fora do alcance esperado, setFullYear() tenta atualizar os outros parâmetros e a informação de data no objeto Date adequadamente. Por exemplo, se você especificar 15 para o monthValue, o ano será incrementado em 1 (yearValue + 1), e 3 é usado para o mês.

Exemplos

Usando setFullYear()

js
var theBigDay = new Date();
theBigDay.setFullYear(1997);

Especificações

Specification
ECMAScript Language Specification
# sec-date.prototype.setfullyear

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também