Skip to content


Subversion checkout URL

You can clone with
Download ZIP


Spec language for new "limit-day-ordinals-to-day-1" attribute. #23

merged 1 commit into from

3 participants

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
This page is out of date. Refresh to see the latest.
Showing with 19 additions and 3 deletions.
  1. +19 −3 specification.txt
22 specification.txt
@@ -694,9 +694,10 @@ a localized date format:
Localized Options
-There is one localized option, ``punctuation-in-quote`` (see `Locale Options`_).
-This global option (affecting both citations and the bibliography) is set as an
-optional attribute on ``cs:style-options``.
+There are two localized options, ``limit-day-ordinals-to-day-1`` and
+``punctuation-in-quote`` (see `Locale Options`_). These global options (which
+affect both citations and the bibliography) are set as optional attributes on
Rendering Elements
@@ -806,6 +807,11 @@ describes the date part selected with the required ``name`` attribute:
- "numeric" - (default), e.g. "1"
- "numeric-leading-zeros" - e.g. "01"
- "ordinal" - e.g. "1st"
+ Some languages, such as French, only use the "ordinal" form for the first
+ day of the month ("1er janvier", "2 janvier", "3 janvier", etc.). Such
+ output can be achieved with the "ordinal" form and use of the
+ ``limit-day-ordinals-to-day-1`` attribute (see `Locale Options`_).
For "month", ``cs:date-part`` may carry the `strip-periods`_ and ``form``
@@ -2004,6 +2010,16 @@ hierarchical levels, the value set at the lowest level is used.
Locale Options
+ Date formats are defined by the ``cs:date`` element and its ``cs:date-part``
+ child elements (see `Date`_). By default, when the ``cs:date-part`` element
+ with ``name`` set to "day" has ``form`` set to "ordinal", all days (1 through
+ 31) are rendered in the ordinal form, e.g. "January 1st", "January 2nd", etc.
+ By setting ``limit-day-ordinals-to-day-1`` to "true" ("false" is the
+ default), the "ordinal" form is limited to the first day of each month (other
+ days will use the "numeric" form). This is desirable for some languages, such
+ as French: "1er janvier", but "2 janvier", "3 janvier", etc.
For ``cs:text`` elements rendered with the ``quotes`` attribute set to
"true" (see `Formatting`_), and for which the output is followed by a comma
Something went wrong with that request. Please try again.