Duraciones con Temporal API

Mediante el método .from() podemos crear duraciones, pudiendo utilizar formas diferentes:

// Crear a partir de un string
Temporal.Duration.from("P3Y5MT3H30M");
Temporal.Duration.from("PT4H25M");

// Crear a partir de un objeto
Temporal.Duration.from({ hours: 4, minutes: 30 });

También se puede crear una duración, en lugar de con un o un , utilizando un objeto Temporal.Duration, donde se crea una copia.

El método .compare() nos permite comparar dos duraciones y obtener un valor numérico que indica si la primera duración es más pequeña que la segunda (-1), si es igual (0) o si la primera duración es más grande que la segunda (1):

const t1 = Temporal.Duration.from("PT1H30M");
const t2 = Temporal.Duration.from("PT5H30M");

Temporal.Duration.compare(t1, t2);    // -1
Temporal.Duration.compare(t1, t1);    // 0
Temporal.Duration.compare(t2, t1);    // 1

Mediante los siguientes métodos podemos realizar operaciones con nuestras duraciones. Por ejemplo, utilizar .add() para sumar una duración o .subtract() para restar una duración:

En ambos casos, devuelve un objeto de duración Temporal.

Mediante los siguientes métodos podemos realizar ajustes sobre una duración concreta. Por ejemplo, los métodos .abs() y .negated() se encargan de trabajar con el signo de la duración:

Por otro lado, el método .round() nos permite, no sólo redondear una duración a la unidad mínima indicada, sino también a revisar y simplificar las duraciones:

Temporal.Duration.from("PT4H30M15S").round("minutes");    // PT4H30M
Temporal.Duration.from("PT4H30M15S").round("hours");      // PT5H
Temporal.Duration.from("P2DT25H30M");                     // P2DT25H30M
Temporal.Duration.from("P2DT25H30M").round("minutes");    // P3DT1H30M

El método .total() nos permite obtener el total de duración en una sola unidad:

Temporal.Duration.from("P2DT25H30M").total("hours");      // 73.5
Temporal.Duration.from("P2DT25H30M").total("minutes");    // 4410
Temporal.Duration.from("P2DT25H30M").total("days");       // 3.0625

Por último, mediante el método .with() podemos hacer reemplazos en unidades de la duración:

Temporal.Duration.from("P2DT25H30M").with({ minutes: 15 });   // P2DT25H15M
Temporal.Duration.from("P2DT25H30M").with({ hours: 48 });     // P2DT48H30M

Por último, tenemos algunos métodos que nos permiten devolver la duración en un formato específico, como puede ser un , que lo muestra como formato ISO 8601, o con .toLocaleString() que lo devuelve en una versión legible más orientado a configuraciones regionales:

Para ello, vamos a hacer lo siguiente:

// Mediante Temporal.Duration
const df = new Intl.DurationFormat("es");
const duration = Temporal.Duration.from("PT4h30m");

const text = df.format(duration); // "4 h y 30 min"

Observa que con Intl.DurationFormat() podemos establecer una configuración regional. En nuestro caso hemos indicado "es" por parámetro para que utilice formato español, pero de se le puede indicar otros como fr o en, por ejemplo. Si se deja vacío, se usa el que se tiene por defecto en la configuración regional.

Una vez creado, podemos utilizar el método .format() y formatear la duración.

En este segundo ejemplo, indicamos un objeto de opciones al crear una configuración regional con Intl.DurationFormat():

// Mediante Temporal.Duration con opciones
const options = { style: "long" };
const df = new Intl.DurationFormat("es", options);
const duration = Temporal.Duration.from("PT4h30m");

const text = df.format(duration); // "4 horas y 30 minutos"

En este caso, conseguimos el mismo formato en español, pero formato largo.

En el caso de que tengamos un navegador que no tenga soporte para Temporal.Duration, podemos utilizar un objeto simple de Javascript, como el que puedes ver a continuación:

// Mediante objeto
const df = new Intl.DurationFormat("es");
const duration = { hours: 5, minutes: 20 };

const text = df.format(duration); // "5 h y 20 min"

Sin embargo, lo ideal a largo plazo es utilizar Temporal.Duration ya que tendríamos soporte para realizar operaciones sobre fechas y duraciones.