交易日历

交易日查询、节假日、日期校验等日历相关方法。

交易日历客户端方法集合，对应 /api/calendar/* 端点。

get_trading_dates(market: str, start_time: str = '', end_time: str = '', count: int = -1) -> list

获取指定市场的交易日期列表。

底层调用 xtdata.get_trading_dates()，返回指定市场在时间范围内 的所有交易日期。

参数：

名称	类型	描述	默认
market	str	市场代码，如 "SH"（上海）、"SZ"（深圳）	必需
start_time	str	开始时间，格式 "20230101"	''
end_time	str	结束时间	''
count	int	返回条数，-1 表示全部	-1

返回：

类型	描述
list	交易日期列表（时间戳格式）

get_holidays() -> list

获取节假日列表。

底层调用 xtdata.get_holidays()，返回交易所公布的全部节假日日期。

返回：

类型	描述
list	节假日日期列表

get_trading_calendar(market: str, start_time: str = '', end_time: str = '') -> list

获取完整交易日历（含未来日期预测）。

底层调用 xtdata.get_trading_calendar()，返回含未来交易日的 完整日历数据。

参数：

名称	类型	描述	默认
market	str	市场代码	必需
start_time	str	开始时间	''
end_time	str	结束时间	''

返回：

类型	描述
list	交易日历列表

get_trading_period(stock: str) -> list

获取股票的交易时段信息。

底层调用 xtdata.get_trading_period()，返回指定股票（或其所在市场） 的交易时段划分，如上午开盘/收盘时间、下午开盘/收盘时间等。 不同品种（股票/期货/期权）的交易时段可能不同。

参数：

名称	类型	描述	默认
stock	str	股票代码，如 "000001.SZ"	必需

返回：

类型	描述
list	交易时段列表

is_trading_date(market: str, date: str) -> bool

判断指定日期是否为交易日。

参数：

名称	类型	描述	默认
market	str	市场代码，如 "SH"	必需
date	str	日期字符串，格式 "20230101"	必需

返回：

类型	描述
bool	True 表示是交易日，False 表示非交易日（周末或节假日）

get_prev_trading_date(market: str, date: str = '') -> str | None

获取上一个交易日。

参数：

名称	类型	描述	默认
market	str	市场代码	必需
date	str	基准日期，为空时使用当天	''

返回：

类型	描述
str | None	上一个交易日的日期字符串，无结果时返回 None

get_next_trading_date(market: str, date: str = '') -> str | None

获取下一个交易日。

参数：

名称	类型	描述	默认
market	str	市场代码	必需
date	str	基准日期，为空时使用当天	''

返回：

类型	描述
str | None	下一个交易日的日期字符串，无结果时返回 None

get_trading_dates_count(market: str, start_time: str = '', end_time: str = '') -> int

统计时间范围内的交易日数量。

参数：

名称	类型	描述	默认
market	str	市场代码	必需
start_time	str	开始时间	''
end_time	str	结束时间	''

返回：

类型	描述
int	交易日数量