如何在 JavaScript 中获取指定时区的当前 UTC 偏移量（分钟）-js教程-PHP中文网

本文介绍使用原生 Intl.DateTimeFormat API（无需第三方库）精确获取任意 IANA 时区（如 America/Los_Angeles）在当前时刻的 UTC 偏移量（单位：分钟），并支持解析 +05:30 等非整小时偏移，兼容夏令时动态变化。

本文介绍使用原生 `intl.datetimeformat` api（无需第三方库）精确获取任意 iana 时区（如 `america/los_angeles`）在**当前时刻**的 utc 偏移量（单位：分钟），并支持解析 `+05:30` 等非整小时偏移，兼容夏令时动态变化。

在现代 JavaScript 中，获取指定时区的当前 UTC 偏移量不再需要依赖 moment-timezone 或 dayjs 等外部库。ECMAScript 国际化 API（Intl.DateTimeFormat）提供了标准化、高精度且自动适配夏令时（DST）的解决方案。核心思路是：利用 timeZoneName: 'longOffset' 选项生成形如 "GMT-07:00" 的字符串，再通过 formatToParts() 安全提取并解析该偏移值。

以下是一个健壮、可复用的纯 JS 函数实现：

function getCurrentOffset(timeZone) {
  try {
    const format = new Intl.DateTimeFormat('en', {
      timeZone,
      timeZoneName: 'longOffset'
    });

    const parts = format.formatToParts();
    const tzNamePart = parts.find(p => p.type === 'timeZoneName');

    if (!tzNamePart) {
      throw new Error(`Invalid time zone: ${timeZone}`);
    }

    let offsetString = tzNamePart.value.slice(3); // 移除 "GMT" 或 "UTC" 前缀

    // 处理 UTC / GMT / Etc/UTC 等零偏移情况
    if (offsetString === '' || offsetString === '+00:00' || offsetString === '-00:00') {
      return { offsetString: '+00:00', offsetMinutes: 0 };
    }

    // 标准化符号与格式（支持 ±H:MM、±HH:MM）
    const match = offsetString.match(/^([+-])(\d{1,2}):(\d{2})$/);
    if (!match) {
      throw new Error(`Unrecognized offset format: "${offsetString}"`);
    }

    const [, sign, hours, minutes] = match;
    const hoursNum = parseInt(hours, 10);
    const minutesNum = parseInt(minutes, 10);
    const totalMinutes = (sign === '+' ? 1 : -1) * (hoursNum * 60 + minutesNum);

    // 注意：此 offsetMinutes 表示「本地时间比 UTC 快多少分钟」
    // 即：localTime = utcTime + offsetMinutes * 60 * 1000
    // 这与 Date.prototype.getTimezoneOffset() 的语义相反（后者返回 UTC - local，单位为分钟）
    return {
      offsetString,
      offsetMinutes: totalMinutes
    };
  } catch (err) {
    console.warn(`Failed to get offset for time zone "${timeZone}":`, err.message);
    return null;
  }
}

✅ 使用示例：

sc-java-to-ts-interface

将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。

下载

console.log(getCurrentOffset('America/Los_Angeles')); // { offsetString: "-07:00", offsetMinutes: -420 }
console.log(getCurrentOffset('America/New_York'));    // { offsetString: "-04:00", offsetMinutes: -240 }（夏令时中）
console.log(getCurrentOffset('Asia/Kolkata'));        // { offsetString: "+05:30", offsetMinutes: 330 }
console.log(getCurrentOffset('Pacific/Marquesas'));   // { offsetString: "-09:30", offsetMinutes: -570 }
console.log(getCurrentOffset('Etc/UTC'));             // { offsetString: "+00:00", offsetMinutes: 0 }

⚠️ 重要注意事项：

✅ 动态准确：结果反映调用时刻的真实偏移（自动处理 DST 切换，如 PDT → PST）；
✅ IANA 兼容：仅接受标准 IANA 时区名（如 'Europe/London'），不支持缩写（'PST'、'EST' 无效）；
⚠️ 浏览器兼容性：需现代浏览器（Chrome 73+、Firefox 72+、Safari 14+、Edge 79+）；Node.js ≥ 14.0 默认支持，旧版本需启用 --icu-data-dir；
⚠️ 无缓存机制：每次调用均实时计算，若高频使用建议自行封装缓存逻辑（如按秒级 TTL）；
❌ 不支持历史偏移：本方法仅适用于“当前时间”，如需指定日期的偏移，请传入 new Date(2023, 0, 1) 并配合 formatToParts(date) 使用。