Schema Central > XML Schema 1.1 > xsd:dayTimeDuration
Advanced search
Need XML Help?

Recommended Reading:

Definitive XML Schema

 

Web Service Contract Design and Versioning for SOA

 

Advanced XML Applications

 

xsd:dayTimeDuration

The type xsd:dayTimeDuration represents a duration of time expressed as a number of days, hours, minutes, and seconds. The format of xsd:dayTimeDuration is PnDTnHnMnS, where P is a literal value that starts the expression, nD is the number of days followed by a literal D, T is a literal value that separates the date and time, nH is the number of hours followed by a literal H, nM is the number of minutes followed by a literal M, and nS is the number of seconds followed by a literal S. The following rules apply to xsd:dayTimeDuration values:

  • Any of these numbers and corresponding designators may be absent if they are equal to 0, but at least one number and designator must appear.

  • The numbers may be any unsigned integer, with the exception of the number of seconds, which may be an unsigned decimal number.

  • If a decimal point appears in the number of seconds, there must be at least one digit after the decimal point.

  • A minus sign may appear before the P to specify a negative duration.

  • If no time items (hour, minute, second) are present, the letter T must not appear.

Simple Type Information

Namespace: http://www.w3.org/2001/XMLSchema

Schema Document: builtintypes.xsd

Content

Examples

Valid valuesComment
P1DT2H1 day, 2 hours
PT20M20 minutes
PT120M120 minutes (the number of months can be more than 60)
P0DT1H1 hour (0 is permitted as a number, but is not required)
P0D0 days
-P60Dminus 60 days
PT1M30.5S1 minute, 30.5 seconds
Invalid valuesComment
P2Y6M5DT12H35M30Syear and month components are not allowed
P-20Dthe minus sign must appear first
P20DTno time items are present, so "T" must not be present
PT1HM3Sno value is specified for minutes, so "M" must not be present
P15.5Donly the seconds can be expressed as a decimal
P1D2H"T" must be present to separate days and hours
1DT2H"P" must always be present
PT15M5Hhours must appear before minutes
Pat least one number and designator are required
PT15.Sat least one digit must follow the decimal point if it appears
an empty value is not valid, unless xsi:nil is used

Type Inheritance Chain

Site developed and hosted by Datypic, Inc.

Please report errors or comments about this site to pwalmsley@datypic.com