JavaScript Intl.Locale.getWeekInfo 怎样取得地区的周末定义

JavaScript 要按地区生成日历、排班或工作日选择器时，不能把周六和周日写死。更稳妥的做法是创建 Intl.Locale，调用 getWeekInfo()，从返回对象的 weekend 数组读取该地区的周末日。

官方地址：https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getWeekInfo

核心写法是 new Intl.Locale("ar-AF").getWeekInfo()。返回值中的数字使用 ISO 星期编号：1 表示星期一，7 表示星期日；周末并不一定是 [6, 7]。

先看 getWeekInfo 返回什么

getWeekInfo() 不接收参数，返回地区对应的周规则对象。它包含 firstDay、weekend 和 minimalDays 三个字段：

• firstDay：该地区一周从星期几开始，取值范围是 1 到 7。
• weekend：周末日组成的数组，例如 [6, 7] 或 [5, 6]。
• minimalDays：计算月周或年周时，第一周至少需要包含几天。

例如英国英语通常以星期一开周，周末为周六和周日；阿富汗阿拉伯语地区的首日和周末组合则不同。

用地区标签读取周末数组

把地区标签交给 Intl.Locale，再直接读取 weekend。下面的示例保留了原始数组，便于后续渲染日历或保存配置。

function readWeekRule(localeTag) {
  // Locale 负责保存 BCP 47 地区标签，规则由运行时的 Intl 数据提供。
  const locale = new Intl.Locale(localeTag);
  // getWeekInfo 返回首日、周末和周编号所需的最小天数。
  const weekInfo = locale.getWeekInfo();

  return {
    locale: locale.toString(),
    firstDay: weekInfo.firstDay,
    weekend: [...weekInfo.weekend],
    minimalDays: weekInfo.minimalDays
  };
}

console.log(readWeekRule("en-GB"));
console.log(readWeekRule("ar-AF"));

这里用展开语法复制 weekend，避免业务层直接持有返回对象中的数组引用。示例输出应以当前运行环境的 Intl 数据为准，文章只依赖字段契约，不把某个地区的结果硬编码成通用规则。

把 weekend 用成可复用的判断函数

业务代码通常拿到的是 JavaScript Date 的 getDay() 结果，它使用 0 表示星期日、1 表示星期一，和 getWeekInfo() 的 1 到 7 编号不同。因此要先做一次编号转换。

function isLocaleWeekend(date, localeTag) {
  // Date.getDay 使用 0=周日、1=周一；先统一为 1=周一、7=周日。
  const isoDay = date.getDay() === 0 ? 7 : date.getDay();
  const weekendDays = new Intl.Locale(localeTag).getWeekInfo().weekend;
  // includes 只负责判断地区规则是否包含当前星期，不改变日期对象。
  return weekendDays.includes(isoDay);
}

const date = new Date("2026-10-31T12:00:00Z");
console.log(isLocaleWeekend(date, "en-GB"));

如果应用还要显示“本周第几周”，就同时使用 minimalDays。它不是周末字段的别名，而是周编号算法的输入；例如 ISO 8601 规则要求新年的第一周至少包含 4 天。

兼容性和参数边界要提前处理

MDN 当前将该能力标为 2026 年 Baseline，新版设备和浏览器已经覆盖，但旧环境可能没有该方法。部分早期实现曾提供名为 weekInfo 的访问器属性，不能把两种形态混写。

function getWeekInfoSafe(localeTag) {
  // 先确认方法存在，旧运行时没有它时交给调用方选择降级策略。
  if (typeof Intl?.Locale !== "function" ||
      typeof Intl.Locale.prototype.getWeekInfo !== "function") {
    return null;
  }
  // 读取方法结果后再交给日历组件，避免把兼容逻辑散落到渲染层。
  return new Intl.Locale(localeTag).getWeekInfo();
}

降级时可以使用产品已经约定的默认周规则，或者让服务端下发地区配置；不要因为浏览器缺少 API 就无条件假设所有地区周末都是周六、周日。地区标签本身也应来自可信的 BCP 47 配置，未知标签要在进入业务层前处理异常。

常见问题

weekend 返回的是日期还是星期编号？

返回的是 1 到 7 的星期编号数组，不是日期字符串，也不是某一周的具体日期。

为什么不能直接判断 getDay() === 0 或 6？

那只适用于固定周末假设。跨地区日历应使用 weekend，并先把 Date.getDay() 的编号转换到同一套范围。

firstDay 能直接决定周编号吗？

不能。周起始日和第一周最少天数共同影响周编号，涉及周数计算时还要读取 minimalDays。

总结：读取地区周末定义只需要 new Intl.Locale(tag).getWeekInfo().weekend，但真正接入日历时要同步处理 0/7 编号差异、minimalDays 的周编号含义，以及旧浏览器的降级路径。