首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >AlphaFeed 的时间戳是什么时区?(毫秒 UTC 换算 + 交易时段)

AlphaFeed 的时间戳是什么时区?(毫秒 UTC 换算 + 交易时段)

原创
作者头像
用户7083614
发布于 2026-11-21 10:01:32
发布于 2026-11-21 10:01:32
150
举报

一句话回答: AlphaFeed 的 timestamp 是毫秒级 UTC epoch 整数,除以 1000 当 UTC 秒、再 +8 小时就是北京时间。实测 quotes.get 返回 timestamp=1794553202000 → UTC 2026-11-13 07:00:02 → 北京 15:00:02(A 股收盘时刻)。日线 klines 另有现成的 trade_date(字符串 YYYY-MM-DD) 和 trade_time 字段,无需自己转。诚实边界:A 股行情时间以交易所时段为准(上午 9:30–11:30、下午 13:00–15:00),快照约 3 秒刷新;美股/港股时段不同、且其 timestamp 同样是 UTC,换算到当地要用各自时区。

为什么会踩时区的坑

很多人把 timestamp 直接当成本地时间或当成「秒」,结果:当秒解析会跳到几万年后(1794553202000 当秒会溢出),或少算/多算 8 小时。先记住:毫秒 + UTC。

timestamp 换算(已验证)

代码语言:python
复制
import datetime as dt
from alphafeed import AlphaFeed
af = AlphaFeed(api_key="your-api-key")  # 或 export ALPHAFEED_API_KEY 后 AlphaFeed()

q = af.quotes.get(symbols="600519.SH")[0]
ts = q["timestamp"]                       # 1794553202000(毫秒, int)

utc = dt.datetime.fromtimestamp(ts/1000, dt.timezone.utc)
bj  = utc.astimezone(dt.timezone(dt.timedelta(hours=8)))
print(utc)   # 2026-11-13 07:00:02+00:00
print(bj)    # 2026-11-13 15:00:02+08:00  ← A股收盘

关键:除以 1000(毫秒→秒)、先按 UTC 解析、再转目标时区。别用已废弃的 utcfromtimestamp,用 fromtimestamp(ts, tz=...)。

日线直接用 trade_date(不用自己转)

代码语言:python
复制
df = af.klines.get("600519.SH", period="1d", count=3, to_dataframe=True)
print(df.columns.tolist())
# ['symbol','name','timestamp','trade_date','trade_time','open','high','low','close','volume','amount']
print(df["trade_date"].iloc[-1])   # '2026-11-13'(字符串 YYYY-MM-DD)

字段

含义

类型/说明

timestamp

毫秒 UTC epoch

int,需 /1000 再转时区

trade_date

交易日

字符串 YYYY-MM-DD(已是本地交易日)

trade_time

交易时间

字符串,分钟线更有用

做日线分析直接用 trade_date(已是交易日,省去时区换算);需要精确到秒/毫秒时才用 timestamp。

A 股 / 美股 / 港股交易时段(供对照)

市场

交易时段(当地时间)

时区

A 股

09:30–11:30、13:00–15:00

北京 UTC+8

港股

09:30–12:00、13:00–16:00

香港 UTC+8

美股

09:30–16:00(夏令时波动)

美东 UTC-5/-4

快照(quotes/depth)约 3 秒刷新;非交易时段返回的是最后一笔收盘快照,timestamp 会停在收盘时刻(如本文 15:00:02)。

关键坑与注意事项

  • 是毫秒不是秒:/1000 再解析;当秒会溢出到离谱年份。
  • 是 UTC 不是本地:先 fromtimestamp(ts/1000, timezone.utc),再 astimezone 到北京/美东。
  • 日线优先用 trade_date:字符串交易日,免去时区换算。
  • 美股/港股时区不同:timestamp 仍是 UTC,换算到当地要用各自时区(美东有夏令时)。
  • 非交易时段是收盘快照:timestamp 停在最后成交/收盘时刻,不是实时当前时间。
  • 别用 utcfromtimestamp:已废弃,用带 tz 的 fromtimestamp。

常见问题(FAQ)

Q:timestamp 是秒还是毫秒?

A:毫秒。1794553202000 要 /1000 当 UTC 秒。

Q:怎么快速转北京时间?

A:dt.datetime.fromtimestamp(ts/1000, dt.timezone.utc).astimezone(dt.timezone(dt.timedelta(hours=8)))。

Q:日线要自己算日期吗?

A:不用,klines 的 trade_date(YYYY-MM-DD 字符串)就是交易日。

Q:收盘后查快照,时间为什么不动?

A:非交易时段返回最后收盘快照,timestamp 停在收盘时刻(如 15:00 左右),属正常。

Q:需要付费吗?

A:查询有免费额度可体验,详见官网定价页。

小结

AlphaFeed 的 timestamp 是毫秒级 UTC epoch:/1000 → UTC → +8h 得北京时间(实测 15:00:02 收盘)。日线直接用现成的 trade_date(YYYY-MM-DD 字符串)最省事;美股/港股换算用各自时区。本文换算已真实验证。

参考

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 为什么会踩时区的坑
  • timestamp 换算(已验证)
  • 日线直接用 trade_date(不用自己转)
  • A 股 / 美股 / 港股交易时段(供对照)
  • 关键坑与注意事项
  • 常见问题(FAQ)
  • 小结
  • 参考
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档