DateTime.Now.AddHours(Hours)

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

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

var ldNow = DateTime.Now;

var ldNextHour = ldNow.AddHours(1);

IdNow will be the same as IdNextHour.

Applies To

Properties and Methods

None

Available

The .AddHours(Hours) method is available in:

  • 15.03.016

  • All newer builds

Type

DateTime

Syntax

DateTime.Now.AddHours(Hours);

Parameters

Parameter

Required

Description

Hours

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

/* Expected Prompt response:

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

1 Hour: 06/10/2021 13:34:56

10 Hours: 06/10/2021 22:34:56

100 Hours: 06/14/2021 16:34:56

1000 Hours: 07/22/2021 04:34:56

-10 Hours: 06/10/2021 02:34:56

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

10 Hours: 06/10/2021 17:00:00

*/