Dates on x-axis in Matplotlib

Introduction

We use dates on the x-axis to show how data changes over time. It helps us see trends and patterns clearly.

Tracking daily sales over a month.

Showing temperature changes over a week.

Visualizing stock prices over several days.

Plotting website visitors by date.

Displaying progress of a project over time.

Syntax

Matplotlib

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

# Prepare dates and values
dates = [datetime(2024, 1, 1), datetime(2024, 1, 2), datetime(2024, 1, 3)]
values = [10, 15, 7]

# Plot data
plt.plot(dates, values)

# Format x-axis to show dates nicely
plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%Y-%m-%d'))
plt.gca().xaxis.set_major_locator(mdates.DayLocator())

plt.xlabel('Date')
plt.ylabel('Value')
plt.title('Values over Dates')
plt.gcf().autofmt_xdate()  # Rotate date labels
plt.show()

Use datetime objects for dates on x-axis.

mdates.DateFormatter controls how dates appear.

Examples

This example shows dates as 'Jun 01', 'Jun 02', etc., which is shorter and easier to read.

Matplotlib

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

dates = [datetime(2024, 6, 1), datetime(2024, 6, 2), datetime(2024, 6, 3)]
values = [5, 8, 6]

plt.plot(dates, values)
plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%b %d'))
plt.gcf().autofmt_xdate()
plt.show()

This example shows dates every 2 days on the x-axis for less clutter.

Matplotlib

import matplotlib.pyplot as plt
import matplotlib.dates as mdates
from datetime import datetime, timedelta

dates = [datetime(2024, 1, 1) + timedelta(days=i) for i in range(7)]
values = [3, 5, 2, 8, 7, 6, 4]

plt.plot(dates, values)
plt.gca().xaxis.set_major_locator(mdates.DayLocator(interval=2))
plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%m-%d'))
plt.gcf().autofmt_xdate()
plt.show()

Sample Program

This program plots daily temperatures over one week with dates on the x-axis formatted as 'YYYY-MM-DD'. The dates are rotated for easy reading.

Matplotlib

import matplotlib.pyplot as plt
import matplotlib.dates as mdates
from datetime import datetime, timedelta

# Create dates for one week
start_date = datetime(2024, 4, 1)
dates = [start_date + timedelta(days=i) for i in range(7)]

# Sample values for each date
values = [20, 22, 19, 24, 23, 25, 21]

# Plot the data
plt.plot(dates, values, marker='o')

# Format the x-axis to show dates nicely
plt.gca().xaxis.set_major_locator(mdates.DayLocator())
plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%Y-%m-%d'))

plt.xlabel('Date')
plt.ylabel('Temperature (°C)')
plt.title('Daily Temperatures Over One Week')
plt.gcf().autofmt_xdate()  # Rotate date labels for better fit
plt.tight_layout()
plt.show()

Important Notes

Always use datetime objects for dates, not strings, to avoid errors.

Use autofmt_xdate() to rotate date labels so they don’t overlap.

You can change the date format by modifying the string in DateFormatter, like '%b %d' for 'Jun 01'.

Summary

Dates on the x-axis help show how data changes over time.

Use datetime objects and matplotlib.dates to format dates.

Rotate date labels for better readability with autofmt_xdate().

Practice

1. What is the main reason to use datetime objects on the x-axis in matplotlib plots?

easy

A. To display dates properly and allow date-specific formatting

B. To speed up the plotting process

C. To change the color of the plot lines

D. To add grid lines automatically

Solution

1. Step 1: Understand the role of datetime objects

   Datetime objects represent dates and times in Python, allowing matplotlib to recognize and format them correctly on the x-axis.

2. Step 2: Identify the benefit for plotting

   Using datetime objects enables proper date formatting, such as showing months, days, or years, and helps in handling date ticks automatically.

3. Final Answer:

   To display dates properly and allow date-specific formatting -> Option A

4. Quick Check:

   Datetime objects = Proper date display [OK]

Hint: Use datetime objects to get correct date formatting on x-axis [OK]

Common Mistakes:

• Using strings instead of datetime objects for dates
• Expecting automatic color changes from datetime
• Confusing grid lines with date formatting

2. Which of the following is the correct way to import the module used for date formatting in matplotlib?

easy

A. import matplotlib.date as mdate

B. import matplotlib.dates as mdates

C. import matplotlib.datetime as mdates

D. import matplotlib.dateformatter as mdates

Solution

1. Step 1: Recall the correct module name

   The correct module for date formatting in matplotlib is called dates, not date or datetime.

2. Step 2: Match the import alias

   Common practice is to import it as mdates for convenience.

3. Final Answer:

   import matplotlib.dates as mdates -> Option B

4. Quick Check:

   matplotlib.dates = mdates [OK]

Hint: Remember: 'dates' plural, alias 'mdates' [OK]

Common Mistakes:

• Using singular 'date' instead of 'dates'
• Confusing datetime module with matplotlib.dates
• Using wrong alias causing import errors

3. What will the following code output?

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

dates = [datetime(2024, 1, 1), datetime(2024, 1, 2), datetime(2024, 1, 3)]
values = [10, 20, 15]

plt.plot(dates, values)
plt.gcf().autofmt_xdate()
plt.show()

medium

A. A line plot with dates on x-axis formatted and rotated for readability

B. A line plot with numeric x-axis values instead of dates

C. An error because dates are not converted to strings

D. A scatter plot with dates on y-axis

Solution

1. Step 1: Understand the plot function with datetime

   The plt.plot function accepts datetime objects on the x-axis and plots the corresponding values.

2. Step 2: Effect of autofmt_xdate()

   This function rotates and formats the date labels on the x-axis to prevent overlap and improve readability.

3. Final Answer:

   A line plot with dates on x-axis formatted and rotated for readability -> Option A

4. Quick Check:

   autofmt_xdate() rotates date labels [OK]

Hint: Use autofmt_xdate() to rotate date labels automatically [OK]

Common Mistakes:

• Expecting string conversion of dates automatically
• Confusing plot type with scatter
• Ignoring the effect of autofmt_xdate()

4. Identify the error in this code snippet that tries to plot dates on the x-axis:

import matplotlib.pyplot as plt
from datetime import datetime

dates = ['2024-01-01', '2024-01-02', '2024-01-03']
values = [5, 10, 15]

plt.plot(dates, values)
plt.show()

medium

A. plt.plot cannot plot lists

B. Values list length does not match dates list length

C. Missing import for matplotlib.dates module

D. Dates are strings, not datetime objects, causing incorrect x-axis formatting

Solution

1. Step 1: Check the type of dates list

   The dates are given as strings, which matplotlib does not automatically convert to dates for axis formatting.

2. Step 2: Understand the impact on plotting

   Using strings causes matplotlib to treat them as categorical labels, not dates, so date formatting and scaling won't work properly.

3. Final Answer:

   Dates are strings, not datetime objects, causing incorrect x-axis formatting -> Option D

4. Quick Check:

   Use datetime objects, not strings for dates [OK]

Hint: Convert date strings to datetime objects before plotting [OK]

Common Mistakes:

• Using strings directly for dates
• Assuming matplotlib auto-converts strings to dates
• Ignoring the need for datetime conversion

5. You want to plot daily sales data for January 2024 with dates on the x-axis. You have a list of date strings and sales numbers. Which code snippet correctly converts the dates and formats the x-axis for clear display?

dates = ['2024-01-01', '2024-01-02', '2024-01-03']
sales = [100, 150, 120]

hard

A. from datetime import datetime
plt.plot([datetime(d) for d in dates], sales)
plt.show()

B. import matplotlib.pyplot as plt
plt.plot(dates, sales)
plt.xticks(rotation=45)
plt.show()

C. from datetime import datetime
import matplotlib.pyplot as plt
import matplotlib.dates as mdates

converted_dates = [datetime.strptime(d, '%Y-%m-%d') for d in dates]
plt.plot(converted_dates, sales)
plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%b %d'))
plt.gcf().autofmt_xdate()
plt.show()

D. import matplotlib.dates as mdates
plt.plot(dates, sales)
plt.gca().xaxis.set_major_locator(mdates.DayLocator())
plt.show()

Solution

1. Step 1: Convert date strings to datetime objects

   Use datetime.strptime with the correct format to convert each string to a datetime object.

2. Step 2: Format x-axis dates and rotate labels

   Use mdates.DateFormatter to set a readable date format and autofmt_xdate() to rotate labels for clarity.

3. Final Answer:

   The code snippet that correctly converts dates and formats x-axis -> Option C

4. Quick Check:

   Convert dates + format + rotate labels = from datetime import datetime import matplotlib.pyplot as plt import matplotlib.dates as mdates converted_dates = [datetime.strptime(d, '%Y-%m-%d') for d in dates] plt.plot(converted_dates, sales) plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%b %d')) plt.gcf().autofmt_xdate() plt.show() [OK]

Hint: Convert strings with strptime, format with DateFormatter, rotate labels [OK]

Common Mistakes:

• Plotting strings without conversion
• Using datetime(d) instead of strptime
• Forgetting to rotate date labels