DateTime.Now.AddSeconds(Seconds)

.AddSeconds(Seconds) adds the specified number of seconds to the DateTime object. To subtract seconds, simply supply the Seconds parameter with a negative number. If you are working with a Date without time, this method will add seconds to midnight (00:00:00).

Note: the AddSeconds() method adds the seconds to the date or variable calling it.

You cannot do something like this:

var ldNow = DateTime.Now;

var ldNextSecond = ldNow.AddSeconds(1);

ldNow will be the same as ldNextSecond.

Applies To

Properties and Methods

None

Available

The .AddSeconds(Seconds) method is available in:

  • 15.03.016
  • All newer builds

Type

DateTime

Syntax

DateTime.Now.AddSeconds(Seconds);

Parameters

Parameter

Required

Description

Seconds

Yes

An integer value. Can be positive or negative.

Non-integers will generate a scripting error.

Example

var ldNew = new DateTime('6/10/2021 12:34:56');

var ldNewA = new DateTime('6/10/2021 12:34:56').AddSeconds(1);

var ldNewB = new DateTime('6/10/2021 12:34:56').AddSeconds(10);

var ldNewC = new DateTime('6/10/2021 12:34:56').AddSeconds(100);

var ldNewD = new DateTime('6/10/2021 12:34:56').AddSeconds(1000);

var ldNewE = new DateTime('6/10/2021 12:34:56').AddSeconds(-10);

var ldDate = new DateTime('6/10/2021');

var ldDateA = new DateTime('6/10/2021').AddSeconds(17);

Event.Form.MessageBox('Add Seconds to ' + ldNew.ShortDateString + ' ' + ldNew.LongTimeString + ':' +

'\n1 Second: ' + ldNewA.ShortDateString + ' ' + ldNewA.LongTimeString +

'\n10 Seconds: ' + ldNewB.ShortDateString + ' ' + ldNewB.LongTimeString +

'\n100 Seconds: ' + ldNewC.ShortDateString + ' ' + ldNewC.LongTimeString +

'\n1000 Seconds: ' + ldNewD.ShortDateString + ' ' + ldNewD.LongTimeString +

'\n-10 Seconds: ' + ldNewE.ShortDateString + ' ' + ldNewE.LongTimeString +

'\n\nAdd Seconds to ' + ldDate.ShortDateString + ' ' + ldDate.LongTimeString + ':' +

'\n10 Seconds: ' + ldDateA.ShortDateString + ' ' + ldDateA.LongTimeString);

 

/* Expected Prompt response:

Add Seconds to 06/10/2021 12:34:56:

1 Second: 06/10/2021 12:34:57

10 Seconds: 06/10/2021 12:35:06

100 Seconds: 06/10/2021 12:36:36

1000 Seconds: 06/10/2021 12:51:36

-10 Seconds: 06/10/2021 12:34:46

 

Add Seconds to 06/10/2021 00:00:00:

10 Seconds: 06/10/2021 00:00:17

*/