1*6236dae4SAndroid Build Coastguard Worker--- 2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al. 3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl 4*6236dae4SAndroid Build Coastguard WorkerLong: time-cond 5*6236dae4SAndroid Build Coastguard WorkerShort: z 6*6236dae4SAndroid Build Coastguard WorkerArg: <time> 7*6236dae4SAndroid Build Coastguard WorkerHelp: Transfer based on a time condition 8*6236dae4SAndroid Build Coastguard WorkerProtocols: HTTP FTP 9*6236dae4SAndroid Build Coastguard WorkerCategory: http ftp 10*6236dae4SAndroid Build Coastguard WorkerAdded: 5.8 11*6236dae4SAndroid Build Coastguard WorkerMulti: single 12*6236dae4SAndroid Build Coastguard WorkerSee-also: 13*6236dae4SAndroid Build Coastguard Worker - etag-compare 14*6236dae4SAndroid Build Coastguard Worker - remote-time 15*6236dae4SAndroid Build Coastguard WorkerExample: 16*6236dae4SAndroid Build Coastguard Worker - -z "Wed 01 Sep 2021 12:18:00" $URL 17*6236dae4SAndroid Build Coastguard Worker - -z "-Wed 01 Sep 2021 12:18:00" $URL 18*6236dae4SAndroid Build Coastguard Worker - -z file $URL 19*6236dae4SAndroid Build Coastguard Worker--- 20*6236dae4SAndroid Build Coastguard Worker 21*6236dae4SAndroid Build Coastguard Worker# `--time-cond` 22*6236dae4SAndroid Build Coastguard Worker 23*6236dae4SAndroid Build Coastguard WorkerRequest a file that has been modified later than the given time and date, or 24*6236dae4SAndroid Build Coastguard Workerone that has been modified before that time. The date expression can be all 25*6236dae4SAndroid Build Coastguard Workersorts of date strings or if it does not match any internal ones, it is treated 26*6236dae4SAndroid Build Coastguard Workeras a filename and curl tries to get the modification date (mtime) from that 27*6236dae4SAndroid Build Coastguard Workerfile instead. See the *curl_getdate(3)* man pages for date expression details. 28*6236dae4SAndroid Build Coastguard Worker 29*6236dae4SAndroid Build Coastguard WorkerStart the date expression with a dash (-) to make it request for a document 30*6236dae4SAndroid Build Coastguard Workerthat is older than the given date/time, default is a document that is newer 31*6236dae4SAndroid Build Coastguard Workerthan the specified date/time. 32*6236dae4SAndroid Build Coastguard Worker 33*6236dae4SAndroid Build Coastguard WorkerIf provided a non-existing file, curl outputs a warning about that fact and 34*6236dae4SAndroid Build Coastguard Workerproceeds to do the transfer without a time condition. 35