yearLong (Date Block - Long Year Format)

This element specifies the presence of a date block at the current location in the run content. A date block is a non-editable region of text which shall display the current date filtered through the specified date picture (see following paragraphs). [Note: The date block is a legacy construct used for compatibility with older word processors, and should not be produced unless it was consumed while reading a document – it is recommended that the DATE field is used in its place. end note]

A date block shall be displayed using the primary editing language of the host application, regardless of the languages specified in the parent run’s lang property (§2.3.2.18).

The long year format date block shall use a date picture of YYYY, retrieving the long year format for the primary editing language.

[Example: Consider a WordprocessingML run with the following run content:

<w:r>
<w:t xml:space="preserve">This is a long date: </w:t>
<w:yearLong />
</w:r>

This run specifies that a long year format date block shall be placed after the text string literal This is a long date: in the document. Assuming that the host application’s primary editing language is English (Canada) and today’s date is 04/12/2006 (a Wednesday), this run would be displayed as follows:

This is a long date: 2006

end example]

Parent Elements

r (§7.1.2.87); r (§2.3.2.23)

The following XML Schema fragment defines the contents of this element: