# 怎么从推文 ID 算出发布时间？

> 推文 ID 是 Snowflake ID：右移 22 位，再加上 X 的纪元 1288834974657 毫秒，就是精确到毫秒的发布时间。手算示例、代码，以及 2010 年以前的例外。

网页版：https://okdata.online/zh/answers/x-tweet-id-timestamp/

**简短回答：**把帖子 ID 右移 22 位，再加上 1288834974657（X 的 Snowflake 纪元，Unix 毫秒），得到的就是精确到毫秒的创建时间，本地就能算，不花钱。2010 年 11 月以后的帖子都适用。如果还要正文和互动数，okdata 的 X 帖子详情接口会把 published_at 一起返回，每次 $0.0003。

X 上每条帖子都有一个 `1987654321098765432` 这样的数字 ID，这个数字里自带时间戳。X 用 2010 年自己设计的 Snowflake 方案生成 ID：高位存的是从某个固定起点算起的毫秒数，所以直接从 ID 里就能读出创建时间。

## 位的布局

| 位数 | 存的是什么 |
|---|---|
| 1（最高位） | 固定为 0 |
| 41 | 自 X 纪元起的毫秒数，纪元是 1288834974657（2010 年 11 月 4 日 01:42:54.657 UTC） |
| 10 | 机器编号 |
| 12 | 同一毫秒内的序列号 |

所以：`unix_ms = (id >> 22) + 1288834974657`。

## 手算示例

以 `1987654321098765432` 为例：

1. 右移 22 位（等同于整除 4,194,304）：`473893718981`。
2. 加上纪元：`473893718981 + 1288834974657 = 1762728693638` 毫秒。
3. 也就是 2025 年 11 月 9 日 22:51:33.638 UTC，北京时间 11 月 10 日 06:51:33。

我们拿接口返回的一条真实帖子核对过：用 ID 算出的时间和帖子的 `createdAt` 精确到秒完全一致。

## 容易踩的坑

- **精度。**ID 超出了 JavaScript 普通数字能精确表示的范围，`Number("1987654321098765432")` 会悄悄改掉末尾几位。存储用字符串，计算用 `BigInt`，X 官方文档也是这么建议的。
- **老帖子。**2010 年底 Snowflake 上线之前的 ID 是从小到大的顺序编号，套公式算出来的时间没有意义。TweetedAt 的研究者找到的最大的 Snowflake 之前的 ID 是 29700859247，不超过它的 ID 一律当作无法推算时间。
- **用户 ID。**近几年注册的账号，用户 ID 也是 Snowflake；我们解过一个，结果比该账号标注的注册时间早 7 秒。老账号的 ID 很短，解不出时间。
- **排序。**时间在高位，所以按 ID 排序就等于按时间排序，排序时用不着日期列。

## 什么时候调接口

[X 帖子详情](/zh/apis/x/posts/get/)传 ID 或 x.com 链接，返回 `published_at`，以及正文、媒体、浏览、点赞、转发和回复数。

| 需求 | 做法 | 费用 |
|---|---|---|
| 只要发布时间 | 解 ID | 免费 |
| 时间加上当前互动数据 | 调一次详情 | $0.0003 |
| 数据集里的 1,000 条帖子 | 调 1,000 次 | $0.30 |

## 示例

```python
import os, requests
from datetime import datetime, timezone

X_EPOCH_MS = 1288834974657

def posted_at(post_id: str) -> datetime:
    ms = (int(post_id) >> 22) + X_EPOCH_MS
    return datetime.fromtimestamp(ms / 1000, tz=timezone.utc)

pid = "1987654321098765432"
print(posted_at(pid).isoformat(timespec="milliseconds"))  # 2025-11-09T22:51:33.638+00:00

body = requests.get("https://api.okdata.online/v1/x/posts/get", timeout=60,
    headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
    params={"id": pid, "fields": "id,published_at,metrics.views,metrics.likes"}).json()
print(body["data"]["item"] if body["code"] == "ok" else body["code"])
```

JavaScript 写法：`new Date(Number((BigInt(id) >> 22n) + 1288834974657n))`。

## 限制

- 已删除或受保护的帖子，ID 照样能解，但详情接口返回 `not_found`，这次调用照常计费。
- 帖子每编辑一次，新版本都有自己的 ID（X 的数据字典里叫 `edit_history_tweet_ids`），所以编辑版的 ID 算出来的是编辑时间，不是首发时间。

想从链接读取帖子本身，见 [AI 智能体怎么读 x.com 链接里的推文](/zh/answers/ai-agent-read-tweet-from-link/)。

## 用到的接口

- [X 帖子详情](https://okdata.online/zh/apis/x/posts/get/) `x.posts.get`：$0.0003/次

## 更多X（推特）内容

- [X（推特） API](https://okdata.online/zh/apis/x/)
- [怎么按关键词搜 X（推特）帖子并导出](https://okdata.online/zh/guides/x-search-posts-by-keyword/)
- [怎么每天记录多个国家的 X（推特）趋势](https://okdata.online/zh/guides/x-trends-by-country/)
- [社媒数据接口返回的数据有多新？](https://okdata.online/zh/answers/how-fresh-is-social-media-api-data/)
- [按千次播放给剪辑手结算，怎么统计 TikTok、YouTube Shorts、Instagram Reels 和 X 上每条切片的播放量？](https://okdata.online/zh/answers/clipper-payout-view-tracking/)
- [怎么拿到一条推文下面的全部回复和引用？](https://okdata.online/zh/answers/export-x-post-replies-quotes/)
- [Claude 或 AI 智能体怎么读取 x.com 推文链接的内容？](https://okdata.online/zh/answers/ai-agent-read-tweet-from-link/)
- [怎么用 API 拿到任意一条推文的浏览量？](https://okdata.online/zh/answers/tweet-view-count-api/)
- [twscrape 报 No active accounts、账号一直被锁，还有别的办法吗？](https://okdata.online/zh/answers/twscrape-no-active-accounts/)
- [平台官方 API 和第三方数据接口怎么选（2026）](https://okdata.online/zh/compare/official-apis-vs-data-apis/)
- [怎么选社交媒体数据 API（2026）](https://okdata.online/zh/compare/social-media-data-apis/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [X 趋势：今日榜单](https://okdata.online/zh/tools/hot-search/x/)

## 资料来源

- [X API 文档：X IDs（64 位 Snowflake ID）](https://docs.x.com/fundamentals/x-ids) (读取于 2026-11-12)
- [X API 数据字典：帖子和用户字段](https://docs.x.com/x-api/fundamentals/data-dictionary) (读取于 2026-11-12)
- [Snowflake ID（维基百科）](https://en.wikipedia.org/wiki/Snowflake_ID) (读取于 2026-11-12)
- [twitter-archive/snowflake](https://github.com/twitter-archive/snowflake) (读取于 2026-11-12)
- [TweetedAt：为 Snowflake 前后的推文 ID 找时间戳](https://ws-dl.blogspot.com/2019/08/2019-08-03-tweetedat-finding-tweet.html) (读取于 2026-11-12)

这个问题出现过的地方（读取于 2026-11-12）：

- https://devcommunity.x.com/t/how-do-i-extract-an-id-from-a-timestamp/184282
- https://devcommunity.x.com/t/convert-tweet-time-status-to-php-for-use-in-if-else-statement/16946
- https://stackoverflow.com/questions/29754885

更新于 2026-11-12
