Skip to main content
`Ctrl`+`K`

# pandas.plotting.register_matplotlib_converters

pandas.plotting.register_matplotlib_converters()

  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')

  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'