XQuery

xs:time

The primitive type xs:time represents a specific time of day. The lexical representation of xs:time is hh:mm:ss.sss where hh is the hour, mm is the minutes, and ss.sss is the seconds. XQuery implementations are required to support at least three fractional digits for the number of seconds, but may support more. To represent P.M. values, the hours 13 through 24 should be used. Either of the values 00:00:00 or 24:00:00 can be used to represent midnight. These values are considered identical, which means that 24:00:00 is considered less than 23:59:59. A time zone can be added to the end, as described in "Time Zones" in Chapter 19.

Values of type xs:dateTime can be cast to xs:time, but the reverse is not true. This is described further in the section on xs:dateTime. You can obtain the current time using the current-time function, which returns a value of type xs:time.

Table B-20 lists some values of the xs:time type. For more information on working with times, see Chapter 19.

Table B-20. Values of the xs:time type

Values	Explanation
Valid
15:30:00	3:30 P.M.
15:30:34.67	3:30 P.M. and 34.67 seconds.
15:30:00-08:00	3:30 P.M., U.S. Pacific Time
15:30:00Z	3:30 P.M., Coordinated Universal Time (UTC)
00:00:00	Midnight
24:00:00	Midnight (equal to the previous example)
Invalid
3:40:00	All numbers must be two digits each
15:30	Seconds must be specified
15:70:00	It must be a valid time of day
	An empty value or zero-length string is not permitted