Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WBRIDGE and version 20.1b
Div
Classe2e-refDiv
Rp
Rde
Syntax
Code Block
languagenone
set aDateTime = aDurationString.convertDurationToDateTime()
set aDateTime = convertDurationToDateTime(LITERAL)
Semantics

Converts a string having the XML Schema Duration

(http://www.w3.org/TR/xmlschema-2/#duration)

format into a DateTime object.

Duration

Anchor5_e2e_action_language_5_10_strin_23825_e2e_action_language_5_10_strin_2382 may

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.

Example:

Valid
values include "PT1004199059S", "PT130S", "PT2M10S", "P1DT2S", "-P1Y", or "P1Y2M3DT5H20M30.123S".
The following values would be invalid: "1Y"
Values
  • PT1004199059S
  • PT130S
  • PT2M10S
  • P1DT2S
  • -P1Y
  • P1Y2M3DT5H20M30.123S
Invalid 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
), or "P1Y-1M" (all parts must be positive
  • )
.
SubstitutablesaString 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.
Error CodesFind the related error codes on System Errors of type conversion operations.
Examples

This example generates a DateTime object that corresponds to the duration of two days. This object can then be used to do time

Anchor5_e2e_action_language_5_10_strin_83355_e2e_action_language_5_10_strin_8335 arithmetic

arithmetic, that is, adding and subtracting durations from dates.

A UML

You can find a xUML example of how to apply durations

can be found

in section Arithmetic Operations.

Code Block
languagenone
set aDateTime = convertDurationToDateTime ("P2D");