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 julho de 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
const event = new Date("August 19, 1975 23:15:30");
event.setFullYear(1969);
console.log(event.getFullYear());
// Expected output: 1969
event.setFullYear(0);
console.log(event.getFullYear());
// Expected output: 0
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® 2026 Language Specification # sec-date.prototype.setfullyear |
Compatibilidade com navegadores
Loading…