Editar

Compartilhar via


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