JavaScript获取周末日期方法解析

在IT行业这个发展更新速度很快的行业，只有不停止的学习，才不会被行业所淘汰。如果你是文章学习者，那么本文《JavaScript Intl API 获取周末日期方法》就很适合你！本篇内容主要包括##content_title##，希望对大家的知识积累有所帮助，助力实战开发！

本文介绍如何利用现代 JavaScript 的 `Intl.Locale.getWeekInfo()` 方法，准确获取各地区文化（locale）定义的周末起止日（如周五至周六、仅周日等），无需第三方库，兼容主流浏览器。

在国际化 Web 应用中，简单假设“周末 = 周六 + 周日”会引发逻辑错误——例如沙特阿拉伯、阿联酋等国家将周五和周六视为法定周末；尼泊尔实行周日至周四工作制，周末仅为周五和周六；而伊朗则以周四和周五为周末；墨西哥部分机构甚至仅将周日视为休息日。因此，动态识别目标 locale 的周末范围至关重要。

幸运的是，ECMAScript 国际化标准（ECMA-402）已通过 Intl.Locale.getWeekInfo() 提供了原生支持。该方法返回一个包含 weekend 属性的对象，其值为一个升序排列的数字数组，表示该语言环境（culture）中周末对应的星期几编号（按 ISO 8601 标准：周一=1，周日=7）。

✅ 示例代码如下：

function getWeekendRange(locale: string): { start: number; end: number } | null {
  try {
    const localeObj = new Intl.Locale(locale);
    const weekInfo = localeObj.getWeekInfo();

    if (!Array.isArray(weekInfo.weekend) || weekInfo.weekend.length === 0) {
      return null; // 无明确周末定义（极少见）
    }

    const [first, ...rest] = weekInfo.weekend;
    const last = rest.length > 0 ? rest[rest.length - 1] : first;

    // 注意：weekend 数组未必连续（如某些 locale 可能仅标记周日为 weekend），但实践中绝大多数为连续区间
    // 我们取最小与最大值作为逻辑上的“起止日”
    return {
      start: Math.min(...weekInfo.weekend),
      end: Math.max(...weekInfo.weekend)
    };
  } catch (e) {
    console.warn(`Unsupported locale: ${locale}`, e);
    return null;
  }
}

// 使用示例
console.log(getWeekendRange('en-US'));     // { start: 6, end: 7 } → 周六、周日（ISO: 6=Sat, 7=Sun）
console.log(getWeekendRange('ar-SA'));     // { start: 5, end: 6 } → 周五、周六
console.log(getWeekendRange('ne-NP'));     // { start: 5, end: 6 } → 尼泊尔同为周五至周六
console.log(getWeekendRange('he-IL'));     // { start: 6, end: 7 } → 以色列通常为周六至周日（安息日）
console.log(getWeekendRange('th-TH'));     // { start: 6, end: 7 } → 泰国亦为周末双日

⚠️ 注意事项：

• 浏览器兼容性：getWeekInfo() 自 Chrome 109、Edge 109、Firefox 111、Safari 17.4 起支持。生产环境建议添加特性检测或降级策略（如 fallback 到预置映射表）。
• weekend 数组不保证连续：虽然绝大多数 locale 的周末是连续两天（如 [5,6] 或 [6,7]），但理论上可包含离散值（如 [7] 表示仅周日）。上述函数按“最小/最大”取值，适用于常见业务场景（如高亮日历周末区域、跳过周末计算工作日）；若需精确匹配所有周末日，应直接遍历 weekInfo.weekend 数组。
• Locale 必须有效且带区域标识：'ar'（仅语言）可能无法返回准确结果，推荐使用带国家/地区的完整 locale，如 'ar-SA'、'fa-IR'。
• Node.js 支持：需 Node.js ≥ 19.2 且启用 --experimental-intl-api（v20.3+ 默认启用），或使用 full-icu 数据包。

? 总结：Intl.Locale.getWeekInfo() 是目前最权威、标准化的解决方案，直接对接 Unicode CLDR 数据源，覆盖全球 200+ 地区。相比依赖静态 JSON 映射或过时库（如 moment.js），它具备零依赖、自动更新、语义准确等优势。在构建跨文化日程、排班、工单系统时，应优先采用此 API，并辅以优雅降级机制确保兼容性。

今天关于《JavaScript获取周末日期方法解析》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！