JavaScript

Set a Remote File's Last-Modified Time

Demonstrates the Chilkat SFtp.SetLastModifiedTimeStr method, which sets a remote file's last-modified date and time. The arguments are the remote path (or handle), whether the first argument is a handle, and an RFC 822 formatted date/time string.

Background: Of the three timestamps, the modified time is the one you most often want to set, because sync and build tools compare it to decide what is current. Stamping an uploaded file with its source's modified time keeps a mirror consistent and prevents an incremental sync from needlessly re-copying it. This is the most widely supported timestamp to set across servers.

Note

This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.

JavaScript

var success = false;

//  Demonstrates the SFtp.SetLastModifiedTimeStr method, which sets a remote file's last-modified
//  date and time.  The 1st argument is the remote path (or handle), the 2nd (bIsHandle) indicates
//  which, and the 3rd is an RFC 822 formatted date/time string.

var sftp = new CkSFtp();

//  Connect, authenticate, and initialize the SFTP subsystem.
var port = 22;
success = sftp.Connect("sftp.example.com",port);
if (success == false) {
    console.log(sftp.LastErrorText);
    return;
}

//  Normally you would not hard-code the password in source.  You should instead obtain it
//  from an interactive prompt, environment variable, or a secrets vault.
var password = "mySshPassword";

success = sftp.AuthenticatePw("mySshLogin",password);
if (success == false) {
    console.log(sftp.LastErrorText);
    return;
}

success = sftp.InitializeSftp();
if (success == false) {
    console.log(sftp.LastErrorText);
    return;
}

//  The 1st argument is a path, so bIsHandle is false.
var bIsHandle = false;
var dateTimeStr = "Fri, 10 Jul 2026 20:15:30 -0600";
success = sftp.SetLastModifiedTimeStr("subdir/report.pdf",bIsHandle,dateTimeStr);
if (success == false) {
    console.log(sftp.LastErrorText);
    return;
}

console.log("Last-modified time set.");

sftp.Disconnect();