CKTIS / JavaScript
Date — marcas temporais e o ano UTC
Date armazena uma marca temporal. Aprende a ler e alterar o ano UTC, a compreender a mutação do objeto e a lidar com a normalização de datas, incluindo a passagem de 29 de fevereiro para um ano não bissexto.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new Date(milliseconds)
new Date(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])Date é um objeto incorporado do ECMAScript que armazena milissegundos desde 1970-01-01T00:00:00.000Z, ou NaN para uma data inválida. Não armazena um fuso horário. Os métodos locais interpretam a mesma marca temporal de acordo com o fuso horário do ambiente; os métodos UTC usam UTC.
Date.prototype.getUTCFullYear() devolve o ano UTC completo, ou NaN para uma data inválida. Date.prototype.setUTCFullYear(year[, month[, day]]) altera o objeto e devolve a marca temporal resultante, não um objeto Date. Os meses usam os índices 0–11, enquanto os dias do mês começam em 1. Se a data original for válida, para cada argumento de mês ou de dia omitido, o método usa o valor original em UTC como dado de entrada. A normalização pode alterar o mês e o dia no resultado. Se o resultado for válido, a hora em UTC mantém-se inalterada.
O setter normaliza os valores: alterar o ano de 29 de fevereiro para um ano não bissexto produz 1 de março. Um ano entre 0–99 é interpretado literalmente, ao contrário do construtor Date com vários argumentos. Para uma data inválida, o setter usa a marca temporal 0 como ponto de partida; ainda assim, argumentos numéricos inválidos podem produzir NaN.
O exemplo usa um Z explícito e métodos UTC para que o resultado não dependa do fuso horário local. Também verifica se a marca temporal devolvida corresponde ao objeto alterado.
Exemplos
const date = new Date("2024-02-29T12:00:00.000Z");
console.log(date.getUTCFullYear());
const timestamp = date.setUTCFullYear(2025);
console.log(date.toISOString());
console.log(timestamp === date.getTime());Resultado
2024 2025-03-01T12:00:00.000Z true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.