DateTime.Now.AddMinutes(Minutes)

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

Note: The AddMinutes() method adds the minutes to the date or variable calling it. You cannot do something like this:

var ldNow = DateTime.Now;

var ldNextMinute = ldNow.AddDays(1);

IdNow will be the same as IdNextMinute.

Applies To

Properties and Methods

None

Available

The .AddMinutes(Minutes) method is available in:

  • 15.03.016
  • All newer builds

Type

DateTime

Syntax

DateTime.Now.AddMinutes(Minutes);

Parameters

Parameter

Required

Description

Minutes

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').AddMinutes(1);

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

/* Expected Prompt response:

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

1 Minute: 06/10/2021 12:35:56

10 Minutes: 06/10/2021 12:44:56

100 Minutes: 06/10/2021 14:14:56

1000 Minutes: 06/11/2021 05:14:56

-10 Minutes: 06/10/2021 12:24:56

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

10 Minutes: 06/10/2021 00:17:00

*/