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