什么是 block.timestamp？合约里的“时间”为什么不是精确时钟

一个拍卖合约写着“今晚 8 点结束”，你在手机时间 19:59:59 点击提交，交易却可能在截止后才上链；另一个合约说锁仓 30 天，也不是启动了一个每秒跳动的后台定时器。区块链合约没有自己的钟，它只能在执行时读取当前区块提供的时间。

Solidity 的 block.timestamp 是当前区块自 Unix 纪元以来的秒数。它适合表达截止、解锁和时间窗口，但不是毫秒级实时时钟，也不是可靠随机数。要用对它，必须区分用户提交时间、交易进入区块时间、区块时间戳和最终确认时间。

合约判断的是交易被执行时所在区块的时间，不是你点击按钮时设备显示的时间。

block.timestamp 到底是什么

交易执行期间，合约可以读取 block.timestamp，得到当前区块的 Unix 秒级时间戳。同一个区块中的所有交易读取的是同一个区块属性，不会因为执行先后相差几毫秒而看到不同时间。

旧代码中的 now 曾是它的别名，但 Solidity 0.7.0 已移除这个别名。名称改成 block.timestamp，也更清楚地提醒开发者：这个值属于区块，不会在一笔交易执行过程中持续变化。

点击时间为什么不等于链上时间

钱包签名后，交易先传播到节点并等待打包。Gas 设置、网络拥堵、nonce 排队、节点连接和区块提议都可能影响进入区块的时刻。合约无法可信地读取你的手机时间，也不知道你何时点击；它只在执行时判断区块时间是否满足条件。

12 秒 slot 不等于每 12 秒必有区块

Ethereum 权益证明把时间划分为 12 秒 slot，每个 slot 是一次提议区块的机会。但验证者可能离线或区块未被及时接受，因此 slot 可以为空。用户不能拿区块高度乘以固定秒数，假设它永远等于现实时间。

截止条件应该怎样写

block.timestamp < deadline 与 <= 在边界区块上结果不同。产品文案、前端倒计时和合约条件必须统一“截止时刻是否仍可操作”。测试要覆盖截止前、恰好截止和截止后，并明确使用 UTC 还是本地时区展示。

为什么要给用户留安全余量

如果操作必须在截止前完成，前端倒计时到零才提交往往太晚。钱包确认、交易排队和重新报价都要时间。产品可以提前停止新提交、显示网络延迟提示，并让用户知道“已发送”不代表“已在截止前确认”。

时间锁和解锁是如何工作的

合约通常保存一个解锁时间，用户之后调用提取函数，代码检查当前 block.timestamp 是否达到阈值。到点时不会自动唤醒合约，也不会主动把资产发送出去；仍需要某个账户或自动化服务提交交易触发执行。

链上“每天执行”也需要外部触发

合约没有 cron 定时进程。即使条件写成“距离上次执行超过一天”，也只是允许下一次调用通过。谁来调用、调用者为何愿意支付 Gas、失败如何重试，都需要额外设计，常见方案包括运营账户、激励调用者或自动化网络。

不要把时间戳当随机数

Solidity 官方文档明确警告，不应依赖 block.timestamp 或 blockhash 作为随机来源。区块提议者对区块内容和时间存在一定影响，公开可计算的时间值也容易被参与者预测。抽奖、稀有属性和资金分配应使用经过设计的随机机制，而不是对时间戳取模。

允许偏差不等于时间可以任意填写

协议会约束区块时间，节点不会接受任意离谱的值；官方文档也指出当前时间戳必须大于前一区块时间戳。不过开发者仍不应在几秒级差异就能带来高额收益的场景中依赖它。安全设计关注的是攻击者能否从有限影响中获利，而不是时间是否大致准确。

block.number 不能简单代替时间

区块号是顺序，不是时钟。即使平均节奏稳定，也会有空 slot、网络事件和不同链的出块机制。用“预计区块数”表达较长周期可能产生漂移；跨链应用更不能用一条链的区块高度推断另一条链的现实时间。

日、月、年计算有哪些陷阱

Solidity 的 seconds、minutes、hours、days 和 weeks 是固定秒数换算。它不理解时区、夏令时、自然月、工作日或“每月最后一天”。涉及账单月、当地午夜和法定日期时，应在链下正确计算目标 Unix 时间戳，再清楚记录规则；不能把 30 days 自动等同于一个自然月。

前端倒计时只是显示层

前端通常读取最新区块、合约截止值和本地时间估算倒计时。页面可能因 RPC 延迟、缓存或设备时间错误出现偏差，最终结果仍由链上条件决定。接近截止时应展示最新区块时间、交易状态与风险提示，而不是只放一个精确到秒却没有解释的数字。

开发者设计清单

• 边界使用 <、<=、>= 是否与文案一致？
• 是否给打包和确认留下合理窗口？
• 到期操作由谁触发，失败如何重试？
• 时间是否被错误用作随机数或高价值竞赛条件？
• 是否混淆固定秒数与自然日历？
• 测试是否覆盖边界区块、延迟交易与不同网络？

用户参与限时操作前怎么做

1. 确认页面显示的是哪个时区和链上截止值。
2. 检查钱包里是否有足够 Gas，避免临时补充。
3. 处理卡住的前序 nonce，别让新交易排队。
4. 提前提交，不把最后一个区块当成保证。
5. 在区块浏览器确认交易实际进入哪个区块。
6. 不要因倒计时页面显示成功就认为链上必然成功。

官方资料

block.timestamp、时间单位与随机数警告参考 Solidity：Units and Globally Available Variables；Ethereum 的 12 秒 slot 与空 slot 说明参考 Ethereum.org：Blocks 与 Ethereum.org：Block Proposal。

链上时间最适合回答“当前区块是否已经越过某个阈值”，不适合承担高精度计时、自动调度或随机性。把时间边界、交易延迟和触发机制一起设计，才能让倒计时背后的规则真正可预测。

本文为链上指南原创科普内容，不构成任何投资建议。限时交易、拍卖、解锁和跨链操作存在延迟与合约风险，请核对链上参数并预留充足时间。