set aDateTime = aDurationString.convertDurationToDateTime()
set aDateTime = convertDurationToDateTime(LITERAL)
Semantics
Converts a string having the XML Schema 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 of PnYnMnDTnHnMnS. The capital letters are delimiters and can be omitted when the corresponding member is not used.
Substitutables
aString
Can be any variable or object attribute having the type String. The format must correspond to the XML Schema Duration format.
LITERAL
String literal. The format must correspond to the XML Schema Duration format.
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. You can find a xUML example of how to apply durations in section Arithmetic Operations.
set aDateTime = convertDurationToDateTime ("P2D");
Valid Sample Values
PT1004199059S
PT130S
PT2M10S
P1DT2S
-P1Y
P1Y2M3DT5H20M30.123S
Invalid Sample Values
1Y (leading "P" is missing)
P1S ("T" separator is missing)
P-1Y (all parts must be positive)
P1Y-1M (all parts must be positive)
P1M2Y (parts order is significant and Y must precede M)