Duration

A duration is a distance between two instants, two timestamps.

We initialize durations with a quantity or as a difference between two date objects.

We describe a duration with date and time components.

format duration with Luxon

We use the Luxon library to format durations. We focus on the human-friendly durations.

from milliseconds

const dur = Duration.fromMillis(1_000_000)

dur.toHuman() // '1000000 milliseconds'
dur.rescale().toHuman() // '16 minutes, 40 seconds'

from calendar components

const dur = Duration.fromObject({ hour: 36 })

dur.toHuman() // '36 hours'
dur.rescale().toHuman() // '1 day, 12 hours'
dur.shiftTo("minutes").toHuman() // '2160 minutes'

from difference

const dur = zdt2.diff(zdt1, ["years", "months", "days"])
dur.toHuman() // "3 years, 2 months, 14 days"