JavaScript：获取从周一到周日的本地化星期短名称序列

本教程详细介绍了如何使用JavaScript的`Intl.DateTimeFormat` API，以指定区域设置获取从周一到周日的本地化星期短名称序列。通过动态计算日期偏移量并利用`formatToParts`方法，确保无论当前日期如何，都能准确生成并提取符合国际化标准的星期名称列表，为多语言应用开发提供可靠方案。

在构建全球化的Web应用程序时，经常需要根据用户的语言环境显示本地化的日期和时间信息。其中一个常见的需求是获取一周中每一天的本地化短名称，并且通常要求从周一开始排列。JavaScript的Intl.DateTimeFormat API为解决此类国际化问题提供了强大而灵活的工具。

理解 Intl.DateTimeFormat API

Intl.DateTimeFormat 是ECMAScript国际化API的一部分，它允许应用程序格式化日期和时间，使其符合特定语言环境（locale）的约定。它的构造函数接受两个参数：locales（一个语言环境字符串或数组）和 options（一个配置对象）。

要获取星期的名称，我们主要关注options对象中的weekday属性。该属性可以接受以下值：

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

NameGPT名称生成器

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

0

查看详情

• 'long'：完整名称（例如 "Monday"）。
• 'short'：短名称（例如 "Mon"）。
• 'narrow'：最窄名称（例如 "M"），可能与'short'相同，具体取决于语言环境。

实现从周一到周日的本地化星期短名称

为了获取从周一到周日（而不是从当前日期所在星期开始）的本地化星期短名称列表，我们需要一个策略来生成代表一周中每一天的日期对象，然后对其进行格式化。

以下是实现这一目标的详细步骤和代码示例：

1. 定义目标语言环境和格式化选项：首先确定需要获取哪种语言环境的星期名称，并指定weekday: 'short'。
2. 创建 Intl.DateTimeFormat 实例：使用定义的语言环境和选项创建一个格式化器。
3. 遍历一周：通过循环从周一（索引为1）到周日（索引为7），为每一天生成一个日期。
4. 计算日期偏移量：这是关键步骤。我们需要一个方法，无论当前日期是哪一天，都能可靠地生成代表一周中特定日期的Date对象。我们可以通过计算当前日期与目标星期几之间的天数差来实现。
5. 格式化并提取名称：使用格式化器的formatToParts()方法来格式化生成的日期，并从中提取weekday类型的值。formatToParts()返回一个对象数组，每个对象描述日期时间字符串的一个组成部分，这比直接使用format()更健壮，因为它允许我们精确地找到并提取星期名称。

示例代码

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

  // 获取当前日期，作为计算其他日期偏移量的基准
  const today = new Date();
  const currentDayOfWeek = today.getDay(); // 0代表周日，1代表周一...6代表周六

  // 定义周一的数字表示（在Date对象中是1）
  const MONDAY_INDEX = 1;

  // 循环7次，为一周中的每一天生成日期并提取名称
  for (let i = 0; i < 7; i++) {
    // 创建一个新的Date对象，避免修改today
    const date = new Date(today);

    // 计算从当前日期到目标星期几的偏移量
    // 目标星期几的索引是 (MONDAY_INDEX + i)
    // today.getDay() 是当前日期是星期几
    // ((目标星期几索引 - 当前星期几索引 + 7) % 7) 确保结果在0-6之间，表示需要调整的天数
    const targetDayIndex = (MONDAY_INDEX + i) % 7; // 0=日, 1=一, ..., 6=六
    const daysToAdd = (targetDayIndex - currentDayOfWeek + 7) % 7;

    // 将日期设置为目标星期几
    date.setDate(today.getDate() + daysToAdd);

    // 格式化日期并提取星期名称
    const formattedParts = formatter.formatToParts(date);
    const shortName = formattedParts.find(part => part.type === 'weekday').value;
    shortNames.push(shortName);
  }

  return shortNames;
}

// 示例用法
console.log("英语 (美国) 周一到周日:", getLocalizedShortWeekdaysFromMonday("en-US"));
// 输出示例: 英语 (美国) 周一到周日: [ 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun' ]

console.log("法语 (法国) 周一到周日:", getLocalizedShortWeekdaysFromMonday("fr-FR"));
// 输出示例: 法语 (法国) 周一到周日: [ 'lun.', 'mar.', 'mer.', 'jeu.', 'ven.', 'sam.', 'dim.' ]

console.log("中文 (中国) 周一到周日:", getLocalizedShortWeekdaysFromMonday("zh-CN"));
// 输出示例: 中文 (中国) 周一到周日: [ '周一', '周二', '周三', '周四', '周五', '周六', '周日' ]

console.log("德语 (德国) 周一到周日:", getLocalizedShortWeekdaysFromMonday("de-DE"));
// 输出示例: 德语 (德国) 周一到周日: [ 'Mo.', 'Di.', 'Mi.', 'Do.', 'Fr.', 'Sa.', 'So.' ]

代码解析

1. formatter = new Intl.DateTimeFormat(locale, { weekday: 'short' });: 初始化一个格式化器，指定了语言环境和只提取星期短名称的选项。
2. today = new Date();: 获取当前日期。虽然我们不直接使用today的星期几，但它是我们计算其他日期偏移量的参考点。
3. currentDayOfWeek = today.getDay();: getDay()方法返回一个0（周日）到6（周六）的整数。
4. for (let i = 0; i < 7; i++): 循环7次，代表一周的7天。
5. date = new Date(today);: 为每次迭代创建一个新的Date对象，以避免在循环中修改原始的today对象。
6. targetDayIndex = (MONDAY_INDEX + i) % 7;: 计算当前循环迭代对应的星期几的索引。MONDAY_INDEX是1，i从0到6。例如：
   • i=0: (1+0)%7 = 1 (周一)
   • i=1: (1+1)%7 = 2 (周二)
   • ...
   • i=6: (1+6)%7 = 0 (周日)
7. daysToAdd = (targetDayIndex - currentDayOfWeek + 7) % 7;: 这是计算日期偏移量的核心逻辑。
   • (targetDayIndex - currentDayOfWeek)：计算目标星期几与当前星期几之间的天数差。结果可能是负数。
   • + 7：确保结果为正数，即使天数差是负的。
   • % 7：取模操作，将结果限制在0到6之间，表示从当前日期到目标星期几需要增加的天数。
8. date.setDate(today.getDate() + daysToAdd);: 通过增加计算出的天数来调整date对象，使其指向目标星期几。
9. formatter.formatToParts(date): 格式化当前date对象，并返回一个包含日期各部分的对象数组。
10. .find(part => part.type === 'weekday').value: 从返回的数组中找到type为'weekday'的部分，并提取其value，这就是我们需要的本地化星期短名称。

注意事项

• 浏览器兼容性：Intl.DateTimeFormat API在现代浏览器和Node.js环境中得到了广泛支持。对于旧版浏览器，可能需要引入Polyfill（例如Intl.js）。
• 语言环境字符串：确保使用的语言环境字符串是有效的BCP 47语言标签（例如 "en-US", "fr-FR", "zh-CN"）。不正确的标签可能导致回退到默认语言环境或抛出错误。
• weekday 选项：根据需求选择'short'、'long'或'narrow'。
• 性能考量：对于需要频繁获取大量本地化日期信息的场景，建议缓存Intl.DateTimeFormat实例，而不是每次都创建新的实例。

总结

通过利用JavaScript的Intl.DateTimeFormat API并结合巧妙的日期偏移量计算，我们可以轻松地获取到从周一到周日、符合特定语言环境的本地化星期短名称列表。这种方法不仅提供了高度的灵活性和准确性，而且是构建多语言和国际化应用程序的推荐实践。掌握这一技巧，将使您的Web应用在处理日期和时间显示时更加健壮和用户友好。

以上就是JavaScript：获取从周一到周日的本地化星期短名称序列的详细内容，更多请关注php中文网其它相关文章！