月份名稱

Locale#months 屬性應為包含月份名稱的陣列。

TIP

此功能需要 UpdateLocale 插件才能正常運作。

dayjs.extend(updateLocale);

dayjs.updateLocale('en', {
  months: [
    'January',
    'February',
    'March',
    'April',
    'May',
    'June',
    'July',
    'August',
    'September',
    'October',
    'November',
    'December',
  ],
});

額外 Token 處理

若需要更複雜的邏輯來判斷月份名稱（例如，根據不同格式顯示不同的語法），Locale#months 可以是一個函數，其簽名如下所示。此函數應始終傳回月份名稱。

dayjs.updateLocale('en', {
  months: function (dayjsInstance, format) {
    // dayjsInstance 是目前正在格式化的 Day.js 物件
    // format 是格式字串
    if (/^MMMM/.test(format)) {
      // 如果格式字串以 'MMMM' 開頭
      return monthShortFormat[dayjsInstance.month()];
    } else {
      return monthShortStandalone[dayjsInstance.month()];
    }
  },
});