| 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 |
// Full Unit code.
// -----------------------------------------------------------
// You must store this code in a unit called Unit1 with a form
// called Form1 that has an OnCreate event called FormCreate.
unit Unit1;
interface
uses
DateUtils, // Unit containing the IncSecond command
SysUtils,
Forms, Dialogs;
type
TForm1 = class(TForm)
procedure FormCreate(Sender: TObject);
end;
var
Form1: TForm1;
implementation
{$R *.dfm} // Include form definitions
procedure TForm1.FormCreate(Sender: TObject);
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 + 60 seconds = '+DateTimeToStr(myDate));
// Subtract 120 seconds from this date
myDate := IncSecond(myDate, -120);
ShowMessage('myDate - 120 seconds = '+DateTimeToStr(myDate));
end;
end.
|
| Hide full unit code |
myDate = 31/12/2005 23:59:00
myDate + 60 seconds = 01/01/2006
myDate - 120 seconds = 31/12/2005 23:58:00
|
|