diff --git a/docs/usage/general/date-time.rst.inc b/docs/usage/general/date-time.rst.inc
index 4926eb3bd..58f594a97 100644
--- a/docs/usage/general/date-time.rst.inc
+++ b/docs/usage/general/date-time.rst.inc
@@ -8,3 +8,10 @@ For more information about that, see: https://xkcd.com/1179/
 
 Unless otherwise noted, we display local date and time.
 Internally, we store and process date and time as UTC.
+
+
+.. rubric:: TIMESPAN
+
+Some options accept a TIMESPAN parameter, which can be given as a
+number of days (e.g. ``7d``) or months (e.g. ``12m``).
+