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

See also: Using the %date, %datetime, and %time Variables