如何根据x轴日期范围调整matplotlib的AutoDateFormatter日期格式

问题根因 #

你遇到的AutoDateFormatter格式化不符合预期的问题主要有两个核心诱因：

1. 处理start/end字段时，pd.to_datetime仅传入了时分信息，默认会补全为当年1月1日的日期，会干扰AutoDateLocator对时间跨度的判断逻辑
2. AutoDateFormatter内置的默认格式规则和你预期的展示规则不匹配，且你之前写的"%Y-%m-%d %M:%H"格式存在错误（%M为分钟、%H为小时，正确时分格式为"%H:%M"）

解决方案 #

步骤1：修正日期数据处理逻辑

如果原始数据包含年月日信息，需要把年月日拼接到时、分字段前再做日期转换，避免默认补全的日期干扰跨度判断。如果本身只有时分的时段数据，建议统一指定基准日期拼接后转换，避免跨24点的数据被识别为不同日期：

# 示例：统一拼接2024-01-01作为基准日期，可根据实际场景替换为真实日期
data["start"] = pd.to_datetime("2024-01-01 " + 
                               data["start_H"].astype(str).str.pad(2, fillchar="0") +
                               data["start_M"].astype(str).str.pad(2, fillchar="0"),
                               format="%Y-%m-%d %H%M")
data["end"] = pd.to_datetime("2024-01-01 " + 
                             data["end_H"].astype(str).str.pad(2, fillchar="0") +
                             data["end_M"].astype(str).str.pad(2, fillchar="0"),
                             format="%Y-%m-%d %H%M")

步骤2：自定义自适应日期格式化器

替换默认的AutoDateFormatter，按照你需要的时间跨度规则自定义格式化逻辑：

import matplotlib.pyplot as plt
import matplotlib.dates as mdates

# 自定义格式化规则
def custom_date_formatter(x, pos=None):
    ax = plt.gca()
    xmin, xmax = ax.get_xlim()
    span = xmax - xmin # matplotlib日期单位为天

    # 跨度小于24小时，仅显示时分
    if span < 1:
        fmt = "%H:%M"
    # 跨度小于30天，显示月日+时分
    elif span < 30:
        fmt = "%m-%d %H:%M"
    # 跨度小于365天，显示年月日
    elif span < 365:
        fmt = "%Y-%m-%d"
    # 跨度大于等于1年，显示年月
    else:
        fmt = "%Y-%m"
    return mdates.num2date(x).strftime(fmt)

# 替换原有定位器、格式化器配置
locator = mdates.AutoDateLocator()
plt.gca().xaxis.set_major_locator(locator)
plt.gca().xaxis.set_major_formatter(plt.FuncFormatter(custom_date_formatter))
# 可选：自动旋转x轴标签避免重叠
plt.gcf().autofmt_xdate()

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