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.