summary refs log tree commit diff
diff options
context:
space:
mode:
authorJaime Marquínez Ferrándiz <jaime.marquinez.ferrandiz@gmail.com>2013-04-28 12:02:30 +0200
committerJaime Marquínez Ferrándiz <jaime.marquinez.ferrandiz@gmail.com>2013-04-28 12:02:30 +0200
commite31852aba934f5d53c50002ff832e290b72d8844 (patch)
tree508da3579ff32ef97e03c3ff09e7065326d1edc4
parent37254abc36695692649348099fae0ed8f73fd3d1 (diff)
downloadyoutube-dl-e31852aba934f5d53c50002ff832e290b72d8844.tar.gz
youtube-dl-e31852aba934f5d53c50002ff832e290b72d8844.tar.xz
youtube-dl-e31852aba934f5d53c50002ff832e290b72d8844.zip
Document the video selection using the upload date
-rw-r--r--README.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/README.md b/README.md
index d3073e641..e4281ec58 100644
--- a/README.md
+++ b/README.md
@@ -167,6 +167,19 @@ In some cases, you don't want special characters such as 中, spaces, or &, such
     $ youtube-dl --get-filename -o "%(title)s.%(ext)s" BaW_jenozKc --restrict-filenames
     youtube-dl_test_video_.mp4          # A simple file name
 
+# VIDEO SELECTION
+
+Videos can be filtered by their upload date using the options `--date`, `--datebefore` or `--dateafter`, they accept dates in two formats:
+
+ - Absolute dates: Dates in the format `YYYYMMDD`.
+ - Relative dates: Dates in the format `(now|today)[+-][0-9](day|week|month|year)(s)?`
+ 
+Examples:
+
+	$ youtube-dl --dateafter now-6months #will only download the videos uploaded in the last 6 months
+	$ youtube-dl --date 19700101 #will only download the videos uploaded in January 1, 1970
+	$ youtube-dl --dateafter 20000101 --datebefore 20100101 #will only download the videos uploaded between 2000 and 2010
+
 # FAQ
 
 ### Can you please put the -b option back?