pandas.plotting.register_matplotlib_converters#

pandas.plotting.register_matplotlib_converters()[source]#

Register pandas formatters and converters with matplotlib.

This function modifies the global matplotlib.units.registry dictionary. pandas adds custom converters for

  • pd.Timestamp

  • pd.Period

  • np.datetime64

  • datetime.datetime

  • datetime.date

  • datetime.time

See also

deregister_matplotlib_converters

Remove pandas formatters and converters.

Examples

The following line is done automatically by pandas so the plot can be rendered:

>>> pd.plotting.register_matplotlib_converters()

>>> df = pd.DataFrame(
...     {"ts": pd.period_range("2020", periods=2, freq="M"), "y": [1, 2]}
... )
>>> plot = df.plot.line(x="ts", y="y")
../../_images/pandas-plotting-register_matplotlib_converters-1.png

Unsetting the register manually an error will be raised:

>>> pd.set_option(
...     "plotting.matplotlib.register_converters", False
... )  
>>> df.plot.line(x="ts", y="y")  
Traceback (most recent call last):
TypeError: float() argument must be a string or a real number, not 'Period'