Skip to content

getLargestDateDurationUnit

getLargestDateDurationUnit(units: DateDurationUnit[]): DateDurationUnit
import { getLargestDateDurationUnit } from "@northguild/gmt/plain/calculate";

Return the largest DateDurationUnit from the provided array.

  • Returns the largest unit based on Temporal’s unit order: years > months > weeks > days.
  • Defaults to “days” if no valid unit is found in the array.
Parameter Type Description
units DateDurationUnit[] array of DateDurationUnits to evaluate

the largest DateDurationUnit found in the array, or “days” if none are valid

getLargestDateDurationUnit(["months", "days"]) // "months"
getLargestDateDurationUnit(["weeks", "days"]) // "weeks"
getLargestDateDurationUnit(["days"]) // "days"
getLargestDateDurationUnit([]) // "days"

plain/calculate/getLargestDateDurationUnit.ts