CURLOPT_TIMEVALUE_LARGE − set time value for conditional
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEVALUE_LARGE, curl_off_t val);
Pass a curl_off_t val as parameter. This should be the time counted as seconds since 1 Jan 1970, and the time will be used in a condition as specified with CURLOPT_TIMECONDITION(3).
The difference between this option and CURLOPT_TIMEVALUE(3) is the type of the argument. On systems where ’long’ is only 32 bit wide, this option has to be used to set dates beyond the year 2038.
HTTP, FTP, RTSP, and FILE
CURL *curl =
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* January 1,
2020 is 1577833200 */
curl_easy_setopt(curl, CURLOPT_TIMEVALUE_LARGE, (curl_off_t)1577833200);
If-Modified-Since the above time stamp */
curl_easy_setopt(curl, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);
/* Perform the
Added in 7.59.0.