Skip to main content Link Search Menu Expand Document Toggle dark mode Copy Code (external link)

addSeconds() : Add Seconds to Date

Add seconds to a datetime. Use negative values to subtract seconds.


On this page

Signature

addSeconds(date, seconds)

Parameters

Parameter Type Required Description
date DateTime Yes The datetime to modify
seconds Number Yes Number of seconds to add (can be negative)

Returns

Type: DateTime

A new DateTime with the specified seconds added.


Examples

Add Seconds

<p>Timeout: {{format(addSeconds(model.startTime, 30), 'h:mm:ss tt')}}</p>

Data:

doc.Params["model"] = new {
    startTime = new DateTime(2024, 3, 15, 14, 30, 0)
};

Output:

<p>Timeout: 2:30:30 PM</p>

Countdown Display

<p>T-minus: {{secondsBetween(model.now, addSeconds(model.launchTime, 0))}} seconds</p>

Processing Time

<p>Completed: {{format(addSeconds(model.started, model.elapsedSeconds), 'h:mm:ss')}}</p>

Data:

doc.Params["model"] = new {
    started = new DateTime(2024, 3, 15, 10, 0, 0),
    elapsedSeconds = 125
};

Output:

<p>Completed: 10:02:05</p>

Notes

  • Input datetime is not modified (returns new datetime)
  • Can add positive or negative seconds
  • Automatically handles minute, hour, and day boundaries
  • Use addMilliseconds() for millisecond precision
  • Use addMinutes() for minute increments

See Also