[{"data":1,"prerenderedAt":233},["ShallowReactive",2],{"page:/zh/guides/what-is-unix-timestamp/":3},{"id":4,"title":5,"body":6,"description":219,"extension":220,"eyebrow":221,"faq":222,"locale":223,"meta":224,"navigation":225,"pageType":226,"path":227,"related":222,"seo":228,"stem":231,"__hash__":232},"pages/zh/guides/what-is-unix-timestamp.md","什么是 Unix 时间戳？",{"type":7,"value":8,"toc":207},"minimark",[9,13,22,37,41,44,47,50,53,67,71,83,155,159,169,176,179,192,195],[10,11,12],"h2",{"id":12},"简明定义",[14,15,16,17,21],"p",{},"Unix 时间戳是从 ",[18,19,20],"code",{},"1970-01-01T00:00:00Z"," 起经过时间的有符号计数。经典定义使用秒，但现代 API 也使用毫秒、微秒和纳秒，因此一个没有单位的数字并不完整。",[14,23,24,25,28,29,32,33,36],{},"时间戳 ",[18,26,27],{},"0"," 就是 Unix 纪元；",[18,30,31],{},"-1"," 秒是 ",[18,34,35],{},"1969-12-31T23:59:59Z","。只要运行环境和存储类型支持，负数时间戳完全有效。",[10,38,40],{"id":39},"utc-与时区","UTC 与时区",[14,42,43],{},"时间戳标识 UTC 时间线上的一个绝对时刻，不携带城市、国家、夏令时规则或首选显示格式。同一数值在上海和纽约会显示成不同钟点，但仍然是同一时刻。",[10,45,46],{"id":46},"闰秒",[14,48,49],{},"Unix 时间通常把每一天按 86,400 秒处理，不把闰秒编码为单独的编号秒。对常见 Web、API 和数据库工作，这是预期规则；科学计时系统可能采用其他时间尺度。",[10,51,52],{"id":52},"可复现示例",[14,54,55,58,59,62,63,66],{},[18,56,57],{},"1700000000"," 秒转换为 ",[18,60,61],{},"2023-11-14T22:13:20.000Z","。乘以 1,000 得到 ",[18,64,65],{},"1700000000000"," 毫秒，单位改变但时刻不变。",[10,68,70],{"id":69},"从-api-或日志读取时间戳","从 API 或日志读取时间戳",[14,72,73,76,77,82],{},[18,74,75],{},"created_at"," 这样的字段可能保存 ISO 字符串、Unix 秒或毫秒，仅凭字段名不能确定格式。先查看接口文档，再把数值放入",[78,79,81],"a",{"href":80},"/zh/timestamp-to-date/","时间戳转日期工具","，明确选择单位。核对 UTC 日期是否符合事件发生时间后，再复制结果。",[84,85,86,102],"table",{},[87,88,89],"thead",{},[90,91,92,96,99],"tr",{},[93,94,95],"th",{},"Unix 秒",[93,97,98],{},"UTC 日期",[93,100,101],{},"含义",[103,104,105,118,130,142],"tbody",{},[90,106,107,112,115],{},[108,109,110],"td",{},[18,111,31],{},[108,113,114],{},"1969-12-31 23:59:59",[108,116,117],{},"纪元前一秒",[90,119,120,124,127],{},[108,121,122],{},[18,123,27],{},[108,125,126],{},"1970-01-01 00:00:00",[108,128,129],{},"Unix 纪元起点",[90,131,132,136,139],{},[108,133,134],{},[18,135,57],{},[108,137,138],{},"2023-11-14 22:13:20",[108,140,141],{},"常见的现代时间戳",[90,143,144,149,152],{},[108,145,146],{},[18,147,148],{},"2147483647",[108,150,151],{},"2038-01-19 03:14:07",[108,153,154],{},"有符号 32 位秒数上限",[10,156,158],{"id":157},"同一时刻为什么会显示不同日期","同一时刻为什么会显示不同日期？",[14,160,161,163,164,168],{},[18,162,57],{}," 在 UTC 是 11 月 14 日 22:13:20，在上海是 11 月 15 日 06:13:20，在纽约是 11 月 14 日 17:13:20。时间戳数值没有变化，变化的是时区下的日历表示。可在",[78,165,167],{"href":166},"/zh/time-zone-converter/","时间戳时区工具","核对这些结果。",[14,170,171,172,175],{},"常见 POSIX 时间戳不会把闰秒作为额外的普通秒计入，因此它并不是精确的原子钟计数。设备时钟也可能被系统校时修正。测量一段程序的运行耗时，应使用 JavaScript 的 ",[18,173,174],{},"performance.now()"," 等单调时钟，而不是简单相减两次设备日期。",[10,177,178],{"id":178},"保存数值时也保存单位约定",[14,180,181,182,186,187,191],{},"数据库字段或 API 文档应注明秒、毫秒、微秒还是纳秒。日期看起来异常时，先阅读",[78,183,185],{"href":184},"/zh/guides/seconds-vs-milliseconds/","秒与毫秒的区别","，不要直接补零尝试。如果手里的输入是某地区的日历日期，应使用",[78,188,190],{"href":189},"/zh/date-to-timestamp/","日期转时间戳","，并写明来源时区。",[10,193,194],{"id":194},"标准与运行时参考",[196,197,198],"ul",{},[199,200,201],"li",{},[78,202,206],{"href":203,"rel":204},"https://tc39.es/ecma262/multipage/numbers-and-dates.html#sec-time-values-and-time-range",[205],"nofollow","ECMAScript Date time values",{"title":208,"searchDepth":209,"depth":209,"links":210},"",2,[211,212,213,214,215,216,217,218],{"id":12,"depth":209,"text":12},{"id":39,"depth":209,"text":40},{"id":46,"depth":209,"text":46},{"id":52,"depth":209,"text":52},{"id":69,"depth":209,"text":70},{"id":157,"depth":209,"text":158},{"id":178,"depth":209,"text":178},{"id":194,"depth":209,"text":194},"准确理解 Unix 纪元、UTC、负数时间戳、常见单位，以及一个 epoch 数值真正标识什么。","md","指南 / 基础",null,"zh",{},true,"guide","/zh/guides/what-is-unix-timestamp",{"title":229,"description":230},"什么是 Unix 时间戳？Unix Epoch 详解","了解 Unix 时间戳计算什么、为什么从 1970 年开始、负数如何工作，以及时间戳为何没有时区。","zh/guides/what-is-unix-timestamp","2CpI4rJ0u3BntRQTQaJHpBitzEPWfkJPx3RHXQwYrfI",1792032487946]