Saltar al contenido
Biblioteca estándar

Fechas: Date y Temporal

Lección 1 de 713 min4 ejercicios

Date llegó a JavaScript en 1995, copiado casi al pie de la letra de una clase de Java que el propio Java abandonó poco después. Tiene meses que empiezan en 0, objetos que cambian sin avisar y una relación confusa con las zonas horarias. Temporal, terminada en TC39 y ya en los navegadores, es su reemplazo moderno.

Los problemas de Date

const fecha = new Date(2026, 0, 15);    // ¡enero es el mes 0!
console.log(fecha.getMonth());           // 0

const otra = fecha;
otra.setDate(20);                        // muta el objeto…
console.log(fecha.getDate());            // …y "fecha" también cambió: 20

const sorpresa = new Date(2026, 0, 31);
sorpresa.setMonth(1);                    // ¿31 de febrero?
console.log(sorpresa.getMonth() + 1, sorpresa.getDate());  // 3 3: se "pasó" a marzo

Y hay más: un Date es siempre un instante en UTC que se muestra en la zona horaria del equipo, así que “la misma fecha” cambia según dónde corre el código. Y analizar textos (new Date("2026-01-15") frente a new Date("2026/01/15")) da resultados distintos según el formato.

Temporal: un tipo para cada cosa

Temporal separa conceptos que Date mezclaba:

Tipo Representa Ejemplo
PlainDate Una fecha de calendario Un cumpleaños: 2026-03-14
PlainTime Una hora del día Apertura de la tienda: 09:30
PlainDateTime Fecha y hora, sin zona Una alarma “a las 7 donde esté”
ZonedDateTime Fecha y hora en una zona Una reunión en Lima: 2026-03-14T10:00[America/Lima]
Instant Un momento exacto, universal Cuándo se guardó un registro
Duration Una cantidad de tiempo P1DT2H (1 día y 2 horas)
const cumple = Temporal.PlainDate.from("2026-03-14");
console.log(cumple.year, cumple.month, cumple.day);  // marzo es el 3
console.log(cumple.dayOfWeek, cumple.daysInMonth);  // 6 (sábado), 31

const apertura = Temporal.PlainTime.from("09:30");
console.log(apertura.add({ minutes: 45 }).toString());

const hoy = Temporal.Now.plainDateISO();
console.log(typeof hoy.toString());

Inmutables y con aritmética de calendario

Todos los objetos de Temporal son inmutables: add, subtract y with devuelven uno nuevo. Y la aritmética respeta el calendario:

const fin = Temporal.PlainDate.from("2026-01-31");

console.log(fin.add({ months: 1 }).toString());   // 2026-02-28: el último día válido
console.log(fin.with({ day: 1 }).toString());     // 2026-01-01
console.log(fin.toString());                      // intacta

Diferencias y comparaciones

const inicio = Temporal.PlainDate.from("2026-01-10");
const entrega = Temporal.PlainDate.from("2026-03-25");

const falta = inicio.until(entrega, { largestUnit: "months" });
console.log(falta.toString(), falta.months, falta.days);  // P2M15D

console.log(Temporal.PlainDate.compare(inicio, entrega));   // -1: inicio va antes
console.log(inicio.equals(Temporal.PlainDate.from("2026-01-10")));

compare devuelve -1, 0 o 1, así que sirve directamente para ordenar: fechas.sort(Temporal.PlainDate.compare).

Zonas horarias

ZonedDateTime conoce las reglas de cada zona, incluidos los cambios de horario de verano:

const reunion = Temporal.ZonedDateTime.from("2026-03-14T10:00[America/Lima]");

console.log(reunion.withTimeZone("Europe/Madrid").toPlainTime().toString());
console.log(reunion.withTimeZone("Asia/Tokyo").toPlainDateTime().toString());

Para mostrar fechas a las personas, cada tipo tiene toLocaleString, que usa Intl (el tema Internacionalización):

const cumple = Temporal.PlainDate.from("2026-03-14");
console.log(cumple.toLocaleString("es", { dateStyle: "full" }));

Resumen

  • Date tiene meses desde 0, es mutable, mezcla instantes con zonas horarias y analiza textos de forma inconsistente.
  • Temporal (ES2027) ofrece un tipo para cada concepto: PlainDate, PlainTime, PlainDateTime, ZonedDateTime, Instant y Duration.
  • Sus objetos son inmutables: add, subtract y with devuelven otros nuevos.
  • until/since miden diferencias; compare y equals comparan.
  • Para mostrar, toLocaleString; para guardar, el texto ISO de toString().

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Fechas sin sorpresas

Elige una respuesta en cada pregunta.

  1. En new Date(2026, 0, 15), ¿qué mes es el 0?

  2. ¿Qué tiene de peligroso que Date sea mutable?

  3. ¿Qué tipo de Temporal usarías para un cumpleaños?

  4. ¿Qué devuelve Temporal.PlainDate.from("2026-01-31").add({ months: 1 })?

Ordena la salida: Un mes después del 31

La misma operación con Date y con Temporal. Ordena lo que aparecería en la consola.

const d = new Date(2026, 0, 31);d.setMonth(d.getMonth() + 1);console.log(d.getMonth() + 1, d.getDate()); const p = Temporal.PlainDate.from("2026-01-31");console.log(p.add({ months: 1 }).toString());console.log(p.toString()); const dur = Temporal.PlainDate.from("2026-01-01").until("2026-03-15");console.log(dur.days);

Consola, de arriba abajo

  1. 2026-01-31
  2. 3 3
  3. 73
  4. 2026-02-28

Detective: Cambiar una fecha inmutable

Se quería el día siguiente a Navidad. Encuentra la línea que falla y elige el arreglo.

Consola

fechas.js:2
navidad.setDate(26);
        ^

TypeError: navidad.setDate is not a function

Paso 1: toca la línea de código que causa el error.

Laboratorio: Días que faltan

Escribe diasEntre(desde, hasta) con Temporal.PlainDate.

programa.jsse ejecuta mientras escribes

$ node programa.js

(escribe tu código: se ejecuta solo)

Lo que debe cumplir

  • Imprime 24 y 28 (pendiente)
  • Funciona entre años, incluido uno bisiesto: de 2028-01-01 a 2029-01-01 hay 366 días (pendiente)
  • Usa Temporal.PlainDate (pendiente)

    domina-js · JavaScript en español, gratis y paso a paso.