2.1.3.1.1.8 Property: X-MICROSOFT-CALSCALE

RFC Reference: N/A

Number of Instances Allowed: 0,1

Format: Text ([RFC2445] section 4.3.11)

Brief Description: Identifies the calendar type of a non-Gregorian recurring appointment.

Importing to Calendar objects

If this property is specified, then it SHOULD<13> be imported for every VEVENT that declares an X-MICROSOFT-RRULE.

This property SHOULD<14> set the CalendarType field of the RecurrencePattern field of the AppointmentRecurrencePattern structure ([MS-OXOCAL] section 2.2.1.44.5) in the PidLidAppointmentRecur property ([MS-OXOCAL] section 2.2.1.44). See also sections 2.1.3.2.2.1, 2.1.3.2.2.2, 2.1.3.2.2.3, 2.1.3.2.2.4, 2.1.3.2.2.5, and 2.1.3.2.2.6.

X-MICROSOFT-CALSCALE Value

CalendarType

Not present or empty string (default)

0x0000

Gregorian

0x0001

Gregorian_us

0x0002

Japan

0x0003

Taiwan

0x0004

Korea

0x0005

Hijri

Either 0x0000 or 0x0006, as specified in the table for Hijri calendars that follows (the PatternType field SHOULD<15> also be overwritten as specified in the table for Hijri calendars that follows).

Thai

0x0007

Hebrew

0x0008

GregorianMeFrench

0x0009

GregorianArabic

0x000A

GregorianXlitEnglish

0x000B

GregorianXlitFrench

0x000C

JapanLunar

0x000E

ChineseLunar

0x000F

Saka

0x0010

LunarEtoChn

0x0011

LunarEtoKor

0x0012

LunarRokuyou

0x0013

KoreaLunar

0x0014

Umalqura

0x0017

For appointments with an X-MICROSOFT-CALSCALE value of "Hijri", the value for PatternType (as specified in [MS-OXOCAL] section 2.2.1.44.1) and CalendarType depend upon the imported value of PatternType. PatternType SHOULD be determined as specified in section 2.1.3.2.2. The resulting value SHOULD then be overwritten as specified in the following table.

Imported PatternType Value

Hijri PatternType Value

Hijri CalendarType Value

0x0000

0x0000

0x0006

0x0001

0x0001

0x0006

0x0002

0x000A

0x0000

0x0003

0x000B

0x0000

Exporting from Calendar objects

Since this property is a child of the VCALENDAR, a VCALENDAR MUST NOT contain any two VEVENTs that would result in different values of X-MICROSOFT-CALSCALE.

If the CalendarType field of the RecurrencePattern field of the AppointmentRecurrencePattern structure is nonzero, then this property SHOULD<16> be exported as specified in the following table.

CalendarType Value

X-MICROSOFT-CALSCALE Value

0x0001

Gregorian

0x0002

Gregorian_us

0x0003

Japan

0x0004

Taiwan

0x0005

Korea

0x0006

Hijri

0x0007

Thai

0x0008

Hebrew

0x0009

GregorianMeFrench

0x000A

GregorianArabic

0x000B

GregorianXlitEnglish

0x000C

GregorianXlitFrench

0x000E

JapanLunar

0x000F

ChineseLunar

0x0010

Saka

0x0011

LunarEtoChn

0x0012

LunarEtoKor

0x0013

LunarRokuyou

0x0014

KoreaLunar

0x0017

Umalqura

Additionally, for certain values of the PatternType field of the RecurrencePattern field of the AppointmentRecurrencePattern structure, this property SHOULD<17> be exported as specified in the following table.

Special PatternType Value

X-MICROSOFT-CALSCALE Value

0x000A

Hijri

0x000B

Hijri