jobqueue: Add docstring note about intervals and DST

Fixes #1381
python-telegram-bot · Apr 26, 2019 · e12ecf4 · e12ecf4
1 parent 2cde878
commit e12ecf4
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/telegram/ext/jobqueue.py b/telegram/ext/jobqueue.py
@@ -172,6 +172,11 @@ def run_repeating(self, callback, interval, first=None, context=None, name=None)
             :class:`telegram.ext.Job`: The new ``Job`` instance that has been added to the job
             queue.
 
+        Notes:
+             `interval` is always respected "as-is". That means that if DST changes during that
+             interval, the job might not run at the time one would expect. It is always recommended
+             to pin servers to UTC time, then time related behaviour can always be expected.
+
         """
         job = Job(callback,
                   interval=interval,
@@ -202,6 +207,11 @@ def run_daily(self, callback, time, days=Days.EVERY_DAY, context=None, name=None
             :class:`telegram.ext.Job`: The new ``Job`` instance that has been added to the job
             queue.
 
+        Notes:
+             Daily is just an alias for "24 Hours". That means that if DST changes during that
+             interval, the job might not run at the time one would expect. It is always recommended
+             to pin servers to UTC time, then time related behaviour can always be expected.
+
         """
         job = Job(callback,
                   interval=datetime.timedelta(days=1),