xs:gYear

Construct a gYear value from an item value.

Top of page

Related Syntax Constructs

The following construct(s) refer to this construct:


Syntax

xs:gYear(item $value) => gYear

Description

This is a constructor function that takes an item value as argument and returns a value of type xs:gYear. If the argument is a literal, then the literal must be a valid lexical form of its type.

As specified in the respective section of the W3C recommendation XML Schema Part 2: Datatypes, a value of type xs:gYear represents a whole Gregorian year as defined in ISO 8601. The lexical form is CCYY, where "CC" represents the century and "YY" represents the year. You can use more digits in order to represent years outside the range 0000-9999, and you can also prepend a minus sign. You can also append an optional time zone identifier.

Argument

$value

item value

Example

  • This query generates valid values of type xs:gYear:

    xs:gYear("1999")
    xs:gYear("-0000")
    xs:gYear("12403Z")