DATETIMEADD - Add specified amount to the date and time variable

DATETIMEADD Add specified amount to the date and time variable

Top Previous Next

Syntax:	DATETIMEADD	[ variable ] [ const ] [ /options ]
Arguments:	[ variable ]	A variable containing the formatted date and time string in the format of Sat Feb 17 11.00.22 2001.
	[ const ]	A variable or a numeric constant representing the amount of time to add to the date and time string contained in [ variable ].
Options:	/day	Add specified number of days.
	/hour	Add specified number of hours.
	/minute	Add specified number of minutes.
	/second	Add specified number of seconds.

This script command is used to add a specified amount of time to the formatted date and time string variable. The [ /options ] argument is required.

Note: The %datetime internal variable should not be passed directly in the [ variable ] argument of this command. To use the value of %datetime with DATETIMEADD you must first assigned its value to to an intermediate user defined variable, and then pass that user defined variable as an argument.

Consider the example below where 14 days is added to a variable containing the current date and time.

SET today = %datetime

DATETIMEADD today 14 /day

DISPLAY today

Consider the example below where 34 minutes is added to a variable containing the current date and time.

SET today = %datetime

DATETIMEADD today 34 /minute

DISPLAY today

The number of days to add may also be expressed in a variable as shown below.

SET today = %datetime

SETNUM days = 14

DATETIMEADD today days /day

DISPLAY today

Related command(s): DATETIMESUB, IFDATETIME, DATEADD, DATESUB, IFDATE, IFTIME