跳转到主要内容
getBlockTime RPC 方法提供指定区块的估计生产时间，该区块由其槽号标识。时间以 Unix 时间戳（自 Unix 纪元以来的秒数）返回。 当您需要将区块生产与现实世界的时间相关联时，此方法非常有用。
避免批处理以提高性能批处理归档方法会显著增加延迟。不允许超过10个请求的批处理。

​
常见用例

  • 事件时间戳： 确定特定区块的生成时间以对链上事件进行时间戳标记。
  • 分析区块生成间隔： 计算区块之间的时间差（尽管对于更详细的分析，可能需要结合其他方法）。
  • 关联链下数据： 通过匹配区块生成时间，将链下事件或数据与链上活动对齐。

​
请求参数

getBlockTime 方法接受一个参数：
  1. slot (u64, 必需): 要检索其估计生成时间的区块的槽号。

​
响应结构

JSON-RPC 响应的 result 字段将是：
  • timestamp (i64): 作为 Unix 时间戳的估计生成时间（自 Unix 纪元以来的秒数）。
  • null: 如果指定区块的时间戳不可用（例如，区块非常旧且数据已被修剪，或区块被跳过且没有关联的时间戳）。

​
示例

​
1. 获取特定区块的估计时间

此示例获取特定槽的估计生成时间。请记得将 SLOT_NUMBER_TO_QUERY 替换为您所针对的网络（例如，Mainnet Beta 或 Devnet）上的实际、最新且已确认的槽。 
# Replace SLOT_NUMBER_TO_QUERY with a valid slot, e.g., a recent one from an explorer
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlockTime",
    "params": [
      SLOT_NUMBER_TO_QUERY 
    ]
  }'

​
开发者提示

  • 时间戳可用性： 并非所有区块都能提供时间戳，尤其是非常旧的区块或被跳过的槽。在这种情况下，方法返回 null。
  • 估计： 时间是一个估计值。它是从验证者的投票时间戳的权益加权平均值中得出的。虽然通常准确，但它不像区块哈希那样为每个区块提供保证的、加密安全的时间戳。
  • 节点依赖性： 可用性和精度可能会因查询的 RPC 节点而略有不同，尤其是对于非常新的（尚未最终确定的）区块。
本指南解释了如何使用getBlockTime来检索Solana网络上任何给定区块的估计生产时间戳。