Deprecate to-days converters in matplotlib dates

timhoffm · timhoffm · commit 39bdf393f0b5 · 2018-10-04T01:04:11.000+02:00
diff --git a/doc/api/next_api_changes/2018-10-04-TH-deprecations.rst b/doc/api/next_api_changes/2018-10-04-TH-deprecations.rst
@@ -0,0 +1,7 @@
+API deprecations
+````````````````
+
+The following API elements are deprecated:
+
+- ``dates.seconds()``, ``dates.minutes()``, ``dates.hours()``,
+  ``dates.weeks()``
diff --git a/lib/matplotlib/dates.py b/lib/matplotlib/dates.py
@@ -1728,27 +1728,31 @@ def date_ticker_factory(span, tz=None, numticks=5):
     return locator, formatter
 
 
+@cbook.deprecated("3.1")
 def seconds(s):
     """
     Return seconds as days.
     """
     return s / SEC_PER_DAY
 
 
+@cbook.deprecated("3.1")
 def minutes(m):
     """
     Return minutes as days.
     """
     return m / MINUTES_PER_DAY
 
 
+@cbook.deprecated("3.1")
 def hours(h):
     """
     Return hours as days.
     """
     return h / HOURS_PER_DAY
 
 
+@cbook.deprecated("3.1")
 def weeks(w):
     """
     Return weeks as days.
