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