OptionsBehavior.ClientTimeZoneId Property

Gets or sets the identifier of the time zone used by the SchedulerControl.

Namespace: DevExpress.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v14.2.dll

Declaration

C#

[TypeConverter(typeof(TimeZoneIdTypeConverter))]
public string ClientTimeZoneId { get; set; }

VB.NET

<TypeConverter(GetType(TimeZoneIdTypeConverter))>
Public Property ClientTimeZoneId As String

Property Value

Type	Description
String	A string that uniquely identifies a particular time zone and corresponds to the System.TimeZoneInfo.Id property value.

Property Paths

You can access the OptionsBehavior.ClientTimeZoneId property from the following objects:

Object Type	Path to ClientTimeZoneId
SchedulerControl	.OptionsBehavior.ClientTimeZoneId

Remarks

This property enables you to set the SchedulerControl's time zone irrespective of the host time zone settings. The scheduler uses string identifiers for time zones defined on a local system. Time zones in .NET are represented by a TimeZoneInfo class. Time zones in the Windows system can be enumerated and obtained as described in the corresponding MSDN articles. See the Finding the Time Zones Defined on a Local System article for more information.

To specify whether the Time Ruler time zone settings are synchronized with the SchedulerControl's settings, set the TimeRuler.UseClientTimeZone property to true.

The AppointmentStorage.DateSaving property specifies how the Appointment.Start and Appointment.End values are saved in the database. Save them as UTC, by setting the DateSaving property to DateSavingType.UTC and use the ClientTimeZoneId property to display appointments according to the current time zone.

Examples

This example demonstrates how to specify basic characteristics of the SchedulerControl using the SchedulerControl.OptionsBehavior property.

XAML

<dxsch:SchedulerControl.OptionsBehavior>
    <dxsch:OptionsBehavior ClientTimeZoneId="Central Pacific Standard Time" 
                           RecurrentAppointmentDeleteAction="Ask" 
                           RecurrentAppointmentEditAction="Occurrence"
                           RemindersFormDefaultAction="DismissAll"
                           ShowRemindersForm="True" 
                           SelectOnRightClick="True"/>
</dxsch:SchedulerControl.OptionsBehavior>