ADDMINUTES
The ADDMINUTES function returns a time value that is the result of adding a specified number of minutes to a given time.
- Syntax:
- ADDMINUTES (single-datetime-item-expression, minutes-expressed-as-signed-integer-expression)
- Meaning:
- ADDMINUTES (any_datetime, number_of_minutes_to_add)
- Returns:
- A single datetime item
The ADDMINUTES function returns a single datetime item, advanced from the original value of the single-datetime-item-expression by the specified number of minutes-expressed-as-signed-integer-expression.
Examples
ADDMINUTES(TODATETIME("Dec 31, 1999 23:59:00"), 2)
Returns: Jan 1, 2000 00:01:00
ADDMINUTES(TODATETIME("Dec 31, 1999 23:59:00"), -25)
Returns: Dec 31, 1999 23:34:00
ADDMINUTES(TODATETIME("23:59:00"), 2)
Returns: 00:01:00
If either argument is invalid, the result is "none". If the second argument is "none", the result is the first argument. If the first argument contains only a time portion, date changes are ignored. If the first argument contains only a date portion, the time portion 00:00:00 will be used in the calculation. If both arguments are "none", the result is "none".
Related Functions
- DATETONUMBER
- NUMBERTODATE
- TEXTTODATE
- TODATETIME