Export (0) Print
Expand All

2.1.3.2.2.1 Template: Daily Recurrences

ABNF Description

daily-template= "FREQ=DAILY" [common-parts] 

Template Examples

Every day:

FREQ=DAILY

Every day at 3:30 P.M.:

FREQ=DAILY;BYMINUTE=30;BYHOUR=15

Every 3 days:

FREQ=DAILY;INTERVAL=3

Every 3 days at 3:30 P.M.:

FREQ=DAILY;INTERVAL=3;BYMINUTE=30;BYHOUR=15

Every 3 days at 3:30 P.M. for 30 instances:

FREQ=DAILY;INTERVAL=3;BYMINUTE=30;BYHOUR=15;COUNT=30

Importing to Calendar objects

An RRULE or X-MICROSOFT-RRULE matching this template SHOULD<272> be imported into PidLidAppointmentRecur as specified in the following table. A VEVENT MUST NOT specify both an RRULE and an X-MICROSOFT-RRULE.

AppointmentRecurrencePattern Field

Value

ReaderVersion

Set to 0x3004

WriterVersion

Set to 0x3004

RecurFrequency

Set to 0x200A

PatternType

Set to 0x0000. Can be overridden by X-MICROSOFT-CALSCALE, see section 2.1.3.1.1.8.

CalendarType

Imported from X-MICROSOFT-CALSCALE (see section 2.1.3.1.1.8).

FirstDateTime

Set as specified in [MS-OXOCAL] section 2.2.1.44.1.

Period

Set to (1440 * INTERVAL)

SlidingFlag

Set to 0x00000000

PatternTypeSpecific.Week.Sa-Su

(unset)

PatternTypeSpecific.Month.Day

(unset)

PatternTypeSpecific.MonthNth.Sa-Su

(unset)

PatternTypeSpecific.MonthNth.N

(unset)

EndType

If the recurrence is infinite, set EndType to 0x00002023. If the recurrence is specified with a COUNT, set EndType to 0x00002022. Otherwise, set EndType to 0x00002021.

OccurrenceCount

Set to the number of occurrences of the recurrence based on UNTIL or COUNT. If the recurrence is infinite, set OccurrenceCount to 0x0000000A.

FirstDOW

Set to the correct value based on WKST (see the following table for how to map WKST values to FirstDOW values)

DeletedInstanceCount / DeletedInstanceDates

See section 2.1.3.1.1.20.13

ModifiedInstanceCount / ModifiedInstanceDates

See section 2.1.3.1.1.20.18

StartDate

Set to the date portion of DTSTART, in the time zone specified by PidLidTimeZoneStruct. This date is stored in minutes after midnight January 1, 1601. Note that this value MUST always be evenly divisible by 1440.

EndDate

Set to the start date of the last instance of a recurrence, in the time zone specified by PidLidTimeZoneStruct. This date is stored in minutes after midnight January 1, 1601. If the recurrence is infinite, set EndDate to 0x5AE980DF. Note that this value MUST always be evenly divisible by 1440, except for the special value 0x5AE980DF.

ReaderVersion2

Set to 0x00003006

WriterVersion2

Set to 0x00003009

StartTimeOffset

Set to (60*BYHOUR + BYMINUTE)

EndTimeOffset

Set to (StartTimeOffset + PidLidAppointmentDuration)

ExceptionCount / ExceptionInfo

See section 2.1.3.1.1.20.18

(ReservedBlocks and ExtendedExceptions)

Refer to [MS-OXOCAL]

The following table specifies how to map WKST values to FirstDOW values.

WKST Value

FirstDOW Value

SU

0x00000000

MO

0x00000001

TU

0x00000002

WE

0x00000003

TH

0x00000004

FR

0x00000005

SA

0x00000006

Exporting From Calendar objects

The AppointmentRecurrencePattern structure ([MS-OXOCAL] section 2.2.1.44.5) in the PidLidAppointmentRecur property ([MS-OXOCAL] section 2.2.1.44) SHOULD<273> be exported as the property specified in the following table. If a case matches more than one row, the first matching row applies.

CalendarType field

PatternType field

Recurrence property

0x0000

0x0000

RRULE

0x0000

0x0001

RRULE

0x0000

0x0002

RRULE

0x0000

0x0003

RRULE

0x0000

0x000A

X-MICROSOFT-RRULE

0x0000

0x000B

X-MICROSOFT-RRULE

(any)

0x0000

RRULE<274>

(any)

0x0001

RRULE<275>

0x0001

(any)

RRULE

0x0002

(any)

RRULE

0x0003

(any)

RRULE

0x0004

(any)

RRULE

0x0005

(any)

RRULE

0x0006

(any)

X-MICROSOFT-RRULE

0x0007

(any)

RRULE

0x0008

(any)

X-MICROSOFT-RRULE

0x0009

(any)

RRULE

0x000A

(any)

RRULE

0x000B

(any)

RRULE

0x000C

(any)

RRULE

0x000E

(any)

X-MICROSOFT-RRULE

0x000F

(any)

X-MICROSOFT-RRULE

0x0010

(any)

X-MICROSOFT-RRULE

0x0011

(any)

X-MICROSOFT-RRULE

0x0012

(any)

X-MICROSOFT-RRULE

0x0013

(any)

X-MICROSOFT-RRULE

0x0014

(any)

X-MICROSOFT-RRULE

0x0017

(any)

X-MICROSOFT-RRULE

The exported property MUST be assigned the value generated by the recurrence template specified in the following table.

PatternType field

Period field

Recurrence template

0x0000

(any)

Daily Recurrence (section 2.1.3.2.2.1)

0x0001

(any)

Weekly Recurrence (section 2.1.3.2.2.2)

0x0002

(not evenly divisible by 12)

Monthly Recurrence (section 2.1.3.2.2.3)

0x0002

(evenly divisible by 12)

Yearly Recurrence (section 2.1.3.2.2.5)

0x0003

(not evenly divisible by 12)

Monthly Nth Recurrence (section 2.1.3.2.2.4)

0x0003

(evenly divisible by 12)

Yearly Nth Recurrence (section 2.1.3.2.2.6)

0x000A

(not evenly divisible by 12)

Monthly Recurrence (section 2.1.3.2.2.3)

0x000A

(evenly divisible by 12)

Yearly Recurrence (section 2.1.3.2.2.5)

0x000B

(not evenly divisible by 12)

Monthly Nth Recurrence (section 2.1.3.2.2.4)

0x000B

(evenly divisible by 12)

Yearly Nth Recurrence (section 2.1.3.2.2.6)

If PidLidAppointmentRecur is being exported with the Daily Recurrence template, it MUST contain the recurrence parts specified in the following table.

Recurrence Part

Value

FREQ

Set to 'DAILY'

INTERVAL

Set to (Period / 1440). If the value is 1, omit this recurrence part.

COUNT

If EndType is 0x00002022, set to OccurrenceCount. Otherwise, omit this recurrence part.

UNTIL

If EndType is 0x00002021, SHOULD<276> be set to (EndDate + StartTimeOffset), converted from the time zone specified by PidLidTimeZoneStruct to the UTC time zone. Alternatively, MAY<277> be set to midnight on the date specified by EndDate. If EndType is not 0x00002021, omit this recurrence part.

WKST

The WKST recurrence part SHOULD<278> be omitted.

Show:
© 2014 Microsoft