Bokeh中X轴日期时间配置问题：如何设置5年间隔刻度

我太懂你碰到的这个糟心问题了——处理早于1950年的日期时，Bokeh的日期轴要么乱显示毫秒，要么刻度挤成一团，转个datetime对象还被报错拒绝。别慌，咱们一步步把它捋顺：

核心问题拆解 #

你遇到的几个麻烦本质上是两个关键点：

• Bokeh默认的自动刻度逻辑不适合长跨度的历史日期，才会瞎显示毫秒
• 你之前转换datetime对象的方式大概率出了问题，其实Bokeh完全支持1970年之前的日期

解决方案步骤 #

1. 把数据转成正确的Datetime类型 #

首先得把你的日期数据转换成Python标准datetime对象或者pandas的datetime64类型——这一步是关键，之前Bokeh拒绝数据十有八九是转换时的格式错误（比如日期字符串不规范、混进了无效日期）。

举个pandas转换的例子：

import pandas as pd

# 假设你的日期是字符串格式
date_strings = ["1935-06-15", "1940-06-15", "1945-06-15", "1950-06-15"]
dates = pd.to_datetime(date_strings)  # 转成datetime64类型

不用pandas的话，纯Python也能搞定：

from datetime import datetime

dates = [datetime(1935,6,15), datetime(1940,6,15), datetime(1945,6,15)]

2. 手动配置X轴的刻度和显示格式 #

设置x_axis_type='datetime'后，咱们直接覆盖Bokeh的默认规则，强制每5年显示一个刻度，并且只展示年份：

from bokeh.plotting import figure, show
from bokeh.models import YearsTicker, DatetimeTickFormatter

# 构造示例数值数据
values = [12, 18, 22, 17]

# 创建绘图对象，指定X轴为datetime类型
p = figure(x_axis_type='datetime', width=800, height=400, title="每5年刻度的历史日期轴")
p.line(x=dates, y=values, line_width=2)

# 配置X轴：每5年一个刻度
p.xaxis.ticker = YearsTicker(years=5)

# 配置刻度显示格式：只显示年份
p.xaxis.formatter = DatetimeTickFormatter(
    years=["%Y"],
    months=["%Y"],
    days=["%Y"]
)

show(p)

3. 排查常见坑点 #

如果还是出现Bokeh拒绝数据的情况，检查这几点：

• 确认所有日期都是有效日期（比如1900年2月29日是无效的，因为1900不是闰年）
• 绝对不要用时间戳（timestamp）表示1970年之前的日期——Unix时间戳从1970年开始，负数时间戳容易出兼容性问题
• 确保数据里没有混进非日期类型（比如格式错误的字符串日期）

这样配置完，你的X轴就会规规矩矩地每5年显示一个年份刻度，完美适配1950年之前的历史数据啦！

内容的提问来源于stack exchange，提问作者jhoover4