function IncSecond ( const StartDateTime : TDateTime {; NumberOfSeconds : Integer = 1} ) : TDateTime;
Description
The IncSecond function returns a TDateTime value that is NumberOfSeconds greater than the passed StartDateTime value.
The year, month, day and hour values are incremented as appropriate.
The increment value is optional, being 1 by default.
Notes
There is no DecSecond function.
Instead, use IncSecond with a negative increment.
Related commands
IncYear Increments a TDateTime variable by a number of years
IncMonth Increments a TDateTime variable by a number of months
IncDay Increments a TDateTime variable by + or - number of days
IncMinute Increments a TDateTime variable by + or - number of minutes
IncMillisecond Increments a TDateTime variable by + or - number of milliseconds
Example code : A simple example of increment and decrement
var
myDate : TDateTime;
begin
// Set up our date just before the end of the year 2005
myDate := EncodeDateTime(2005, 12, 31, 23, 59, 0, 0);
ShowMessage('myDate = '+DateTimeToStr(myDate));
// Add 60 seconds to this date
myDate := IncSecond(myDate, 60);
ShowMessage('myDate + 100 seconds = '+DateTimeToStr(myDate));
// Subtract 120 seconds from this date
myDate := IncSecond(myDate, -120);
ShowMessage('myDate - 120 seconds = '+DateTimeToStr(myDate));
end;
Show full unit code
myDate = 31/12/2005 23:59:00
myDate = 01/01/2006
myDate = 31/12/2005 23:58:00