Skip to content
Related Articles

Related Articles

Matplotlib.dates.AutoDateFormatter class in Python
  • Last Updated : 21 Apr, 2020

Matplotlib is an amazing visualization library in Python for 2D plots of arrays. Matplotlib is a multi-platform data visualization library built on NumPy arrays and designed to work with the broader SciPy stack.


The matplotlib.dates.AutoDateFormatter class is used to figure out the best format to use for the date. This is best used with AutoDateLocator. It has a dictionary that maps scale of the tick and a format string. By default it looks as below:

self.scaled = {
DAYS_PER_YEAR: rcParams[‘date.autoformat.year’],
DAYS_PER_MONTH: rcParams[‘date.autoformat.month’],
1.0: rcParams[‘’],
1. / HOURS_PER_DAY: rcParams[‘date.autoformat.hour’],
1. / (MINUTES_PER_DAY): rcParams[‘date.autoformat.minute’],
1. / (SEC_PER_DAY): rcParams[‘date.autoformat.second’],
1. / (MUSECONDS_PER_DAY): rcParams[‘date.autoformat.microsecond’],

The key in that dictionary that is greater then or equal to the current scale is picked by this algorithm and is used to format strings. This dictionary can also be customized like below:

locator = AutoDateLocator()
formatter = AutoDateFormatter(locator)

# only show hour and minute
formatter.scaled[1/(24.*60.)] = '%H:%M'

The default format is used if no value in self.scaled is greater than the unit returned by locator._get_unit().

Syntax: class matplotlib.dates.AutoDateFormatter(locator, tz=None, defaultfmt=’%Y-%m-%d’)


  1. locator: It determines the tick locations when plotting dates.
  2. tz: It holds the time-zone information
  3. defaultfmt: If no format matches=ches the requirment this format is used as a default in years-months-days format.

Example 1:

import datetime
import matplotlib.pyplot as plt
from matplotlib.dates import AutoDateLocator, AutoDateFormatter, date2num
# make my own data:
date = '2020-02-23'
low = 10
# how to format dates:
date_datetime = datetime.datetime.strptime(date, '% Y-% m-% d')
int_date = date2num( date_datetime)
# create plots:
figure, axes = plt.subplots()
# plot data:, low, label ="", color ="green")
# format date 
locator = AutoDateLocator()
axes.xaxis.set_major_formatter( AutoDateFormatter(locator) )
# apply autoformatter for displaying of dates
min_date = date2num( datetime.datetime.strptime('2020-02-16', '% Y-% m-% d') )
max_date = date2num( datetime.datetime.strptime('2020-02-28', '% Y-% m-% d') )
axes.set_xlim([min_date, max_date])
# show plot:


Example 2:

import random
import matplotlib.pyplot as plt
import matplotlib.dates as mdates
# generate some random data for
# approx 5 yrs
random_data = [float(random.randint(1487517521,
               for _ in range(1000)]
# convert the epoch format to
# matplotlib date format 
mpl_data = mdates.epoch2num(random_data)
# plotting the graph
fig, axes = plt.subplots(1, 1)
axes.hist(mpl_data, bins = 51, color ='green')
locator = mdates.AutoDateLocator()


 Attention geek! Strengthen your foundations with the Python Programming Foundation Course and learn the basics.  

To begin with, your interview preparations Enhance your Data Structures concepts with the Python DS Course. And to begin with your Machine Learning Journey, join the Machine Learning – Basic Level Course

My Personal Notes arrow_drop_up
Recommended Articles
Page :