matplotlib的DateFormatter误将Unix时间戳秒数识别为天数的问题

问题原因 #

matplotlib.dates.DateFormatter对输入数值的默认解析单位为天，而你传入的是秒级Unix时间戳，二者单位不匹配。数值1会被判定为比数值0晚1天，因此出现预期的1秒偏差变成1天偏差的错误结果。

原代码运行后的错误输出如下：

修复方案 #

只需提前将Unix时间戳转换为matplotlib可识别的日期格式即可，常用实现方式有两种：

方法一：使用matplotlib.dates.epoch2num直接转换 #

该方法最为简便，epoch2num接口可以直接将秒级Unix时间戳转换为matplotlib兼容的天级日期序数：

from matplotlib import pyplot as plt
import matplotlib.dates as md

fig, ax = plt.subplots()
timestamps = [0, 1]
# 转换Unix时间戳为matplotlib支持的日期格式
mpl_dates = md.epoch2num(timestamps)
ax.scatter(mpl_dates, [1, 1])
xfmt = md.DateFormatter('%Y-%m-%d %H:%M:%S')
ax.xaxis.set_major_formatter(xfmt)
fig.autofmt_xdate()
plt.show()

方法二：通过datetime模块转换 #

如果需要额外的日期逻辑处理，可以先将时间戳转换为datetime对象，matplotlib会自动识别该类型并完成解析：

from matplotlib import pyplot as plt
import matplotlib.dates as md
from datetime import datetime

fig, ax = plt.subplots()
timestamps = [0, 1]
# 转换为datetime对象，如需UTC时区可替换为datetime.utcfromtimestamp
dt_list = [datetime.fromtimestamp(ts) for ts in timestamps]
ax.scatter(dt_list, [1, 1])
xfmt = md.DateFormatter('%Y-%m-%d %H:%M:%S')
ax.xaxis.set_major_formatter(xfmt)
fig.autofmt_xdate()
plt.show()

两种方法最终都可以正确输出预期的日期：数值0对应1970-01-01 00:00:00，数值1对应1970-01-01 00:00:01。

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