使用JavaScript获取本地化星期短名称（周一至周日顺序）-js教程-PHP中文网

使用JavaScript获取本地化星期短名称（周一至周日顺序）

霞舞

发布： 2025-11-10 19:48:02

原创

485人浏览过

使用javascript获取本地化星期短名称（周一至周日顺序）

本文详细介绍了如何在JavaScript中利用`Intl.DateTimeFormat` API，以周一至周日的固定顺序，生成指定语言环境下星期的本地化短名称列表。通过巧妙的日期计算和格式化方法，开发者可以轻松实现跨语言、按序的星期名称获取，适用于各种国际化应用场景。

JavaScript中获取本地化星期短名称的专业指南

在开发国际化（i18n）应用程序时，经常需要获取并展示当前语言环境下的星期名称。更进一步，有时还需要确保这些名称以特定的顺序排列，例如从周一到周日。JavaScript的Intl.DateTimeFormat API提供了强大的功能来满足这一需求。本文将详细讲解如何利用该API，结合日期计算逻辑，高效准确地获取按周一至周日顺序排列的本地化星期短名称。

核心概念：Intl.DateTimeFormat

Intl.DateTimeFormat 是ECMAScript国际化API的一部分，它允许我们以特定语言和格式选项格式化日期和时间。对于获取星期名称，其关键在于使用 weekday 选项。

weekday: 'short'：返回星期的短名称（例如 "Mon", "周一"）。
weekday: 'long'：返回星期的完整名称（例如 "Monday", "星期一"）。
weekday: 'narrow'：返回星期的窄名称（通常是单个字母，例如 "M", "一"）。

实现步骤与代码示例

为了获取从周一到周日的本地化短名称列表，我们需要创建一个循环，并为循环中的每一天生成一个对应的日期对象，然后使用 Intl.DateTimeFormat 进行格式化。这里的核心挑战在于如何确保日期对象代表的是我们想要的“周一”、“周二”等，而不受当前日期是周几的影响。

立即学习“Java免费学习笔记（深入）”；

以下是一个实现此功能的JavaScript代码示例：

/**
 * 获取指定语言环境下，从周一到周日顺序排列的星期短名称列表。
 * @param {string} locale - 目标语言环境字符串，例如 "en-US", "fr-FR", "zh-CN"。
 * @returns {string[]} 包含星期短名称的数组。
 */
function getLocalizedShortWeekdays(locale) {
  const shortNames = [];
  // 创建一个DateTimeFormat实例，用于获取星期的短名称
  const formatter = new Intl.DateTimeFormat(locale, {
    weekday: 'short'
  });

  // 获取一个参考日期，通常是当前日期
  const today = new Date();
  // 定义周一作为起始日（JavaScript的getDay()中，周日是0，周一是1）
  const startDay = 1; // 1 for Monday

  // 循环7次，分别代表周一到周日
  for (let i = 0; i < 7; i++) {
    // 计算当前迭代的目标星期几 (0=周日, 1=周一, ..., 6=周六)
    const targetDayOfWeek = (startDay + i) % 7; 

    // 创建一个新的日期对象，避免修改原始today
    const date = new Date(today);

    // 核心逻辑：调整日期以匹配目标星期几
    // today.getDay() 获取当前日期是星期几 (0=周日, 1=周一, ..., 6=周六)
    // (targetDayOfWeek - today.getDay() + 7) % 7 计算从当前日期到目标星期几需要调整的天数
    date.setDate(today.getDate() + ((targetDayOfWeek - today.getDay() + 7) % 7));

    // 使用formatToParts获取格式化后的日期组成部分
    const formattedParts = formatter.formatToParts(date);
    // 从组成部分中找到类型为 'weekday' 的值
    const shortName = formattedParts.find(part => part.type === 'weekday').value;
    shortNames.push(shortName);
  }
  return shortNames;
}

// 示例用法：
console.log("英语（美国）:", getLocalizedShortWeekdays("en-US"));
// 预期输出: ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]

console.log("法语（法国）:", getLocalizedShortWeekdays("fr-FR"));
// 预期输出: ["lun.", "mar.", "mer.", "jeu.", "ven.", "sam.", "dim."]

console.log("中文（中国）:", getLocalizedShortWeekdays("zh-CN"));
// 预期输出: ["周一", "周二", "周三", "周四", "周五", "周六", "周日"]

console.log("德语（德国）:", getLocalizedShortWeekdays("de-DE"));
// 预期输出: ["Mo.", "Di.", "Mi.", "Do.", "Fr.", "Sa.", "So."]

登录后复制

代码逻辑详解

Intl.DateTimeFormat(locale, { weekday: 'short' }):
- locale: 指定要使用的语言环境，如 fr-FR（法语-法国）。
- weekday: 'short': 告诉格式化器我们只需要星期的短名称。
const today = new Date();:

NameGPT名称生成器
免费AI公司名称生成器，AI在线生成企业名称，注册公司名称起名大全。

0

查看详情
- 获取一个当前的日期对象作为计算的基准。这个日期本身不重要，重要的是它的 getDay() 方法。
const startDay = 1;:
- 在 JavaScript 的 Date.prototype.getDay() 方法中，周日是 0，周一是 1，以此类推直到周六是 6。我们希望列表从周一开始，所以将 startDay 设置为 1。
for (let i = 0; i < 7; i++):
- 这个循环迭代7次，分别对应一周中的7天。
const targetDayOfWeek = (startDay + i) % 7;:
- 计算当前迭代的目标星期几（0-6）。例如：
  - i = 0: (1 + 0) % 7 = 1 (周一)
  - i = 1: (1 + 1) % 7 = 2 (周二)
  - ...
  - i = 5: (1 + 5) % 7 = 6 (周六)
  - i = 6: (1 + 6) % 7 = 0 (周日)
date.setDate(today.getDate() + ((targetDayOfWeek - today.getDay() + 7) % 7));:
- 这是确保我们得到正确星期名称的关键步骤。
- today.getDay(): 获取 today 是星期几（0-6）。
- targetDayOfWeek - today.getDay(): 计算从 today 的星期几到 targetDayOfWeek 需要调整的天数。这个值可能是负数。
- + 7) % 7: 这是一个常见的JavaScript技巧，用于将任何整数（包括负数）转换为0到6之间的正模数结果。它确保我们总是得到一个正的、表示天数偏移量的值，从而正确地将 today 调整到 targetDayOfWeek。
- date.setDate(...): 将 date 对象的日期设置为计算出的目标日期，这个日期将是 targetDayOfWeek 对应的星期几。
formatter.formatToParts(date):
- 将调整后的 date 对象格式化为包含不同日期时间组成部分的对象数组。例如 [{ type: 'weekday', value: 'Mon' }, { type: 'literal', value: '.' }]。
formattedParts.find(part => part.type === 'weekday').value:
- 从 formatToParts 返回的数组中，找到 type 为 'weekday' 的部分，并提取其 value，这就是我们需要的本地化星期短名称。

注意事项与扩展

语言环境（Locale）选择: 确保使用的 locale 字符串是标准且有效的。不同的语言环境可能会有不同的格式和约定。
格式选项: 除了 weekday: 'short'，还可以尝试 weekday: 'long' 或 weekday: 'narrow' 来获取不同长度的星期名称。
浏览器兼容性: Intl.DateTimeFormat 是现代浏览器和Node.js环境中广泛支持的标准API。对于极老的浏览器，可能需要引入 polyfill。
性能: 对于只需要一次性获取星期名称列表的场景，上述方法效率很高。如果需要在短时间内频繁获取，可以考虑将结果缓存起来。
周日作为起始日: 如果你需要列表从周日开始，只需将 startDay 设置为 0 即可。

总结

通过巧妙结合 Intl.DateTimeFormat API的国际化能力和精确的日期计算逻辑，我们可以轻松地在JavaScript中获取到按周一至周日顺序排列的本地化星期短名称。这种方法不仅灵活，能够适应不同的语言环境，而且代码简洁高效，是处理国际化日期展示的推荐实践。掌握这一技巧，将大大提升您在构建多语言Web应用时的开发效率和用户体验。

以上就是使用JavaScript获取本地化星期短名称（周一至周日顺序）的详细内容，更多请关注php中文网其它相关文章！