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 A string in the format YYYYMMDD or
(now|today|yesterday|date)[+-][0-9](microsecond|second|minute|hour|day|week|month|year)(s) (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. Valid examples are ``now-2weeks`` or ``20200101``. Can use override variables in
Note that yt-dlp will round times to the closest day, meaning that `day` is the lowest this. Note that yt-dlp will round times to the closest day, meaning that `day` is
granularity possible. 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: :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 the subscriptions <guides/getting_started/first_download:faster iteration cycle>` to
download only the files that you've renamed in the steps above. 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 Set the appropriate dates, :ref:`including a sufficient margin
renamed, and re-run. For example, if you've renamed all the files from 2024 in the <config_reference/plugins:date_range>`, and subscription name to include only the
``NOVA PBS`` subscription: 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 .. 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 A string in the format YYYYMMDD or
(now|today|yesterday|date)[+-][0-9](microsecond|second|minute|hour|day|week|month|year)(s) (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. Valid examples are ``now-2weeks`` or ``20200101``. Can use override variables in
Note that yt-dlp will round times to the closest day, meaning that `day` is the lowest this. Note that yt-dlp will round times to the closest day, meaning that `day` is
granularity possible. 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: :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 A string in the format YYYYMMDD or
(now|today|yesterday|date)[+-][0-9](microsecond|second|minute|hour|day|week|month|year)(s) (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. Valid examples are ``now-2weeks`` or ``20200101``. Can use override variables in
Note that yt-dlp will round times to the closest day, meaning that `day` is the lowest this. Note that yt-dlp will round times to the closest day, meaning that `day` is
granularity possible. 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" _expected_value_type_name = "datetime string"