Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes