Date.prototype.setUTCFullYear()

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 setUTCFullYear() atribui o ano completo na data especificada de acordo com o horário universal.

Experimente

Sintaxe

dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])

Parâmetros

yearValue

Um inteiro especificando o valor numérico do ano, por exemplo, 1995.

monthValue

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

dayValue

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

Valor de retorno

O número de milissegundos 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 dayValue, os valores retornados dos métodos getUTCMonth() e getUTCDate() serão utilizados.

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

Exemplos

Usando setUTCFullYear()

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

Especificações

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

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também