2.1.3.1.1.19.2.1 Property: DTSTART

RFC Reference: [RFC2445] section 4.8.2.4

Number of Instances Allowed: 1

Format: Date-Time ([RFC2445] section 4.3.5)

Brief Description: The effective start date of this onset of Standard time.

Importing to Calendar objects

If this VTIMEZONE component has no DAYLIGHT sub-component, all the bytes in the stStandardDate field of the PidLidTimeZoneStruct structure MUST be set to 0x00.

If the VTIMEZONE being imported contains one or more DAYLIGHT sub-components and the STANDARD component contains an RRULE property (as specified in section 2.1.3.1.1.19.2.2), the fields of the stStandardDate field of the PidLidTimeZoneStruct structure are set according to the following table.

Field of PidLidTimeZoneStruct.stStandardDate

Value

wYear

Set as specified in section 2.1.3.1.1.19.2.2.

wMonth

Set as specified in section 2.1.3.1.1.19.2.2.

wDayOfWeek

Set as specified in section 2.1.3.1.1.19.2.2.

wDay

Set as specified in section 2.1.3.1.1.19.2.2.

wHour

The hour portion of DTSTART

wMinute

The minute portion of DTSTART

wSecond

The second portion of DTSTART

wMilliseconds

Set to 0x0000

If an RRULE property is not specified for this component, the stStandardDate field of the PidLidTimeZoneStruct structure SHOULD<54> be imported as specified in the following table. Alternatively, implementers MAY<55> convert the value of the RDATE property to a SYSTEMTIME structure (as specified in [MS-DTYP]) and import the resulting value to the stStandardDate field, or MAY<56> convert the value of the DTSTART property to a SYSTEMTIME structure and import the resulting value to the stStandardDate field.

Field of PidLidTimeZoneStruct.stStandardDate

Value

wYear

Set to 0x0000

wMonth

The month portion of DTSTART

wDayOfWeek

The day of the week of the date specified by DTSTART. Possible values are specified later in this section.

wDay

The occurrence of the day of week in the month for the date specified by DTSTART (if this is the 2nd Monday of May, wDay is set to 2). If this is the last occurrence of the day of the week in the month, wDay is set to 0x0005. Possible values are specified later in this section.

wHour

The hour portion of DTSTART

wMinute

The minute portion of DTSTART

wSecond

The second portion of DTSTART

wMilliseconds

Set to 0x0000

The following table lists the possible values of the wDayOfWeek subfield of the stStandardDate field in the PidLidTimeZoneStruct structure.

wDayOfWeek

Meaning

0x0000

Sunday

0x0001

Monday

0x0002

Tuesday

0x0003

Wednesday

0x0004

Thursday

0x0005

Friday

0x0006

Saturday

The following table lists the possible values of the wDay subfield of the stStandardDate field in the PidLidTimeZoneStruct structure.

wDay

Meaning

0x0001

First occurrence of the day of the week

0x0002

Second occurrence of the day of the week

0x0003

Third occurrence of the day of the week

0x0004

Fourth occurrence of the day of the week

0x0005

Last occurrence of the day of the week

Exporting from Calendar objects

This MUST be set to the onset of the Standard portion of the time zone for some year before the first appointment in the iCalendar.<57> This property is specified in the local time of the VTIMEZONE component, but the TZID parameter of this property is omitted.

Show: