Files
tick-stock-panel/backend/app/market_time.py
T
shy3130 08701f8886 fix(kline): 个股详情分时图独立轮询, 盘中直接实时拉取最新K
- /api/kline/minute 新增 live 参数: 当日连续竞价时段跳过本地优先直接
  实时拉取, 避免盘中分钟增量落盘后 90% 完整度启发式让详情分时图停在
  上一增量轮 (>=60s 滞后), 与行情列表节奏脱节
- StockPreviewDialog 打开即独立轮询 (间隔沿用偏好, 默认 6s), 不再要求
  「分时刷新开关 + 实时行情运行」双条件 — PR #114 引入的门槛默认冻结详情图
- market_time 抽出公共 in_continuous_session, minute_refresh 复用同一实现
- 新增 12 个单测覆盖 live 路径, 本地回退与连续竞价时段边界
2026-08-30 19:05:14 +08:00

89 lines
3.1 KiB
Python

"""A股市场时间工具 — 固定北京时间 (UTC+8, 无夏令时)。
服务器/容器本地时区不可靠 (python:slim 镜像默认 UTC), 交易时段判断、
实时行情落盘日期等必须显式使用北京时间, 否则 Docker 部署时轮询窗口
与真实交易时段完全错开 (北京 9:15-15:05 = UTC 1:15-7:05)。
"""
from __future__ import annotations
from datetime import date, datetime, time as dt_time, timedelta, timezone
CN_TZ = timezone(timedelta(hours=8))
# A 股交易时段 (北京时间): 上午 9:30-11:30 (120 分钟) + 下午 13:00-15:00 (120 分钟) = 240 分钟
_TRADING_TOTAL_MINUTES = 240
_MORNING_START = dt_time(9, 30)
_MORNING_END = dt_time(11, 30)
_AFTERNOON_START = dt_time(13, 0)
_AFTERNOON_END = dt_time(15, 0)
def cn_now() -> datetime:
"""当前北京时间 (带时区)。"""
return datetime.now(CN_TZ)
def cn_today() -> date:
"""当前北京日期。"""
return datetime.now(CN_TZ).date()
def in_continuous_session(now: datetime | None = None) -> bool:
"""A股连续竞价时段 (北京时间): 9:30-11:30 / 13:00-15:00, 仅工作日。"""
now = now or cn_now()
return now.weekday() < 5 and (
_MORNING_START <= now.time() <= _MORNING_END
or _AFTERNOON_START <= now.time() <= _AFTERNOON_END
)
def trading_minutes_elapsed_from_dt(dt: datetime) -> float:
"""根据北京时间 datetime 计算当日已交易分钟数。
交易时段: 9:30-11:30 (0~120) + 13:00-15:00 (120~240)。
- 开盘前 = 0; 午休(11:30-13:00) = 120(保持上午累计); 收盘后 = 240。
- 非交易日(周末) = 240 (视作全天, 避免量比被折算成 0)。
"""
t = dt.time()
if t < _MORNING_START:
return 0.0
if t < _MORNING_END:
return (dt.hour * 60 + dt.minute - 9 * 60 - 30) + dt.second / 60.0
if t < _AFTERNOON_START:
return 120.0 # 午休, 保持上午累计
if t < _AFTERNOON_END:
return 120.0 + (dt.hour * 60 + dt.minute - 13 * 60) + dt.second / 60.0
return float(_TRADING_TOTAL_MINUTES)
def trading_minutes_elapsed() -> float:
"""当前已交易分钟数 (基于服务端北京时间)。
量比折算的兜底: 当行情 timestamp 缺失时用服务端时间。
优先使用 trading_minutes_elapsed_from_ts (行情真实时间, 更准)。
"""
return trading_minutes_elapsed_from_dt(cn_now())
def trading_minutes_elapsed_from_ts(ts_ms: int | float | None) -> float:
"""从行情时间戳(毫秒)计算当日已交易分钟数。
优先使用此函数: 行情 timestamp 是真实成交时间, 比服务端时间更准
(服务端时间含网络/限流延迟)。
Args:
ts_ms: 毫秒级 Unix 时间戳 (TickFlow SDK quote.timestamp / kline.timestamp)
Returns:
已交易分钟数 (0~240)。timestamp 为 None/无效时返回 240 (视作全天,
避免量比被折算成 0)。
"""
if not ts_ms:
return float(_TRADING_TOTAL_MINUTES)
try:
dt = datetime.fromtimestamp(int(ts_ms) / 1000.0, tz=CN_TZ)
except (ValueError, TypeError, OSError):
return float(_TRADING_TOTAL_MINUTES)
return trading_minutes_elapsed_from_dt(dt)