博客
在 Mac 上转换 Unix 时间戳:分清秒、毫秒和时区
先确认单位,再对照 UTC 与本地时间,最后复制目标系统要求的日期或时间戳格式。
日志或接口响应里出现 Unix 时间戳时,先确认数值使用秒还是毫秒,再核对显示时区。Frset 的时间戳工具可以将数字转换成日期,也可以把本地日期文字反向转换为秒或毫秒时间戳。
区分同一时刻与不同显示方式
Unix 时间戳以 Unix 纪元为基准计时。同一个时刻,按 UTC 和 Mac 本地时区显示时,文字可能不同。Python 的日期与时间文档说明了时间戳转换与时区的关系。
例如,1704067200 秒与 1704067200000 毫秒表示同一时刻:UTC 的 2024 年 1 月 1 日 00:00:00。在 Asia/Shanghai 时区,它显示为当天 08:00:00。两种显示相差八小时,不代表原始时间戳需要再增加八小时。
使用 Frset 转换时间戳
- 打开 Frset 搜索,选择时间戳;未修改时可以使用默认关键词
/time。 - 选择时间戳转日期模式。
- 只粘贴数值,不要带字段名或引号。
- 运行转换,检查结果识别的是秒还是毫秒。
- 对照本地和 UTC 输出,复制需要的表示方式。
工具的输出设置可以包含本地时间、UTC、ISO 8601 和 RFC 3339。没有看到需要的格式时,检查已启用的输出项。成功结果会复制到剪贴板,并加入历史记录。
当前实现接受 9 位或 10 位的秒值,以及 12 位或 13 位的毫秒值,支持范围为 UTC 的 2000 年 1 月 1 日至 2100 年 1 月 1 日。负数、小数输入和超出范围的日期不在此工具支持范围内。一个值被工具拒绝,不代表它在所有系统中都无效。
将本地日期反向转换为时间戳
切换到日期转时间戳模式,按 yyyy-MM-dd HH:mm:ss 输入,例如 2024-01-01 08:00:00。选择输出单位为秒或毫秒,再运行工具。
输入会按 Mac 当前时区解释。如果时区为 Asia/Shanghai,示例对应 1704067200 秒。换一个时区,同样输入的日期可能表示另一个时刻。转换同事发来的日程时间前,先核对 Mac 的时区。
这个输入框不是通用日期解析器。不要粘贴带 Z 后缀的 ISO 日期或任意自然语言日期,就默认它会被正确理解。按要求输入格式,另行确认原本想表达的时区。
结果不对时,检查三件事
- 单位:接收方要求毫秒时,数值与秒不同。核对接口文档,不要只凭位数判断。
- 时区:修改原始数字前,先比较 UTC 与本地输出。显示偏移不一定是数据错误。
- 含义:确认字段记录的是创建、更新、过期还是计划执行时间。转换正确,并不说明字段用途。
只复制接收方要求的值。如果目标字段需要数字,不要粘贴包含说明标签和多种日期格式的整块结果。将过期时间或计划时间用于实际系统前,先核对含义。
把原始值与转换结果一起保留
检查接口响应时,在工作笔记中保留字段名、原始值和预期单位。JSON 指南可以帮助你读清响应结构,剪贴板历史记录则方便再次找到复制过的来源。
时间戳转换在本地执行,不需要 AI 服务商。工具可用次数取决于 Frset 方案;无论使用哪种方案,单位、输入范围和时区规则都需要核对。