Altova MapForce 2025 Enterprise Edition

Returns a value of type xs:duration calculated by combining the following parts supplied as arguments: year, month, day, hour, minute, second, millisecond, negative.

 

An example duration is P1Y2M3DT04H05M59S, where:

 

"P" is the period designator, and is mandatory;

The rest of the characters denote, in this order: 1 Year, 2 Months, 3 Days, T (Time designator), 04 Hours, 05 Minutes, 59 Seconds.

 

If the minus character appears before the "P" designator, this indicates a negative duration, for example: -P1D.

mf-func-duration-from-parts

 

Languages

Built-in, C++, C#, Java.

 

Parameters

Name

Type

Description

year

xs:int

Provides the year.

month

xs:int

Provides the month.

day

xs:int

Provides the day of the month.

hour

xs:int

Optional. Provides the hour.

minute

xs:int

Optional. Provides the minute.

second

xs:int

Optional. Provides the second.

millisecond

xs:decimal

Optional. Provides the millisecond.

negative

xs:boolean

Optional. Must be true for a negative duration; false otherwise.

 

Example

The following mapping generates a negative duration of 1 year, 4 months, 17 days, 8 hours, 58 minutes, and 54.333 seconds.

mf-func-duration-from-parts-example

The mapping output is -P1Y4M17DT8H58M54.333S.

© 2018-2024 Altova GmbH