T工具箱
PT1H

ISO 8601 时长转换

P1DT2H 形式与秒数互转

关于此工具

ISO 8601 时长格式(Duration)是国际标准化组织定义的时间跨度表示规范,采用以 'P'(Period)开头的特定字母序列(如 'P1Y2M10DT2H30M' 表示 1年2个月10天2小时30分钟)。本工具提供 ISO 8601 时长字符串与人类易读自然语言、总秒数、毫秒数之间的双向高精度转换,广泛应用于云原生计算(AWS Step Functions、Temporal 状态机)、视频平台(YouTube API 视频时长)、任务调度与数据库定期快照配置中。

如何使用本工具(操作步骤)

1

输入 ISO 8601 字符串或时间数值

支持输入标准代码(如 PT1H45M、P7D)或分别调整年月日时分秒各个维度数值。

2

查看结构化拆解与自然语言描述

系统将即时输出“1小时45分钟”等易懂文本,并自动计算出精确的总秒数(Seconds)与毫秒数。

3

导出格式代码或一键复制结果

获取可直接贴入微服务配置、REST API 响应或调度触发器的规范标准格式。

严格遵循 ISO 8601:2004 规范

完美支持包含日历部分(Y/M/W/D)与必须紧随 'T' 分隔符之后的时间部分(H/M/S)。

总秒数精确推导与转换

支持将纯数字秒数(如 3661s)反向逆推为最优紧凑格式(PT1H1M1S),免去繁琐的心算换算。

轻量纯前端离线计算

无需联网发起请求,毫秒级响应,即使在无信号弱网或离线工作流中依然稳定可用。

ISO 8601 时长语法与使用避坑要点

  • •区分字母 'M' 的双重含义:在 ISO 8601 语法中,'M' 出现在分隔符 'T' 之前代表“月(Months,如 P3M)”;出现在 'T' 之后代表“分钟(Minutes,如 PT3M)”,缺少 'T' 会导致严重的时间量纲解析歧义。
  • •YouTube Data API 解析秘笈:YouTube 官方 API 返回的视频时长字段均为 ISO 格式(如 'contentDetails.duration: PT4M13S'),在前端展示给用户前必须经过本转换器转为常规 '04:13'。
  • •月与年换算秒数的日历局限性:由于每月天数(28~31天)与平闰年存在差异,若需将 'P1M' 或 'P1Y' 转换为绝对物理秒数,应明确约定固定基准日或按照标准 1年=365天、1月=30天进行名义折算。

代码与转换对比示例

标准 ISO 时长与秒数映射

ISO 8601 标准时长字符串
P1DT2H30M15S
人类易读自然语言与总秒数
1天 2小时 30分钟 15秒 (总计: 95,415 秒)

* 转换器完整支持日期周期(天数)与时间部分(时分秒)的混合解析与秒数汇总。

JavaScript 常用正则快速解析秒数

示例 ISO 时长字符串
PT2H30M
计算所得物理秒数
9000 秒 (2 * 3600 + 30 * 60)

* 可结合标准正则表达式快速提取 H、M、S 分量完成秒数折算。

常见问题解答

Q: ISO 8601 时长字符串中的 'T' 字母是什么作用?可以省略吗?

A: 不能随意省略。'T'(Time)是专门用来分隔日历日期部分(年月日周)与时钟时间部分(时分秒)的强制分界符。字母 'M' 在 'T' 前代表月(P2M),在 'T' 后代表分钟(PT2M)。

Q: 为什么有时候会看到 'P1W' 这种以 W 结尾的格式?

A: 在规范中 'W' 代表周(Weeks)。'P1W' 严格等价于 'P7D'(7天)。官方规范建议周通常作为独立单位单独使用,不与年月日混合拼写。

Q: 为什么微服务和云原生工作流(如 AWS Step Functions)偏爱 ISO 时长?

A: 因为 ISO 8601 时长具备极强的自解释性与可读性。在分布式配置中查看 'PT12H' 比看一串纯数字 43200 更加直观不易出错,能极大规避超时心算事故。

相关推荐工具

所有处理都在你的浏览器本地完成,数据不会上传到服务器。
/