+-------------------------------IBM Extension--------------------------------+
The SUBTRACT-DURATION function subtracts a duration from a date, time, or timestamp item, and returns the modified item.
The function type is date-time.
The length of the return value depends on the length of the date, time, or timestamp item specified in argument-1.
If a duration is subtracted from a date item, the date returned must fall within a certain range:
If a duration is subtracted from a 2-digit date item, the range is the same as for a 4-digit year, but the year in the value returned is truncated to 2 digits.
Format
>>-FUNCTION SUBTRACT-DURATION----------------------------------->
.------------------------.
V |
>--(--argument-1----argument-2--argument-3-+--)----------------><
Argument-1 is the value from which a duration is subtracted. The duration is specified in argument-2 and argument-3.
The duration keyword or conversion specifier used must be consistent with argument-1. For example, the duration keywords must obey the following rules:
Argument-2 and argument-3 can be repeated. There should be no duplicate argument-2 in one intrinsic function.
Argument-3 can be a negative integer, but the function only takes its absolute value. If argument-3 is longer than 9 digits, it is truncated.
If a duration is subtracted from a date, and the result is invalid, the date is adjusted. For example, if a duration of 1 month is subtracted from the date May 31, 1997, the result would be the invalid date April 31, 1997. This date would be adjusted to the valid date April 30, 1997.
Related Information
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.