Date.prototype.setUTCFullYear()

O método setUTCFullYear() atribui o ano completo na data especificada de acordo com o horário universal.

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()

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

Especificações

Especificação
ECMAScript (ECMA-262)
The definition of 'Date.prototype.setUTCFullYear' in that specification.

Compatibilidade de navegador

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
setUTCFullYearChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 4Opera Full support 4Safari Full support 1WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0nodejs Full support 0.1.100

Legend

Full support  
Full support

Veja também