Specify time zone settings for a user

 

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Use the UserSettings entity to specify time zone settings for a user in Microsoft Dynamics 365. The following attributes are exposed for the UserSettings entity related to time zone. All time zone attributes in the UserSettings entity are of Integer data type.

Attribute name

Description

TimeZoneBias

Local time zone adjustment for the user. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneCode

Local time zone code for the user.

For a list of time zone code values supported in Dynamics 365, use the TimeZoneDefinition.TimeZoneCode attribute. The TimeZoneDefinition.StandardName attribute stores the standard names of the corresponding time zone codes. More information:  Time zone entities

TimeZoneDaylightBias

Local time zone daylight adjustment for the user. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneDaylightDay

First, second, third, fourth, or fifth occurrence of a day in a month when daylight takes effect for the user as per the local time zone. The day and month values are taken from the TimeZoneDaylightDayOfWeek and TimeZoneDaylightMonth attributes respectively to determine the effective date. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

For example, for the US Eastern Standard Time (EST) time zone, consider the following attribute values:

  • TimeZoneDaylightDay: 2 //Denotes second occurrence

  • TimeZoneDaylightDayOfWeek: 0 //Denotes first day of the week (Sunday)

  • TimeZoneDaylightMonth: 3 //Denotes 3rd month (March)

This implies that the daylight takes effect on 2nd Sunday of March, which is effectively March 8, 2015.

TimeZoneDaylightDayOfWeek

The day of the week (Sunday=0, Monday=1,…) in a month when daylight takes effect for the user as per the local time zone. The month value is taken from the TimeZoneDaylightMonth attribute, and used along with the TimeZoneDaylightDay attribute value to determine the effective date. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

See the example in the TimeZoneDaylightDay attribute.

TimeZoneDaylightHour

Hour when daylight time takes effect for the user as per the local time zone. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneDaylightMinute

Minute when daylight time takes effect for the user as per the local time zone. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneDaylightMonth

The month (January=1, February=2,…) when daylight takes effect for the user as per the local time zone. Used along with the TimeZoneDaylightDay and TimeZoneDaylightDayOfWeek attributes to determine the effective date. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

For example, for the US Eastern Standard Time (EST) time zone, consider the following attribute values:

  • TimeZoneDaylightDay: 2 //Denotes second occurrence

  • TimeZoneDaylightDayOfWeek: 0 // Denotes first day of the week (Sunday)

  • TimeZoneDaylightMonth: 3 // Denotes 3rd month (March)

This implies that the daylight time takes effect on 2nd Sunday of March, which is effectively March 8, 2015.

TimeZoneDaylightSecond

Second when daylight time takes effect for the user as per the local time zone. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneDaylightYear

Local time zone daylight year for the user. Is set to 0 to indicate every year. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneStandardBias

Local time zone standard time bias for the user. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneStandardDay

First, second, third, fourth, or fifth occurrence of a day in a month when standard time takes effect for the user as per the local time zone. The day and month values are taken from the TimeZoneStandardDayOfWeek and TimeZoneStandardMonth attributes respectively to determine the effective date. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

For example, for the US Eastern Standard Time (EST) time zone, consider the following attribute values:

  • TimeZoneStandardDay: 1 //Denotes first occurrence

  • TimeZoneStandardDayOfWeek: 0 //Denotes first day of the week (Sunday)

  • TimeZoneStandardMonth: 11 //Denotes 11th month (November)

This implies that the standard time takes effect on 1st Sunday of November, which is effectively November 1, 2015.

TimeZoneStandardDayOfWeek

The day of the week (Sunday=0, Monday=1,…) in a month when standard time takes effect for the user as per the local time zone. The month value is taken from the TimeZoneStandardMonth attribute, and used along with the TimeZoneStandardDay attribute value to determine the effective date. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

See the example in the TimeZoneStandardDay attribute.

TimeZoneStandardHour

Hour when standard time takes effect for the user as per the local time zone. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneStandardMinute

Minute when standard time takes effect for the user as per the local time zone. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneStandardMonth

The month (January=1, February=2,…) when standard time takes effect for the user as per the local time zone. Used along with the TimeZoneStandardDay and TimeZoneStandardDayOfWeek attributes to determine the effective date. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

For example, for the US Eastern Standard Time (EST) time zone, consider the following attribute values:

  • TimeZoneDaylightDay: 1 //Denotes first occurrence

  • TimeZoneDaylightDayOfWeek: 0 // Denotes first day of the week (Sunday)

  • TimeZoneDaylightMonth: 11 // Denotes 11th month (November)

This implies that the standard time takes effect on 1st Sunday of November, which is effectively November 1, 2015.

TimeZoneStandardSecond

Second when standard time takes effect for the user as per the local time zone. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

TimeZoneStandardYear

Local time zone standard year for the user. Is set to 0 to indicate every year. System calculated based on the time zone specified for the user in the TimeZoneCode attribute.

See Also

SystemUser (user) entity messages and methods
Time zone entities
Behavior and format of the date and time attribute
User and team entities

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright