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
Datetiene 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,InstantyDuration. - Sus objetos son inmutables:
add,subtractywithdevuelven otros nuevos. until/sincemiden diferencias;compareyequalscomparan.- Para mostrar,
toLocaleString; para guardar, el texto ISO detoString().
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Fechas sin sorpresas
Resuelto
Elige una respuesta en cada pregunta.
En
new Date(2026, 0, 15), ¿qué mes es el0?¿Qué tiene de peligroso que
Datesea mutable?¿Qué tipo de Temporal usarías para un cumpleaños?
¿Qué devuelve
Temporal.PlainDate.from("2026-01-31").add({ months: 1 })?
Ordena la salida: Un mes después del 31
Resuelto
La misma operación con Date y con Temporal. Ordena lo que aparecería en la consola.
1const d = new Date(2026, 0, 31);2d.setMonth(d.getMonth() + 1);3console.log(d.getMonth() + 1, d.getDate());4 5const p = Temporal.PlainDate.from("2026-01-31");6console.log(p.add({ months: 1 }).toString());7console.log(p.toString());8 9const dur = Temporal.PlainDate.from("2026-01-01").until("2026-03-15");10console.log(dur.days);Consola, de arriba abajo
- 2026-01-31
- 3 3
- 73
- 2026-02-28
Date intenta el 31 de febrero, no existe, y "rebalsa" al 3 de marzo. Temporal se queda en el último día de febrero, y p no cambia, porque es inmutable. until mide la distancia entre dos fechas: 31 + 28 + 14 días.
Detective: Cambiar una fecha inmutable
Resuelto
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 functionPaso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Días que faltan
Resuelto
Escribe diasEntre(desde, hasta) con Temporal.PlainDate.
$ node programa.js
Lo que debe cumplir
- Imprime
24y28(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)
Una solución
1function diasEntre(desde, hasta) {2 return Temporal.PlainDate.from(desde).until(hasta).days;3}4 5console.log(diasEntre("2026-12-01", "2026-12-25"));6console.log(diasEntre("2026-02-01", "2026-03-01"));Con Date habría que restar milisegundos, dividir por 86 400 000 y pelear con los cambios de horario de verano. PlainDate trabaja con días de calendario, así que el resultado es exacto, bisiestos incluidos.