Updating the time zone for items by using the EWS Managed API 2.0

Bind to the existing appointment by using its unique identifier. The following code shows how to bind to an existing appointment, provide it with connection configuration information by using an ExchangeService object named service, and request a specific subset of properties, including the DateTime properties and the time zone properties. The ItemId has been shortened to preserve readability. For the purpose of this example, assume that the service object is scoped to the Pacific Standard Time (PST) time zone.

Appointment appt = Appointment.Bind(service, new ItemId("AAMkA="), new PropertySet(BasePropertySet.IdOnly, AppointmentSchema.Start, AppointmentSchema.ReminderDueBy, AppointmentSchema.End, AppointmentSchema.StartTimeZone, AppointmentSchema.EndTimeZone, AppointmentSchema.TimeZone)); 

Examine the initial value of the Start property and StartTimeZone property. Because the appointment was retrieved by using an ExchangeService object that is scoped to PST, the 7 A.M. start time for this appointment is expressed in PST, even though the appointment's StartTimeZone is EST. For more information about the rules that determine the time zone of DateTime properties when you retrieve items, see Specifying the time zone when retrieving items by using the EWS Managed API 2.0.

Console.WriteLine(appt.Start); // 1/1/2009 7 A.M. (PST)
Console.WriteLine(appt.StartTimeZone); // EST

Update the StartTimeZone property and the EndTimeZone property on the appointment. The following code shows how to set these properties to Central Standard Time (CST).

appt.StartTimeZone = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time");
appt.EndTimeZone = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time");

Save the updated appointment, as shown in the following code.

appt.Update(ConflictResolutionMode.AlwaysOverwrite);

Bind to the updated appointment and examine the value of the Start property and StartTimeZone property, as shown in the following code.

appt.Load(new PropertySet(BasePropertySet.IdOnly, AppointmentSchema.Start, AppointmentSchema.ReminderDueBy, AppointmentSchema.End, AppointmentSchema.StartTimeZone, AppointmentSchema.EndTimeZone, AppointmentSchema.TimeZone));
Console.WriteLine(appt.Start); // 1/1/2009 8 A.M.(PST)
Console.WriteLine(appt.StartTimeZone); // CST

Because the appointment time zone was changed from EST to CST, without updating any of the DateTime properties, the meeting has been moved forward by one hour (the difference between EST and CST), as shown in the following table.

Bind to the existing appointment by using its unique identifier. The following code shows how to bind to an existing appointment, provide it with connection configuration information by using an ExchangeService object named service, and request a specific subset of properties, including the DateTime properties and the time zone properties. The ItemId has been shortened to preserve readability. For the purpose of this example, assume that the service object is scoped to the Pacific Standard Time (PST) time zone.

Appointment appt = Appointment.Bind(service, new ItemId("AAMkA="), new PropertySet(BasePropertySet.IdOnly, AppointmentSchema.Start, AppointmentSchema.ReminderDueBy, AppointmentSchema.End, AppointmentSchema.StartTimeZone, AppointmentSchema.EndTimeZone, AppointmentSchema.TimeZone)); 

Examine the initial value of the Start property and StartTimeZone property. Because the appointment was retrieved by using an ExchangeService object that is scoped to the PST time zone, the 9 A.M. start time for this appointment is expressed in PST, even though the appointment's StartTimeZone is CST. For more information about the rules that determine the time zone of DateTime properties when you retrieve items, see Specifying the time zone when retrieving items by using the EWS Managed API 2.0.

Console.WriteLine(appt.Start); // 1/1/2009 9 A.M. (PST)
Console.WriteLine(appt.StartTimeZone); // CST

Update the StartTimeZone property and the EndTimeZone property on the appointment. The following code shows how to set these properties both to Eastern Standard Time (EST).

appt.StartTimeZone = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
appt.EndTimeZone = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");

Because the appointment is being moved from the CST time zone to the EST time zone, you must also update the Start, End, and ReminderDueBy properties, if you want the appointment to occur at the same time before and after the update. The following code shows how to increment each of these times by one hour (the time difference between CST and EST).

appt.Start = appt.Start.AddHours(1);
appt.ReminderDueBy = appt.ReminderDueBy.AddHours(1);
appt.End = appt.End.AddHours(1);

Save the updated appointment, as shown in the following code.

appt.Update(ConflictResolutionMode.AlwaysOverwrite);

Bind to the updated appointment and examine the value of the Start property and StartTimeZone property, as shown in the following code.

appt.Load(new PropertySet(BasePropertySet.IdOnly, AppointmentSchema.Start, AppointmentSchema.ReminderDueBy, AppointmentSchema.End, AppointmentSchema.StartTimeZone, AppointmentSchema.EndTimeZone, AppointmentSchema.TimeZone));
Console.WriteLine(appt.Start); // 1/1/2009 9 A.M.(PST)
Console.WriteLine(appt.StartTimeZone); // EST

Because the appointment time zone was changed from EST to CST, and each DateTime property was adjusted by one hour (the time difference between CST and EST), the meeting time is unchanged, as shown in the following table.