EXSLT - date:format-date - Version 1

The date:format-date function formats a date/time according to a pattern.

The first argument to date:format-date specifies the date/time to be formatted. It must be right or left-truncated date/time strings in one of the formats defined in [XML Schema Part 2: Datatypes]. The permitted formats are as follows:

• xs:dateTime (CCYY-MM-DDThh:mm:ss)
• xs:date (CCYY-MM-DD)
• xs:time (hh:mm:ss)
• xs:gYearMonth (CCYY-MM)
• xs:gYear (CCYY)
• xs:gMonthDay (--MM-DD)
• xs:gMonth (--MM--)
• xs:gDay (---DD)

The second argument is a string that gives the format pattern used to format the date. The format pattern is interpreted according to the date format (declared by date:date-format) named by the third argument, or the default date format if there is no third argument. For details about how the format pattern is constructed and used, see date:date-format).

If the date/time format is right-truncated (i.e. in a format other than xs:time, or xs:dateTime) then any missing components are assumed to be as follows: if no month is specified, it is given a month of 01; if no day is specified, it is given a day of 01; if no time is specified, it is given a time of 00:00:00.

If the date/time format is left-truncated (i.e. xs:time, xs:gMonthDay, xs:gMonth or xs:gDay) and the format pattern has a token that uses a component that is missing from the date/time format used, then that token is replaced with an empty string ('') within the result.