时间工具

时区转换

将指定日期时间从一时区转换为另一时区

时区转换

将指定日期时间从源时区转换为目标时区,支持 IANA 时区(如 Asia/Shanghai、America/New_York)。

使用场景

  • 会议时间:将本地时间转换为对方时区
  • 日志排查:将 UTC 时间转换为本地或其它时区
  • 跨区协作:统一多时区时间表示

时区转换把某一时区里的墙上时间折算成另一时区的同一时刻,偏移量按 IANA 时区名实时查算而非写死,因此夏令时切换会自动跟上。适合安排跨国会议、解读以 UTC 记录的服务器日志,以及确认一次发布在别处落在哪一天。

偏移量是从哪儿查出来的

本工具不保存任何偏移表。每次计算时,它对源时区与目标时区各调用一次 Intl.DateTimeFormat,取 timeZoneName: "shortOffset" 产出的标签(如 GMT+8、GMT-5、GMT+5:30),解析成带符号的分钟数。由于查询按「具体时刻」而非按「时区」进行,上海全年都报 +8,纽约却在一月报 -5、七月报 -4。这些规则来自浏览器内置的 IANA 时区数据库,不来自本页代码,所以版本偏旧的浏览器会继续沿用已被废止的规则:某国取消夏令时、某地区拆分出新时区、边界重新划定。修正办法只有升级浏览器,页面本身无能为力。

夏令时里根本不存在的那一小时

输入的墙上时间不带偏移,工具先用 Date.UTC 把它当成 UTC 造出一个临时时刻,在该时刻查出源时区偏移,再减这一次。除每年两次切换前后的那两小时,单次查询都成立。把 2025-03-09 02:30 作为 America/New_York 输入(当地 02:00 直接跳到 03:00,这个读数并不存在),得到 2025-03-09T07:30:00.000Z;而 07:30 UTC 在纽约是 03:30 EDT,比输入晚了一小时。秋季正好相反:2025-11-02 01:30 在纽约出现两次,工具固定取较早、仍属 EDT 的那个时刻 2025-11-02T05:30:00.000Z。成熟的库会在换算后重新读一次偏移再迭代,这段单次逻辑没有这一步。

只认两种写法,溢出则被悄悄修正

能进入墙上时间分支的只有两种写法:YYYY-MM-DD HH:MM 与 YYYY/M/D HH:MM,日期与时间之间必须是空格,秒可省略,年份需四位。其余写法——用 T 分隔、末尾带 Z 或 +08:00、只写日期——都交给 new Date() 先按浏览器本地时区解析再换算,结果可能与预期差出十几小时。而在被接受的写法内部,也没有日期合法性检查:Date.UTC 对溢出做归一化而不是报错,2025-02-31 10:00 会静默变成 3 月 3 日,25:99 则先滚到次日 02:39,之后才减去时区偏移。

实操示例

上海的下午换成纽约的凌晨

输入
2025-01-30 14:00,源时区 Asia/Shanghai,目标时区 America/New_York
输出
2025年1月30日 01:00:00 / 2025-01-30T06:00:00.000Z

上海一月是 UTC+8,14:00 减八小时得 06:00 UTC;纽约一月处于 EST(UTC-5),于是当地读数为同日 01:00。第二行出自 toISOString(),永远按 UTC 输出,并不是纽约的时间,别把它当作 EST 抄进日历邀请。

边界与常见误用

  • 源、目标时区都只能从固定十个 IANA 标识里选(UTC、Asia/Shanghai、Asia/Hong_Kong、Asia/Tokyo、America/New_York、America/Los_Angeles、America/Chicago、Europe/London、Europe/Paris、Australia/Sydney),无法手动填写 Asia/Kolkata、Europe/Berlin 之类。
  • 只有 YYYY-MM-DD HH:MM[:SS] 与 YYYY/M/D HH:MM 会被当作源时区的墙上时间;用 T 分隔并带 Z 或数字偏移的字符串改走浏览器时区解析,可能相差十几小时。
  • 没有日期合法性校验:不存在的日期与越界的时分会被静默进位,2025-02-31 10:00 直接给出 3 月 3 日。
  • 本地化那一行不带偏移量与时区缩写,ISO 那一行始终是 UTC,两行都不能在不注明目标时区的情况下直接引用。
  • 夏令时交界不做任何标记:春季被跳过的时刻整体后移一小时,秋季重复的那一小时固定取较早的夏令时版本。

相关工具

出问题时先看这里

点「当前时间」,框里填进来的是我这台电脑的钟点,不是选好的源时区

原因loadExample 用 new Date().toLocaleString("zh-CN", …) 取本机时区的当前时间,把斜杠换成短横线就塞进输入框;源时区下拉根本没参与,秒也在这一步被截掉。

处理只有当源时区就等于本机时区时才直接点它;否则先在世界时钟上读出源城市的当前时刻再手填,或者把源时区改成自己所在的时区。

同一个时间串,同事那边算出来的钟点和我差好几个小时

原因组件里有两套解析路径:空格分隔的 YYYY-MM-DD HH:MM 由 Date.UTC 处理,与本机时区无关;其余写法一律交给 new Date(),之后又用 d.getTimezoneOffset() 按本机偏移修正一次,等于先把字符串读成浏览器墙上时间,再当作源时区去减。

处理去掉 T、结尾的 Z、+08:00 和任何注释,日期与时间之间只留一个空格,然后对比两边的 ISO 行——这种写法下谁跑都一致。

写了 2025/1/30 9:05 PM,结果按早上 9:05 算

原因斜杠那条正则结尾没有 $ 锚点,分钟之后的内容会被整段丢掉, PM、末尾的 UTC 都算白写;短横线那条带 $,同样一条尾巴会让它整条退回 new Date(),那时就看浏览器怎么解析了。输出侧固定 hour12: false,本来也没有 AM/PM 的概念。

处理改成 21:05 这样的小时制写法,字段里只保留日期、一个空格、时间;时区交给下拉框声明,不要在字符串后面拼文字。

目标时区从 UTC 换成 Europe/London,两行结果一模一样

原因偏移是按具体时刻查的:一月伦敦的标签是 GMT,没有正负号,匹配不上 GMT+/GMT- 那条正则,getOffsetMinutes 最后落到 return 0,正好和 UTC 给出同一个数。

处理换一个七月的日期再试(那时伦敦是 UTC+1),或改用 Europe/Paris 与 UTC 对比;若两行只是措辞不同、时刻分毫不差,说明这两个时区在该时刻确实同偏移。

在输入框里打字,下面一点反应都没有

原因整个界面是 Astro 页面里的 client:idle Vue 岛:脚本水合之前(或脚本被拦时)页面只有带占位符 2025-01-30 14:00 的静态输入框,结果面板压根没挂载;输入为空时组件本身也返回 null。

处理确认该页允许执行 JavaScript 并等岛水合完成;如果确实需要不依赖脚本的换算,就在浏览器控制台里自己算,或放到服务端脚本里做。

只有十个时区、一次一对:什么时候留在这页,什么时候换路

判断点本工具换用什么
要查的城市不在下拉框里源和目标都是十个写死的 IANA 标识撑起来的普通下拉框,没有输入框也没有搜索,加尔各答(UTC+5:30)、柏林、首尔、圣保罗一律填不进去。在控制台里用 Intl.DateTimeFormat("en-US", { timeZone: "Asia/Kolkata", timeZoneName: "shortOffset" }) 直接读出偏移再自己减,或换用接受任意 IANA 标识的库(如 Luxon)。
手里的时间本来就是带 Z 或 +08:00 的 ISO 串只有空格分隔的墙上时间才走干净路径;2025-01-30T06:00:00Z 会被 new Date() 解析,随后又被本机时区偏移重新锚定,算出来能和这条串自己声明的时刻差出大半天。把这条串交给 ISO 8601 工具按原样解析,它给出 UTC 时刻和毫秒时间戳;拿这两个数自己做一次时区加减,比在这里绕着走可靠。
只是想知道几个人所在城市的「现在几点」一次只处理一对源/目标,而「当前时间」按钮填的又是本机时钟,问五个人就得来回复制四轮。世界时钟一屏并列八个时区、每秒走动,一眼就能读数;但它不接受任何日期,只回答「此刻」这一个问题。
要把时区之间的数字差写进规则或测试断言结果面板只输出两行格式化字符串,从不给带符号的偏移量,cron 时间窗或断言只能从显示的钟点里反推。把同一时刻放进时间戳工具,两个 Unix 值相减再除以 3600000 得到小时数;要的是整天或工作日,则改用日期计算器。
换算结果要进日历邀请、文档或测试夹具本地化那行既没有偏移也没有缩写,ISO 那行是 UTC 时刻,只写「10:00」的话,不知道时区的人根本无法使用。用会带上偏移的格式化器,Temporal.ZonedDateTime 或 Luxon 的 toISO() 能给出 2025-01-30T01:00:00.000-05:00;非要抄这一页,就把本地化那行连同「纽约(EST)」一起写,别抄 ISO 行。
同一套换算要在 CI 或服务器上复现整块换算跑在页面里的 client:idle Vue 岛上,既没有接口也没有命令行,构建脚本无从调用。Node 自带完整 ICU,同样的 Intl 调用可以直接跑;但偏移取自运行时构建,所以要锁住 Node/ICU 版本,否则换一次镜像结果就变。

常见问题

会议时间跨时区安排的最佳实践?
三步:以 UTC 固定"锚点时刻" → 每个参与方按本地时区确认 → 日历邀请里写明时区(或直接用 UTC 标注)。工具的并排显示能一眼看出"对上海是上午 10 点、对纽约是前一天晚上 10 点"这类冲突。
UTC、GMT、Z 时间是一回事吗?
日常语境基本通用,严格说 GMT 是天文学基准(基于地球自转),UTC 是原子钟基准(带闰秒修正),Z 是 UTC 的军用/航空标法。编程里统一用 UTC 即可,不必区分三者的物理差异。
夏令时(DST)会带来哪些坑?
三个经典坑:春季拨快时 2:30 这一时刻不存在;秋季拨慢时同一时刻出现两次;某些地区临时取消 DST 造成历史数据歧义。结论:存储永远用 UTC + 时区标识(如 America/New_York),不要存本地时间偏移。

内容复核: