datetick

Sensible date/time tick labels for Matplotlib

Motivation

Matplotlib's default date/time tick labels are often poor, and adjusting them requires using locators and formatters on an ad-hoc basis. A method or package for handling arbitrary time ranges does not exist.

In addition, the interfaces for locators and formatters complex and non-intuitive and require study and experimentation (e.g., [1], [2], [3], [4]. Tilting labels is an often-suggested solution, but this should not be needed.

datetick() contains logic for locators and formatters that apply to plots with arbitrary time ranges. One only needs to add the command datetick() after the usual plt.plot(...) command to have sensible and useable time tick labels. The primary configuration is a set of rules that account for the time range and an adjustable minimum gap between tick labels.

To prevent overlap and enforce a minimum gap, the font size is automatically reduced to a chosen minimum value. Then the number of ticks are reduced based on rules in rules.json.

Usage

import datetime as dt
import matplotlib.pyplot as plt
from datetick import datetick

dt1 = dt.datetime(2011, 1, 2)
dt2 = dt1 + dt.timedelta(days=1, hours=1, minutes=1)

plt.plot([dt1, dt2], [0.0,1.0])
datetick()
plt.show()
# or
# datetick('x') (use 'y' if y variable is datetime-like)
# or
# datetick('x', axes=plt.gca())
# or
# fig, axes = plt.subplots(2)
# plt.plot([dt1, dt2], [0.0, 1.0])
# datetick('x', axes=axes[0])

Comparison to default Matplotlib

Python-3.13/Matplotlib-3.10.9

axis=x

1.

2.

3.

4.

5.

6.

7.

8.

9.

10.

11.

12.

13.

14. Cross second boundary

15. Cross minute boundary

16. Cross hour boundary

17. Cross day boundary

18. Cross month boundary

19.

20. Cross second boundary

21. Cross minute boundary

22. Cross hour boundary

23. Cross day boundary

24. Cross month boundary

25.

26. Cross second boundary

27. Cross minute boundary

28. Cross hour boundary

29. Cross day boundary

30. Cross month boundary

31. (font size change: -0.8 pt)

32. Cross second boundary (font size change: -0.8 pt)

33. Cross minute boundary (font size change: -0.8 pt)

34. Cross hour boundary (font size change: -0.8 pt)

35. Cross day boundary (font size change: -0.8 pt)

36. Cross month boundary (font size change: -0.8 pt)

37. (font size change: -1.8 pt)

38. Cross second boundary (font size change: -1.8 pt)

39. Cross minute boundary (font size change: -1.8 pt)

40. Cross hour boundary (font size change: -1.8 pt)

41. Cross day boundary (font size change: -1.8 pt)

42. Cross month boundary (font size change: -1.9 pt)

43. (font size change: -2.8 pt)

44. Cross second boundary (font size change: -2.8 pt)

45. Cross minute boundary (font size change: -2.8 pt)

46. Cross hour boundary (font size change: -2.8 pt)

47. Cross day boundary (font size change: -2.8 pt)

48. Cross month boundary (font size change: -2.8 pt)

49.

50. Cross second boundary

51. Cross minute boundary

52. Cross hour boundary

53. Cross day boundary

54. Cross month boundary

55.

56. Cross second boundary

57. Cross minute boundary

58. Cross hour boundary

59. Cross day boundary

60. Cross month boundary

61.

62. Cross second boundary

63. Cross minute boundary

64. Cross hour boundary

65. Cross day boundary

66. Cross month boundary

67.

68. Cross second boundary (rule change: 1)

69. Cross minute boundary (rule change: 1)

70. Cross hour boundary (rule change: 1)

71. Cross day boundary (rule change: 1)

72. Cross month boundary (rule change: 1)