Integration Server 10.3 | Built-In Services Reference Guide | Date Folder | Summary of Elements in this Folder | pub.date:incrementDate
 
pub.date:incrementDate
WmPublic. Increments a date by a specified amount of time.
Input Parameters
startDate
String Starting date and time.
startDatePattern
String Format in which the startDate parameter is specified (for example, yyyyMMdd HH:mm:ss.SSS). For pattern-string notation, see Pattern String Symbols.
endDatePattern
String Optional. Pattern representing the format in which you want the endDate to be returned. For pattern-string notation, see Pattern String Symbols.
If no endDatePattern is specified, the endDate will be returned in the format specified in the startDatePattern parameter.
addYears
String Optional. Number of years to add to startDate. The value must be an integer between -2147483648 and 2147483647.
addMonths
String Optional. Number of months to add to startDate. The value must be an integer between -2147483648 and 2147483647.
addDays
String Optional. Number of days to add to startDate. The value must be an integer between -2147483648 and 2147483647.
addHours
String Optional. Number of hours to add to startDate. The value must be an integer between -2147483648 and 2147483647.
addMinutes
String Optional. Number of minutes to add to startDate. The value must be an integer between -2147483648 and 2147483647.
addSeconds
String Optional. Number of seconds to add to startDate. The value must be an integer between -2147483648 and 2147483647.
addMilliSeconds
String Optional. Number of milliseconds to add to startDate. The value must be an integer between -2147483648 and 2147483647.
timezone
String Optional. Time zone in which you want the endDate to be expressed. Specify a time zone code as shown in Time Zones (for example, EST for Eastern Standard Time).
If you do not specify timezone , the value of the server's "user timezone" property is used. If this property has not been set, GMT is used.
locale
String Optional. Locale in which the endDate is to be expressed. For example, if locale is en (for English), the pattern EEE d MMM yyyy will produce Friday 23 August 2002, and the locale of fr (for French) will produce vendredi 23 août 2002.
If locale is not specified, Integration Server uses the value of the watt.server.session.locale.ignore server configuration parameter to determine whether the locale is obtained from the session used by the client that invoked the service or if the locale is the locale of Integration Server.
Output Parameters
endDate
String The end date and time, calculated by incrementing the startDate with the specified years, months, days, hours, minutes, seconds, and/or milliseconds. The endDate will be in the endDatePattern format, if specified.
If no endDatePattern is specified or if blank spaces are specified as the value, the endDate will be returned in the format specified in the startDatePattern parameter.
Usage Notes
The addYears, addMonths, addDays, addHours, addMinutes, addSeconds, and addMilliSeconds input parameters can take positive or negative values. For example, If startDate is 10/10/2001, startDatePattern is MM/dd/yyyy, addYears is 1, and addMonths is -1, endDate will be 09/10/2002.
If you specify only the startDate, startDatePattern, and endDatePattern input parameters and do not specify any of the optional input parameters to increment the period, the pub.date:incrementDate service just converts the format of startDate from startDatePattern to endDatePattern and returns it as endDate.
Integration Server issues an exception if the format of the date specified in the startDate parameter does not match the format specified in the startDatePattern. Integration Server issues a similar exception if the format of the date specified in the endDate parameter does not match the endDatePatternformat.