matplotlib.pyplot.plot_date

matplotlib.pyplot.plot_date(x, y, fmt='o', tz=None, xdate=True, ydate=False, *, data=None, **kwargs)

[已弃用] 绘图时强制轴将浮点数视为日期。

自 3.9 版本弃用：此方法因历史原因而存在，并将在 3.11 版本中移除。

• datetime 类型的数据应直接使用 plot 绘制。

• 如果你需要将普通数值数据绘制为 Matplotlib 日期格式 或需要设置时区，请在调用 plot 之前调用 ax.xaxis.axis_date / ax.yaxis.axis_date。详见 Axis.axis_date。

类似于 plot，此函数将 y 对 x 绘制为线或标记。但是，轴标签会根据 xdate 和 ydate 格式化为日期。请注意，plot 可以直接处理 datetime 和 numpy.datetime64 对象，而无需使用此方法。

参数:

x, y类数组

数据点的坐标。如果 xdate 或 ydate 为 True，则相应的值 x 或 y 将被解释为 Matplotlib 日期。

fmtstr，可选

绘图格式字符串。有关详细信息，请参阅 plot 中的相应参数。

tz时区字符串或 datetime.tzinfo，默认值：rcParams["timezone"] (默认值：'UTC')

用于标记日期的时间区域。

xdate布尔值，默认值：True

如果为 True，x 轴将被解释为 Matplotlib 日期。

ydate布尔值，默认值：False

如果为 True，y 轴将被解释为 Matplotlib 日期。

返回:

Line2D 列表

表示绘制数据的对象。

其他参数:

data可索引对象，可选

如果给定，以下参数也接受字符串 s，如果 s 是 data 中的键，则将其解释为 data[s]。

x, y

**kwargs

关键字参数控制 Line2D 属性

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	浮点数或 None
animated	布尔值
antialiased 或 aa	布尔值
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
color 或 c	color
dash_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
dash_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
dashes	浮点数序列（点中的开/关墨迹）或 (None, None)
data	(2, N) 数组或两个一维数组
drawstyle 或 ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值: 'default'
figure	Figure 或 SubFigure
fillstyle	{'full', 'left', 'right', 'bottom', 'top', 'none'}
gapcolor	颜色 或 None
gid	str
in_layout	布尔值
label	对象
linestyle 或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth 或 lw	浮点数
marker	标记样式字符串，Path 或 MarkerStyle
markeredgecolor 或 mec	color
markeredgewidth 或 mew	浮点数
markerfacecolor 或 mfc	color
markerfacecoloralt 或 mfcalt	color
markersize 或 ms	浮点数
markevery	None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
mouseover	布尔值
path_effects	AbstractPathEffect 列表
picker	浮点数或 callable[[Artist, Event], tuple[bool, dict]]
pickradius	浮点数
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
solid_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
transform	未知
url	str
visible	布尔值
xdata	一维数组
ydata	一维数组
zorder	浮点数

另请参阅

matplotlib.dates

日期辅助函数。

matplotlib.dates.date2num

将日期转换为数字。

matplotlib.dates.num2date

将数字转换为日期。

matplotlib.dates.drange

创建等间距的日期序列。

备注

注意

这是 axes.Axes.plot_date 的 pyplot 包装器。

如果你使用自定义的日期刻度生成器和格式化器，则可能需要在调用 plot_date 之后设置格式化器/生成器。plot_date 会将默认的刻度生成器设置为 AutoDateLocator（如果刻度生成器尚未设置为 DateLocator 实例），并将默认的刻度格式化器设置为 AutoDateFormatter（如果刻度格式化器尚未设置为 DateFormatter 实例）。

自 3.9 版本弃用：请改用 plot。