創建

要創建一個 duration 物件，可以使用 dayjs.duration() 方法，並傳入以毫秒為單位的時間長度。

TIP

這需要 Duration 插件的支援才能正常工作。

dayjs.extend(duration);

dayjs.duration(100); // 100 毫秒

如果需要使用毫秒以外的單位創建 duration 物件，可以將單位作為第二個參數傳遞給 dayjs.duration() 方法。

dayjs.duration(2, 'days');

可用單位

單位	簡寫
days	d
weeks	w
months	M
years	y
hours	h
minutes	m
seconds	s
milliseconds	ms

如果需要使用多個單位，可以傳遞一個包含對應值的物件。

dayjs.duration({
  seconds: 2,
  minutes: 2,
  hours: 2,
  days: 2,
  weeks: 2,
  months: 2,
  years: 2,
});

Day.js 支援解析 ISO 8601 格式的 duration 字串。

dayjs.duration('P1Y2M3DT4H5M6S');
dayjs.duration('P1M');