SchedulerOptionsBehaviorBase.ClientTimeZoneId Property

Gets or sets the client time zone of the Scheduler.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v20.2.Core.Desktop.dll

NuGet Packages: DevExpress.Scheduler.CoreDesktop, DevExpress.WindowsDesktop.Scheduler.CoreDesktop

Declaration

C#

public string ClientTimeZoneId { get; set; }

VB.NET

Public Property ClientTimeZoneId As String

Property Value

Type	Description
String	A key string that uniquely identifies a particular time zone; its value should match to the System.TimeZoneInfo.Id property values for the time zones in the registry.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to ClientTimeZoneId
WinForms Controls	SchedulerControl	.OptionsBehavior .ClientTimeZoneId
ASP.NET Bootstrap Controls	BootstrapScheduler	.OptionsBehavior .ClientTimeZoneId
ASP.NET MVC Extensions	MVCxScheduler	.OptionsBehavior .ClientTimeZoneId
	SchedulerSettings	.OptionsBehavior .ClientTimeZoneId
ASP.NET Web Forms Controls	ASPxScheduler	.OptionsBehavior .ClientTimeZoneId

Remarks

The ClientTimeZoneId value is passed to the System.TimeZoneInfo.FindSystemTimeZoneById method to retrieve a TimeZoneInfo object from the registry. The obtained TimeZoneInfo is used in the TimeZoneHelper class instance for internal DateTime value conversion between time zones.

This property enables you to set the Scheduler time zone irrespective of the host time zone settings. See the Scheduler Time Zones document for more information on time zone support in the Scheduler.

In the ASPxScheduler, you can use this property to obtain or assign the client time zone. The following picture illustrates how the ClientTimeZoneId property could be set for the ASPxScheduler control via the ASPxTimeZoneEdit control. The time rulers display GMT, server and client times. The Client time ruler has its TimeRuler.UseClientTimeZone property set to true.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ClientTimeZoneId property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

synchronizing-with-google-calendar-e502/CS/WebApplication2/Default.aspx.cs#L82

TimeRuler ruler = view.TimeRulers[0];
string tzId = ASPxScheduler1.OptionsBehavior.ClientTimeZoneId;
ruler.TimeZoneId = tzId;

how-to-find-free-time-intervals-for-a-meeting-arrangement-e508/CS/FreeTimeIntervals/Form1.cs#L25

    timeZoneHelper = new TimeZoneHelper(this.schedulerControl1.OptionsBehavior.ClientTimeZoneId);
}

VB.NET

synchronizing-with-google-calendar-e502/VB/WebApplication2/Default.aspx.vb#L85

Dim ruler As TimeRuler = view.TimeRulers(0)
Dim tzId As String = ASPxScheduler1.OptionsBehavior.ClientTimeZoneId
ruler.TimeZoneId = tzId

how-to-find-free-time-intervals-for-a-meeting-arrangement-e508/VB/FreeTimeIntervals/Form1.vb#L39

    timeZoneHelper_Renamed = New TimeZoneHelper(Me.schedulerControl1.OptionsBehavior.ClientTimeZoneId)
End Sub