danvics/ytdl-sub
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(faq): Clarify re-download date TZ margins

Browse source 
From [Discord
discussion](https://discord.com/channels/994270357957648404/1102703969266049174/1408092149492224060).
This commit is contained in:
Ross Patterson 2025-08-21 07:40:00 -07:00
parent 8eb5215a0c
commit 251ef41078
No known key found for this signature in database
GPG key ID: 2EFF7CCE6828E359
4 changed files with 19 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
docs/source/config_reference/plugins.rst
View file

@ -147,9 +147,11 @@ Dates must adhere to a yt-dlp datetime. From their docs:
A string in the format YYYYMMDD or
(now|today|yesterday|date)[+-][0-9](microsecond|second|minute|hour|day|week|month|year)(s)
Valid examples are ``now-2weeks`` or ``20200101``. Can use override variables in this.
Note that yt-dlp will round times to the closest day, meaning that `day` is the lowest
granularity possible.
Valid examples are ``now-2weeks`` or ``20200101``. Can use override variables in
this. Note that yt-dlp will round times to the closest day, meaning that `day` is
the lowest granularity possible. Also note that, considering time zones, it's best
to include a margin of an extra day on either side to be sure it includes the
intended download files.
:Usage:

7
docs/source/faq/index.rst
View file

@ -195,9 +195,10 @@ need to be removed:
the subscriptions <guides/getting_started/first_download:faster iteration cycle>` to
download only the files that you've renamed in the steps above.
Set the appropriate dates and subscription name to include only the files you've
renamed, and re-run. For example, if you've renamed all the files from 2024 in the
``NOVA PBS`` subscription:
Set the appropriate dates, :ref:`including a sufficient margin
<config_reference/plugins:date_range>`, and subscription name to include only the
files you've renamed, and re-run. For example, if you've renamed all the files from
2024 in the ``NOVA PBS`` subscription:
.. code-block:: shell

8
src/ytdl_sub/plugins/date_range.py
View file

@ -25,9 +25,11 @@ class DateRangeOptions(ToggleableOptionsDictValidator):
A string in the format YYYYMMDD or
(now|today|yesterday|date)[+-][0-9](microsecond|second|minute|hour|day|week|month|year)(s)
Valid examples are ``now-2weeks`` or ``20200101``. Can use override variables in this.
Note that yt-dlp will round times to the closest day, meaning that `day` is the lowest
granularity possible.
Valid examples are ``now-2weeks`` or ``20200101``. Can use override variables in
this. Note that yt-dlp will round times to the closest day, meaning that `day` is
the lowest granularity possible. Also note that, considering time zones, it's best
to include a margin of an extra day on either side to be sure it includes the
intended download files.
:Usage:

8
src/ytdl_sub/validators/string_datetime.py
View file

@ -12,9 +12,11 @@ class StringDatetimeValidator(OverridesStringFormatterValidator):
A string in the format YYYYMMDD or
(now|today|yesterday|date)[+-][0-9](microsecond|second|minute|hour|day|week|month|year)(s)
Valid examples are ``now-2weeks`` or ``20200101``. Can use override variables in this.
Note that yt-dlp will round times to the closest day, meaning that `day` is the lowest
granularity possible.
Valid examples are ``now-2weeks`` or ``20200101``. Can use override variables in
this. Note that yt-dlp will round times to the closest day, meaning that `day` is
the lowest granularity possible. Also note that, considering time zones, it's best
to include a margin of an extra day on either side to be sure it includes the
intended download files.
"""
_expected_value_type_name = "datetime string"