Operator Type:
Operator Scope of Action:
Operator Purpose:
Operator Data Type Returned:
Operator First Added:
Operator in Current Baseline:
Operator Altered Since Baseline:
Operator Has Newer Dot-Operator Variant:
Function [other Function type actions]
Item [operators of similar scope]
Date-time [other Date-time operators]
Date [about Date data type]
v5.7.0
Baseline
As at baseline
Yes
minute(aDate, minutesNum)
creates a new date based on the aDate action code expression, but in which the minute is minutesNum. The source Date is not changed unless aDate is an attribute and the attribute is re-setting itself:
$MyDateA = minute($MyDate,14); $MyDate is not changed
$MyDate = minute($MyDate,14); $MyDate is changed
Examples. If $MyDate is 4 July 2009 09:30, then
$MyDateA=minute($MyDate,5);
will change $MyDate to 4 July 2009 19:05 whilst leaving $MyDate as 4 July 2009 09:30. However, if the code is self-referring:
$MyDate=minute($MyDate,5);
will change $MyDate to 4 July 2009 19:05.
Take care using the later self-referring form in a $Rule or agent as it fires every agent update cycle adding 5 minutes each time! Make sure you use a guard agent or conditional query to make the action out of scope after the first application. Or, consider using a Stamp, which only fires once per (manual) application.
The single-argument method that reads the minutes value is documented separately: see minute(Date).
See also—notes linking to here: