CKTIS / JavaScript
Date — marcas de tiempo y el año UTC
Date almacena una marca de tiempo. Aprende a leer y cambiar el año UTC, entiende cómo se muta el objeto y cómo se normalizan las fechas, incluido el paso del 29 de febrero a un año no bisiesto.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
new Date(milliseconds)
new Date(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])Date es un objeto integrado de ECMAScript que almacena milisegundos desde 1970-01-01T00:00:00.000Z, o NaN si la fecha no es válida. No almacena una zona horaria. Los métodos locales interpretan la misma marca de tiempo según la zona horaria del entorno; los métodos UTC usan UTC.
Date.prototype.getUTCFullYear() devuelve el año UTC completo, o NaN si la fecha no es válida. Date.prototype.setUTCFullYear(year[, month[, day]]) modifica el objeto y devuelve la marca de tiempo resultante, no un objeto Date. Los meses usan los índices 0–11, mientras que los días del mes empiezan en 1. Si la fecha original es válida, el método usa el valor original en UTC como dato de entrada para cada argumento de mes o día que se omita. La normalización puede cambiar el mes y el día en el resultado. Si el resultado es válido, la hora en UTC permanece igual.
El setter normaliza los valores: cambiar el año del 29 de febrero a uno no bisiesto produce el 1 de marzo. Un año de 0–99 se interpreta literalmente, a diferencia de lo que ocurre con el constructor Date de varios argumentos. Para una fecha no válida, el setter usa la marca de tiempo 0 como punto de partida; aun así, los argumentos numéricos no válidos pueden producir NaN.
El ejemplo usa una Z explícita y métodos UTC para que el resultado no dependa de la zona horaria local. También comprueba que la marca de tiempo devuelta coincide con el objeto modificado.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.