时间工具

ISO 8601 解析

解析或格式化 ISO 8601 日期时间字符串

ISO 8601 解析

解析 ISO 8601 日期时间字符串(如 2025-01-30T12:00:00Z),显示本地时间、时间戳等;或从日期时间/时间戳格式化为 ISO 8601。

使用场景

  • 接口、日志中的 ISO 时间解析
  • 标准化日期时间格式校验与转换

把日期时间字符串交给浏览器内置 Date 解析器,一次给出同一时刻的四种表示:UTC 下的 ISO 8601、按界面语言格式化的本地时间、毫秒与整秒时间戳。核对接口时间字段与日志时间时最直接。

解析器是 ECMAScript,不是严格的 ISO 8601

两种模式都走 new Date(string),解析规则取决于 ECMAScript 日期时间格式与引擎扩展。只写日期的 2025-01-30 按 UTC 零点理解,不带偏移的 2025-01-30T12:00:00 却按本地中午理解,同一串数字在 UTC+8 机器上相差 8 小时。V8 还接受标准未收录的写法:空格代替 T、省略冒号的 +0800、滚进次日的 24:00:00,并把 2025-02-30 悄悄归一化成 3 月 2 日。报错的是浏览器从未实现的 ISO 基本格式:20250130 与周日期 2025-W05-4。

为什么 ISO 那一行和输入对不上

ISO 行来自 toISOString():固定 UTC、三位小数,偏移被折算掉。输入 2025-01-30T20:00:00+08:00 时 +08:00 被减去,得到 2025-01-30T12:00:00.000Z。本地行以 dateStyle: full、timeStyle: medium、hour12: false 按 zh-CN 或 en-US 渲染,en-US 把午夜写作 24:00:00,zh-CN 写作 00:00:00。秒数行取 Math.floor(毫秒 / 1000),-500 毫秒因此记为 -1。

格式化模式只是少显示三行

切到格式化模式不加严校验:跑的仍是同一句 new Date(s),只是隐藏了本地时间与两个时间戳。所以 RFC 2822 邮件头 Thu, 30 Jan 2025 12:00:00 GMT、斜杠写法 2025/01/30 都能得到干净的 ISO 字符串,输出并不能证明输入合规。提示文字也不能照字面读:格式化模式写着接受时间戳,但裸的 1700000000 在两种模式下都报错,没有引擎把纯整数当日期。要校验格式请按 ISO 文法比对输入,纯数字交给时间戳工具。

实操示例

把带偏移的日志时间归一化为 UTC

输入
2025-01-30T20:00:00+08:00
输出
2025-01-30T12:00:00.000Z

偏移是被减掉而不是原样回显,所以 ISO 行是 UTC 那一刻,且必定以 Z 结尾。毫秒行读作 1738238400000,秒数行是 1738238400。本地行只有在浏览器位于 UTC+8 时才会重新显示 20:00,换一台机器就变成那台机器的钟面时间,所以要贴进代码的是 ISO 行。

边界与常见误用

  • 没有时区选择器:本地行始终跟随浏览器时区,同一输入在 UTC+8 与 UTC-5 的机器上读数不同,只有 ISO 行与时间戳行保持一致。
  • 只写日期的输入按 UTC 处理,同样日期带上时刻却不带偏移则按本地处理,2025-01-30 与 2025-01-30T00:00:00 不是同一时刻。
  • 不存在的日期会被归一化而不是报错,2025-02-30 静默变成 3 月 2 日;各种格式错误共用一条笼统提示,看不出是哪一段写错了。
  • 精度止于毫秒,秒的小数超过三位会被截掉,toISOString() 也只会输出三位。
  • 裸的时间戳(如 1700000000)在两种模式下都报错,尽管格式化模式的提示文字里提到了时间戳。

相关工具

只问「这一刻是几点」就留在这里,另有诉求就该换工具

手上的情况这一页给到的更该用的东西
手上是一串数字:秒级或毫秒级时间戳两种模式都把输入当日期字符串交给解析器,纯整数没有引擎认,1700000000 只会落到错误提示那一行。数字交给时间戳工具,它有秒/毫秒切换、直接进食;或者在终端里 date -u -d @1700000000 +%FT%TZ 先展开。等手上换成 2025-01-30T20:00:00+08:00 这种文本、要确认它对应哪一刻,再回来。
结果必须落在指定时区,而不是我这台机器碰巧所在的时区本地时间那一行在渲染时取自浏览器时区:没有下拉、没有参数、没有换 URL 的办法。同事在别的时区打开同一串输入,看到的是他那边的钟面,只有 ISO 行两边完全一致。「这个时刻在东京、在纽约各是几点」交给时区转换工具;写进代码就靠 Intl.DateTimeFormat("en-GB", { timeZone: "Asia/Tokyo", timeStyle: "long" }) 这类带 timeZone 的格式化。要求时区被写明、而不是由读它的机器继承时,就该换。
目的是把不合规的输入挡掉,而不是转换它页面上没有任何一处声称「这串写法合规」:它只回答能不能算出一个时刻,能出值只说明引擎在文本里找到了日期。所以要分清——它是一个供你读结果的转换器,不是一道能过或不过的校验。要卡格式就换成校验器:JSON Schema 的 format: "date-time"、锚定 Z|[+-]HH:MM 的正则,或 Python 3.11 的 datetime.fromisoformat()(现已接受末尾 Z)。需要的是错误文案而不是一个值时,本页帮不上。
问的是算术:「30 天后是几号」「这两个日期差几天」四行输出描述的始终是同一个时刻,页面没有加、没有减、也没有差值框,跨月跨年只能自己拿时间戳行去推。日期计算器按日历天算差值,而不是按 24 小时块切;代码里用 Temporal.PlainDate 或 differenceInCalendarDays。这一页只适合先把两个端点时刻钉死,再拿去相减。
生产代码里要解析,想先拿一条能进单测的基准值粘一条线上真实字符串,从面板读出偏移折算后的结果,抄下 ISO 行与毫秒行——这两个数直接就是单测的期望值,不用再手算一遍。但正式代码别用随引擎漂移的 new Date(string),改用 Temporal.ZonedDateTime.from 或 date-fns 的 parseISO;输入来自用户或第三方接口时,一开始就该走库,这一页留作对照。
日志里一百条时间戳要批量转,不是文本框里那一条一个输入框、一块结果面板、一个填入当前时间的按钮;第一百条就是第一百次粘贴,没有列表模式可退。交给 shell:jq 对数组逐个跑 todateiso8601,GNU date -u -d @1700000000 +%FT%TZ 套一层循环就完事。本页留给那条你正要拿出来推理的值,不适合成批处理。

输入里写的偏移,怎么折进 ISO 那一行

字符串里的偏移长期使用该标准偏移的地区2025-01-30T20:00:00 带上它之后的 ISO 行
Z 或 +00:00UTC、雷克雅未克、阿克拉2025-01-30T20:00:00.000Z
+08:00中国、新加坡、珀斯2025-01-30T12:00:00.000Z
+09:00日本、韩国2025-01-30T11:00:00.000Z
+05:30印度、斯里兰卡2025-01-30T14:30:00.000Z
+05:45尼泊尔2025-01-30T14:15:00.000Z
+08:45西澳 Eucla2025-01-30T11:15:00.000Z
+13:00汤加2025-01-30T07:00:00.000Z
-03:00阿根廷、乌拉圭、圣保罗2025-01-30T23:00:00.000Z
-05:00纽约(冬季)、波哥大、利马2025-01-31T01:00:00.000Z
-12:00贝克岛、Etc/GMT+122025-01-31T08:00:00.000Z

每一行都是拿墙钟时间减掉偏移,日期该进位就进位:最后两行落到 1 月 31 日,日志按 UTC 日期切分时「差一天」多半出在这里。中间一列是标准偏移而不是全年恒定的值——夏令时会让同一地区换一个写法,纽约 1 月写 -05:00、7 月写 -04:00。小数秒不会被折算掉,2025-01-30T20:00:00.250+08:00 的 ISO 行仍以 .250Z 结尾。这张表只在字符串里确实写了偏移时成立。

常见问题

ISO 8601 日期格式为什么长这样?
ISO 8601 把"大单位在前"贯彻到底:2026-08-30T14:30:00+08:00。好处是纯字符串排序等于时间排序(日志、文件名排序不会乱),且无歧义——这使它成为 API、日志、数据库的标准时间格式。
末尾的 Z 是什么意思?
Z 代表 Zulu 时间即 UTC+0:2026-08-30T06:00:00Z 与 2026-08-30T14:00:00+08:00 是同一时刻。后端存储和 API 传输统一用 UTC(Z),展示层再转本地时区,是避免时区混乱的黄金法则。
为什么 JavaScript 的 toISOString() 会抛错?
常见原因:字符串不符合 ISO 格式(如 "2026/08/30 14:00" 斜杠写法在部分引擎解析失败),或 Invalid Date 被序列化。先用本工具校验格式是否符合 ISO 8601,再排查代码。

内容复核: