XML Schema Date/Time data type

XSD Date and Time data type

The XSD date and time data type defines the date and time in the document.

---

The date and time data type is used to contain the value of the date and time.

---

Date Data Type

The date data type is used to define the date.

Dates are defined in this format: "YYYY-MM-DD", where:

• YYYY represents the year
• MM represents the month
• DD represents the number of days

Note: All ingredients are required

Here's an example of a date declaration in schema:

The elements in the document should look something like this:

Time

To specify a time zone, you can also enter a date using UTC time by adding a "Z" after the date - for example:

Alternatively, you can specify an offset based on the world adjustment time by adding a positive or negative time after the date - for example:

Tip: When using xs:date() to cast a string as a date type, the format of string parameters needs to be strictly followed: yyyy-mm-dd.

---

h2; Time Data Type

The time data type is used to define the time.

Time is defined in the following format: "hh:mm:ss", where

• hh indicates the hour
• mm indicates minutes
• ss represents seconds

Note: All ingredients are required!

Here's an example of a time statement in schema:

The elements in the document should look something like this:

Or something like this:

Time

To specify a time zone, you can also enter a time using UTC time by adding a "Z" after the time - for example:

Alternatively, you can specify an offset based on the world adjustment time by adding a positive or negative time after time - for example:

---

DateTime Data Type

The date-time data type is used to define the date and time.

Date time is defined in the following format: "YYYY-MM-DDThh:mm:ss", where:

• YYYY represents the year
• MM represents the month
• DD represents the day
• T represents the start of the required time section
• hh indicates the hour
• mm indicates minutes
• ss represents seconds

Note: All ingredients are required!

Here's an example of a date-time declaration in schema:

The elements in the document should look something like this:

Or something like this:

Time

To specify a time zone, you can also enter a date time using UTC time by adding a "Z" after the date time - for example:

Alternatively, you can specify an offset based on the world adjustment time by adding a positive or negative time after time - for example:

---

h2; Duration Data Type

The duration data type is used to specify the interval.

The interval is specified in the following format: "PnYnMnDTnHnMnS", where:

• P indicates period (required)
• nY represents the number of years
• nM represents the number of months
• nD represents the number of days
• T represents the beginning of the time section (this option is required if you plan to specify hours, minutes, and seconds)
• nH represents the number of hours
• nM represents the number of minutes
• nS represents the number of seconds

Here's an example of a duration declaration in schema:

The elements in the document should look something like this:

The example above represents a 5-year cycle.

Or something like this:

The example above represents a 5-year, 2-month, and 10-day cycle.

Or something like this:

The example above represents a 5-year, 2-month, 10-day, and 15-hour cycle.

Or something like this:

The example above represents a 15-hour cycle.

Negative duration

To specify a negative duration, enter a minus sign before P:

The example above represents a period of minus 10 days.

---

The date and time data type

Name	Describe
date	Define a date value
Datetime	Define a date and time value
duration	Define an interval
gDay	Define a part of the date - days (DD)
gMonth	Define a part of the date - month (MM)
gMonthDay	Define a part of the date - month and day (MM-DD)
gYear	Define a part of the date - Year (YYYY)
gYearMonth	Define a part of the date - year and month (YYYY-MM)
time	Define a time value

---

Limiting date data types

Qualifications that can be used with date data types:

• enumeration
• maxExclusive
• maxInclusive
• minExclusive
• minInclusive
• pattern
• whiteSpace

The above is about the XML Schema Date/Time data type.