workingHours resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents the days of the week and hours in a specific time zone that the user works.

Having access to a user's working hours is useful in scenarios that handle activity or resource planning. You can get and set the working hours of a user as part of the user's mailbox settings.

You can choose to set a time zone for your working hours differently from the time zone you have set on your Outlook client. This can be useful in cases like when you travel to a different time zone than you usually work in. You can set the Outlook client to the destination time zone so that Outlook time values are displayed in local time while you are there. When other people request work meetings with you in your usual place of work, they can still respect your working hours in the appropriate time zone.

Note: The working hours experience in new Outlook and Outlook on the web isn't currently supported.

Properties

Property Type Description
daysOfWeek dayOfWeek collection The days of the week on which the user works.
startTime Edm.TimeOfDay The time of the day that the user starts working.
endTime Edm.TimeOfDay The time of the day that the user stops working.
timeZone timeZoneBase The time zone to which the working hours apply.

JSON representation

The following JSON representation shows the resource type.

{
  "daysOfWeek": ["string"],
  "startTime": "string (TimeOfDay)",
  "endTime": "string (TimeOfDay)",
  "timeZone": {"@odata.type": "microsoft.graph.timeZoneBase"}
}