system.date.add*

This function is used in Python Scripting.

Description

This function is a set of functions that include:

Function	Description
system.date.addMillis	Add or subtract an amount of milliseconds to a given date and time.
system.date.addSeconds	Add or subtract an amount of seconds to a given date and time.
system.date.addMinutes	Add or subtract an amount of minutes to a given date and time.
system.date.addHours	Add or subtract an amount of hours to a given date and time.
system.date.addDays	Add or subtract an amount of days to a given date and time.
system.date.addWeeks	Add or subtract an amount of weeks to a given date and time.
system.date.addMonths	Add or subtract an amount of months to a given date and time. This function is unique since each month can have a variable number of days. For example, if the date passed in is March 31st, and we add one month, April does not have a 31st day, so the returned date will be the proper number of months rounded down to the closest available day, in this case April 30th.
system.date.addYears	Add or subtract an amount of years to a given date and time.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.date.add*(date, value)

Parameters

Type	Parameter	Description
Date	date	The starting date.
Integer	value	The number of units to add, or subtract if the value is negative.

Returns

Date - A new date object offset by the integer passed to the function.

Scope

Gateway, Vision Client, Perspective Session

Code Examples

Example #1

# This example would add two days to the date passed in.
  
today = system.date.now()
twoDaysFromToday = system.date.addDays(today, 2)

Example #2

# This example would subtract 20 minutes from a date object we create.
# Even though our original date starts on the 28th, it starts at midnight,
# so subtracting 20 minutes puts it at the previous day.
  
date = system.date.getDate(2020, 5, 25) # This would print out like Thu Jun 25 00:00:00 PDT 2020
print system.date.addMinutes(date, -20) # This will print Wed Jun 24 23:40:00 PDT 2020

Example #3

# This example can be placed on the property change script of one Vision Calendar component.
# It will then automatically set a second calendar component two weeks in advance of the first calendar's selected date.
if event.propertyName == "date":
    date = event.newValue
    event.source.parent.getComponent('End Date Calendar').date = system.date.addWeeks(date, 2)