Specify time zone settings for a user
Use the UserSettings
entity to specify time zone settings for a user in Dynamics 365 Customer Engagement (on-premises). 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 Customer Engagement, 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 Entity
Time Zone Entities
Behavior and format of the date and time attribute
User and Team Entities