system.date.add*
This function is a set of functions to add and subtract time 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. |
system.date. add*( date, value )
-
Parameters
Date date- The starting date.
Int 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
All
#This example would add two days to the date passed in.
today
=
system.date.now()
twoDaysFromToday
=
system.date.addDays(today,
2
)
#This example would subtract twenty 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(
2018
,
4
,
28
)
#This would print out like Mon May 28 00:00:00 PDT 2018
print
system.date.addMinutes(date,
-
20
)
#This will print Sun May 27 23:40:00 PDT 2018
#This example can be placed on the property change script of one 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
)