Calendar class

Office 2013 and later

Date Picker Calendar Type. When the object is serialized out as xml, its qualified name is w:calendar.

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

public class Calendar : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

calendar (Date Picker Calendar Type)

This element specifies the calendar which shall be displayed for the current date picker structured document tag, if a user interface is present for the structured document tag. The calendar information is stored on this element's val attribute.

If this element is omitted, then the calendar shall be gregorian.

[Example: Consider the following structured document tag properties:

  <w:date w:fullDate="2006-01-01T06:30:00Z">
    <w:calendar w:val="gregorian"/>

The calendar element specifies that the calendar information for a calendar which might be displayed in the document must be the Gregorian calendar format (gregorian). end example]

Parent Elements

date (§



val (Calendar Type Value)

Specifies a type of calendar, the use of which is determined by the parent XML element.

If this attribute is omitted, then the calendar type shall be gregorian.

[Example: Consider the following WordprocessingML for a document containing a structured document tag:

  <w:date … >
    <w:calendar w:val="japan"/>

The val attribute value of japan specifies that the Japanese Emperor Era calendar must be used; in this case, it is used for the calendar displayed for a date structured document tag. end example]

The possible values for this attribute are defined by the ST_CalendarType simple type (§

[Note: The W3C XML Schema definition of this element’s content model (CT_CalendarType) is located in §A.1. end note]

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.