Delphi DLL

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.

Chilkat Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
success: Boolean;
sftp: HCkSFtp;
port: Integer;
password: PWideChar;
bIsHandle: Boolean;
dateTimeStr: PWideChar;

begin
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.

sftp := CkSFtp_Create();

//  Connect, authenticate, and initialize the SFTP subsystem.
port := 22;
success := CkSFtp_Connect(sftp,'sftp.example.com',port);
if (success = False) then
  begin
    Memo1.Lines.Add(CkSFtp__lastErrorText(sftp));
    Exit;
  end;

//  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.
password := 'mySshPassword';

success := CkSFtp_AuthenticatePw(sftp,'mySshLogin',password);
if (success = False) then
  begin
    Memo1.Lines.Add(CkSFtp__lastErrorText(sftp));
    Exit;
  end;

success := CkSFtp_InitializeSftp(sftp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkSFtp__lastErrorText(sftp));
    Exit;
  end;

//  The 1st argument is a path, so bIsHandle is 0.
bIsHandle := False;
dateTimeStr := 'Fri, 10 Jul 2026 20:15:30 -0600';
success := CkSFtp_SetLastModifiedTimeStr(sftp,'subdir/report.pdf',bIsHandle,dateTimeStr);
if (success = False) then
  begin
    Memo1.Lines.Add(CkSFtp__lastErrorText(sftp));
    Exit;
  end;
Memo1.Lines.Add('Last-modified time set.');

CkSFtp_Disconnect(sftp);

CkSFtp_Dispose(sftp);