利用JavaScript Intl API 获取标准时区名称列表-html教程-PHP中文网

利用JavaScript Intl API 获取标准时区名称列表

聖光之護

发布： 2025-10-29 11:45:19

原创

915人浏览过

利用javascript intl api 获取标准时区名称列表

本文旨在解决在从Moment.js迁移到Day.js后，如何高效获取一份简洁的时区名称列表的问题。我们将介绍并演示如何利用浏览器原生的`Intl.supportedValuesOf('timeZone')` API来获取标准IANA时区标识符。该方法无需额外库，且能自动处理夏令时，提供了一个专业且易于实现的解决方案，尤其适用于需要精简时区列表的场景。

Day.js与时区列表的挑战

在进行日期和时间处理时，获取并管理时区信息是常见的需求。许多开发者曾习惯于使用Moment.js及其配套的moment-timezone插件，通过moment.tz().names()等方法轻松获取完整的时区名称列表。然而，随着Moment.js进入维护模式，以及Day.js等更轻量级库的兴起，开发者逐渐转向新的解决方案。

Day.js自身的核心库设计旨在保持精简，它专注于日期时间对象的创建、操作和格式化。虽然Day.js通过其timezone插件可以处理特定时区的日期时间，但它本身并不提供直接获取所有可用时区名称列表的功能。这导致了一个常见问题：如何在不依赖Moment.js的情况下，获取一个简洁且包含夏令时（DST）变化的有效时区名称列表？

Intl.supportedValuesOf('timeZone')：现代JavaScript解决方案

对于获取时区名称列表的需求，现代JavaScript提供了一个强大且标准的原生API：Intl.supportedValuesOf('timeZone')。这个方法是Intl对象（Internationalization API）的一部分，它允许应用程序访问宿主环境（通常是浏览器或Node.js）支持的各种国际化数据。

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

Intl.supportedValuesOf('timeZone')方法返回一个包含所有受支持的IANA时区标识符（也称为TZ database名称）的数组。这些标识符是全球公认的标准，例如"America/New_York"、"Europe/London"、"Asia/Shanghai"等。它们不仅代表了特定的地理区域，而且这些区域内部的夏令时规则（如果适用）也已被这些标识符隐含地涵盖。这意味着，通过获取这些标识符，您无需担心手动处理夏令时变化。

实现代码示例

要在浏览器环境或支持Intl API的Node.js环境中获取时区名称列表，您可以使用以下简洁的代码：

/**
 * 获取浏览器支持的IANA时区名称列表。
 * 这些名称是标准化的，并自动处理夏令时。
 *
 * @returns {string[]} 一个包含所有支持时区名称的数组。
 */
function getSupportedTimezoneNames() {
  if (typeof Intl !== 'undefined' && typeof Intl.supportedValuesOf === 'function') {
    return Intl.supportedValuesOf('timeZone');
  } else {
    console.warn("当前环境不支持 Intl.supportedValuesOf('timeZone') API。");
    return [];
  }
}

// 在控制台打印所有时区名称
const timezoneList = getSupportedTimezoneNames();
console.log("支持的时区名称列表：");
timezoneList.forEach(timeZone => {
  console.log(timeZone);
});

// 如果只需要在控制台快速查看，可以直接使用以下代码：
// for (const timeZone of Intl.supportedValuesOf('timeZone')) {
//   console.log(timeZone);
// }

登录后复制

将上述代码片段在您的浏览器控制台中运行，或者在支持的环境中作为JavaScript代码执行，您将获得一个包含数百个标准时区标识符的列表。这个列表是经过精简和标准化的，符合许多应用场景对“短小精悍”列表的需求。

优势与注意事项

原生支持，无需依赖： 这种方法直接利用了浏览器或Node.js环境内置的国际化API，无需引入任何第三方库（如moment-timezone或Day.js的任何特定插件）即可获取时区列表。这有助于减小项目体积并减少外部依赖。

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

0

查看详情
标准化和准确性： 返回的IANA时区标识符是国际公认的标准，它们在准确性和维护性方面具有高度可靠性。
自动处理夏令时： IANA时区标识符本身就包含了其所代表区域的所有历史和未来的夏令时规则。因此，您无需额外逻辑来考虑夏令时变化。
简洁性： 相较于某些库可能提供的冗余或非标准的时区名称，Intl.supportedValuesOf('timeZone')返回的列表是规范且易于理解的。它避免了提供500多个可能包含别名或旧名称的庞大列表，而是聚焦于核心的、可用的时区。

与Day.js的结合： 尽管Day.js本身不提供此列表，但一旦您通过Intl.supportedValuesOf获取了这些时区名称，您可以将它们与Day.js的timezone插件结合使用，例如：

// 假设您已经安装并使用了dayjs和timezone插件
// import dayjs from 'dayjs';
// import utc from 'dayjs/plugin/utc';
// import timezone from 'dayjs/plugin/timezone';
// dayjs.extend(utc);
// dayjs.extend(timezone);

// const newYorkTime = dayjs().tz("America/New_York");
// console.log(newYorkTime.format());

登录后复制

您可以使用getSupportedTimezoneNames()返回的任何一个名称作为tz()方法的参数。

总结

在从Moment.js迁移到Day.js后，若需要获取一个简洁且包含夏令时规则的时区名称列表，最专业和高效的方法是利用JavaScript的Intl.supportedValuesOf('timeZone') API。这个原生方法提供了标准化的IANA时区标识符，无需额外库，且能够自动处理夏令时，完美满足了对精简、准确时区列表的需求。它不仅是一个独立的解决方案，也能很好地与Day.js等现代日期时间库协同工作。

以上就是利用JavaScript Intl API 获取标准时区名称列表的详细内容，更多请关注php中文网其它相关文章！