time-cond.d 1.0 KB

123456789101112131415161718192021222324252627
  1. c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
  2. SPDX-License-Identifier: curl
  3. Long: time-cond
  4. Short: z
  5. Arg: <time>
  6. Help: Transfer based on a time condition
  7. Protocols: HTTP FTP
  8. Category: http ftp
  9. Example: -z "Wed 01 Sep 2021 12:18:00" $URL
  10. Example: -z "-Wed 01 Sep 2021 12:18:00" $URL
  11. Example: -z file $URL
  12. Added: 5.8
  13. See-also: etag-compare remote-time
  14. Multi: single
  15. ---
  16. Request a file that has been modified later than the given time and date, or
  17. one that has been modified before that time. The <date expression> can be all
  18. sorts of date strings or if it does not match any internal ones, it is taken as
  19. a filename and tries to get the modification date (mtime) from <file>
  20. instead. See the *curl_getdate(3)* man pages for date expression details.
  21. Start the date expression with a dash (-) to make it request for a document
  22. that is older than the given date/time, default is a document that is newer
  23. than the specified date/time.
  24. If provided a non-existing file, curl outputs a warning about that fact and
  25. proceeds to do the transfer without a time condition.