La API Temporal

Por ejemplo, utilizando el método .from() podemos crear fechas, indicando por parámetro fechas en , o un propio objeto Temporal:

// Usando un string
const date = Temporal.PlainDate.from("2025-06-07");
const time = Temporal.PlainDateTime.from("13:30:00");
const yearmonth = Temporal.PlainYearMonth.from("2025-06");
const datetime = Temporal.PlainDateTime.from("2025-06-07T13:30:00");
const day = Temporal.ZonedDateTime.from("2025-06-07T13:30:00[Atlantic/Canary]");

// Usando un objeto
const date = Temporal.PlainDateTime.from({
  year: 2025,
  month: 6,
  day: 14,
  hour: 14,
  minute: 30
})

// Usando una fecha Temporal
const date = Temporal.PlainDate.from(datetime);

Otra opción, quizás más cómoda, es utilizar alguno de los métodos que tiene Temporal.Now. Esto nos permite crear objetos de fechas Temporal con la fecha actual ya seteada:

Además, también podemos usar Temporal.Now.timeZoneId() para obtener un con la zona horaria.

El tipo de dato Temporal.Instant representa un instante o momento exacto en el tiempo en UTC. Puedes crearlo a través de un con el método .from():

También puedes usar los métodos .fromEpochMilliseconds() o .fromEpochNanoseconds() para crear una fecha a partir de un número TIMESTAMP en milisegundos o nanosegundos:

// Desde strings
const date = Temporal.Instant.from("2025-06-07T14:30:00Z");
const date = Temporal.Instant.from(new Date().toJSON());

// Timestamps
const date = Temporal.Instant.fromEpochMilliseconds(new Date());
const date = Temporal.Instant.fromEpochNanoseconds(BigInt(new Date()));

// Date
const date = new Date().toTemporalInstant();

Por último, observa que el clásico tipo de dato Date, incorpora un nuevo método .toTemporalInstant() que genera una fecha Instant a partir de una Date.

Por último, aunque no sirve para crear nuevas fechas, podemos utilizar el método .compare() para comparar entre dos fechas y obtener un número que indicará si la primera fecha es anterior a la segunda (-1), igua igual (0), o posterior a la segunda (1):

const before = Temporal.PlainDateTime.from("2025-06-07");
const after = Temporal.PlainDateTime.from("2025-06-08");

Temporal.PlainDate.compare(before, after);    // -1
Temporal.PlainDate.compare(after, after);     // 0
Temporal.PlainDate.compare(after, before);    // 1

En primer lugar, las fechas generadas con Temporal suelen tener los métodos .add(), .subtract(), .since() y .until(). Los dos primeros sirven para sumar o restar unidades de tiempo a una fecha, mientras que los dos últimos calculan la duración entre una fecha y otra:

En estos métodos se pueden utilizar Temporal.Duration, un objeto de Javascript que representa duraciones y que veremos en el próximo artículo.

Al margen del método estático .compare() que vimos anteriormente, también tenemos métodos como .equals() que nos puede venir muy bien para comparar nuestra fecha Temporal con otra pasada por parámetro, devolviéndonos un para indicar si es igual o no.

Usa este método para comparar fechas si buscas saber si son la misma, ya que otras formas o métodos podrían resultar inexactos o poco recomendados.

Temporal.Now.instant().equals(new Date().toTemporalInstant());    // true
Temporal.Now.instant() === new Date().toTemporalInstant();        // false

Por otro lado, podemos utilizar los siguientes métodos para generar nuevas fechas realizando ciertos cambios:

Por ejemplo, .round() nos permite redondear una fecha y eliminar datos innecesarios, mientras que los métodos que comienzan por .with() nos crear una nueva fecha y alterar ciertos detalles de la misma:

Temporal.PlainDateTime.from("2025-06-07T14:30:00").with({ hour: 8, day: 20 });
// Temporal.PlainDateTime 2025-06-20T08:30:00

De la misma forma podemos hacerlo con .withPlainTime() o .withTimeZone(), cambiando detalles específicos. Además, con .withCalendar() podemos incluso cambiar a otro tipo de calendario.

Los tipos de calendario del navegador se pueden consultar con Intl.supportedValuesOf("calendar"). Algunos de ellos suelen ser: chinese, gregory, indian, iso8601, japanese...

Mediante los métodos que comienzan por .to podemos convertir una fecha de un formato a otro. Funcionan de forma muy similar a como funcionaban los métodos que comienzan por .to en Date.

Por último, algunos métodos son útiles para las zonas horarias. Por ejemplo, el método .getTimeZoneTransition() nos permite obtener los límites de cambio de zona horaria, pasándole el parámetro "next" o "previous":

Por otro lado, .startOfDay() nos devuelve cuando comienza la zona horaria en la franja actual.