如何为X轴含日期的Matplotlib图表添加自定义次要刻度

Matplotlib内部是把日期转换成**自1970-01-01以来的天数（浮点数）**处理的，直接传datetime64会触发类型错误，转成整数/浮点数没显示是因为格式不匹配。下面是具体解决步骤：

1. 把指定日期转成Matplotlib兼容的数值 #

用matplotlib.dates.date2num()函数，把datetime64数组或datetime对象转成Matplotlib能识别的浮点数：

import matplotlib.dates as mdates
import numpy as np

# 示例自定义次要刻度日期
custom_dates = np.array(['2023-06-15', '2023-06-25'], dtype='datetime64[D]')
# 转换为Matplotlib兼容的数值格式
custom_x = mdates.date2num(custom_dates.astype(datetime.datetime))

2. 设置次要刻度的定位器与格式化器 #

用FixedLocator指定刻度位置，FixedFormatter绑定自定义标签，再绑定到x轴次要刻度：

from matplotlib.ticker import FixedLocator, FixedFormatter

# 设置次要刻度位置
ax.xaxis.set_minor_locator(FixedLocator(custom_x))
# 设置自定义标签
ax.xaxis.set_minor_formatter(FixedFormatter(['中期节点', '末期节点']))

3. 调整次要刻度标签的显示样式 #

如果标签过长，用tick_params()调整旋转角度和对齐方式：

ax.tick_params(axis='x', which='minor', rotation=45, ha='right', labelsize=9)

完整可运行示例 #

import matplotlib.pyplot as plt
import matplotlib.dates as mdates
from matplotlib.ticker import FixedLocator, FixedFormatter
import numpy as np
import datetime

# 生成模拟数据
dates = np.arange('2023-06-01', '2023-07-01', dtype='datetime64[D]')
values = np.random.randn(len(dates)).cumsum()

fig, ax = plt.subplots(figsize=(10, 6))
ax.plot(dates, values)

# 配置原有主刻度
locator = mdates.AutoDateLocator(minticks=5, maxticks=10)
formatter = mdates.ConciseDateFormatter(locator)
ax.xaxis.set_major_locator(locator)
ax.xaxis.set_major_formatter(formatter)

# 配置自定义次要刻度
custom_dates = np.array(['2023-06-10', '2023-06-20'], dtype='datetime64[D]')
custom_x = mdates.date2num(custom_dates.astype(datetime.datetime))
ax.xaxis.set_minor_locator(FixedLocator(custom_x))
ax.xaxis.set_minor_formatter(FixedFormatter(['第一阶段', '第二阶段']))
# 调整次要标签样式
ax.tick_params(axis='x', which='minor', rotation=30, ha='right', color='#ff4444')

plt.tight_layout()
plt.show()

关键注意事项 #

• 不能直接用datetime64的整数形式（那是纳秒级时间戳，和Matplotlib的天级单位不匹配），必须用mdates.date2num()转换
• 尽量避免自定义日期和主刻度重合，否则次要标签会被覆盖
• 如果用Pandas Timestamp，直接传mdates.date2num(timestamp)即可，无需额外转换

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