convertDurationToDateTime

Converts a string having the XML Schema Duration (http://www.w3.org/TR/xmlschema-2/#duration) format into a DateTime object.

Duration  may be expressed using all the parts of a DateTime type (from year to fractions of a second) and are, therefore, defined as a "six-dimensional space". As the relation between some of the date parts is not fixed (such as the number of days in a month), the order relationship between durations is only partial and the result of a comparison between two durations may be undetermined.
The lexical space of xsd:duration is the format defined by ISO 8601 under the form "PnYnMnDTnHnMnS". The capital letters are delimiters and can be omitted when the corresponding member is not used.

Example:
Valid values include "PT1004199059S", "PT130S", "PT2M10S", "P1DT2S", "-P1Y", or "P1Y2M3DT5H20M30.123S".
The following values would be invalid: "1Y" (leading "P" is missing), "P1S" ("T" separator is missing), "P-1Y" (all parts must be positive), "P1M2Y" (parts order is significant and Y must precede M), or "P1Y-1M" (all parts must be positive).

This example generates a DateTime object that corresponds to the duration of two days. This object can then be used to do time  arithmetic, that is, adding and subtracting durations from dates.
A UML example of how to apply durations can be found in section Arithmetic Operations.

set aDateTime = convertDurationToDateTime ("P2D");