Skip to end of metadata
Go to start of metadata

This function is used in Python Scripting.

Description

This function is a set of functions to add and subtract time that include:

FunctionDescription
system.date.addMillisAdd or subtract an amount of milliseconds to a given date and time.
system.date.addSecondsAdd or subtract an amount of seconds to a given date and time.
system.date.addMinutesAdd or subtract an amount of minutes to a given date and time.
system.date.addHoursAdd or subtract an amount of hours to a given date and time.
system.date.addDaysAdd or subtract an amount of days to a given date and time.
system.date.addWeeksAdd or subtract an amount of weeks to a given date and time.
system.date.addMonthsAdd 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.addYearsAdd 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

Date dateThe 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
Code Snippet
# This example would add two days to the date passed in.
 
today = system.date.now()
twoDaysFromToday = system.date.addDays(today, 2)
Code Snippet
# 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 Mon May 25 00:00:00 PDT 2020
print system.date.addMinutes(date, -20) # This will print Sun May 24 23:40:00 PDT 2020
Code Snippet
# 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 advanced of the first calendars selected date.
if event.propertyName == "date":
	date = event.newValue
	event.source.parent.getComponent('End Date Calendar').date = system.date.addWeeks(date, 2)

Keywords

system date add*, date.add*, date addMillis, date.addMillis, date addSeconds, date.addSeconds, date addMinutes, date.addMinutes, date addHours, date.addHours, date addDays, date.addDays, date addWeeks, date.addWeeks, date addMonths,  date.addMonths, date addYears, date.addYears