/** * 持续时间单位联合类型 */ export type DurationUnitType = "year" | "month" | "week" | "day" | "hour" | "minute" | "second" | "millisecond"; /** * 格式化持续时间的结果项 */ export interface FormatDurationItem { value: number; unit: DurationUnitType; } /** * 格式化持续时间 * @param milliseconds 毫秒数 * @param options 配置选项 * @param options.maxDisplayUnits 最大展示单位数量,默认为 2 * @param options.minUnit 最小展示单位,默认为 "second"(秒),不满足进位逻辑的剩余时间会被忽略 * @returns 格式化后的持续时间数组,每个元素包含数值和单位 * @example * formatDuration(3661000) // [{ value: 1, unit: "hour" }, { value: 1, unit: "minute" }] * formatDuration(90061000, { maxDisplayUnits: 3 }) // [{ value: 1, unit: "day" }, { value: 1, unit: "hour" }, { value: 1, unit: "minute" }] * formatDuration(5000) // [{ value: 5, unit: "second" }] * formatDuration(1500, { minUnit: "second" }) // [{ value: 1, unit: "second" }] (500ms 被忽略) */ export declare function formatDuration(milliseconds: number, options?: { maxDisplayUnits?: number; minUnit?: DurationUnitType; }): FormatDurationItem[];