The data format of timeZone field in mailboxSettings is not in GMT/UTC or IANA format

Question

I've tried to set different time zones in Outlook 365 settings, and get the mailboxSettings from Graph API:
GET https://graph.microsoft.com/v1.0/me/mailboxSettings
The return value of timeZone field is like following:
"Tokyo Standard Time", "Fiji Standard Time", or "Greenland Standard Time" etc.
These values are not time zones in GMT/UTC format, nor IANA format of the values listed in following URL which are supported time zones by Graph API.
https://learn.microsoft.com/en-us/graph/api/resources/datetimetimezone?view=graph-rest-1.0,

Then it will be a problem to apply the timezone setting in mailboxSettings to new event's start/end field's timezone in creation:
https://learn.microsoft.com/en-us/graph/api/user-post-events?view=graph-rest-1.0&tabs=http

Will this field's data format be corrected in the future? i.e could it be corrected to the value which in the list in:
https://learn.microsoft.com/en-us/graph/api/resources/datetimetimezone?view=graph-rest-1.0,

Answer 1

Hello @eric lin

Thanks for reaching out!

As per the MS documentation, users can set their preferred date and time formats using Outlook on the web. This GET /me/mailboxSettings operation returns the format the user has chosen.

Users can set the time zone they prefer on any Outlook client, by choosing from the supported time zones that their administrator has set up for their mailbox server. The administrator can set up time zones in the Windows time zone format or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. The Windows format is the default.

This GET operation returns the user's preferred time zone in the format that the administrator has set up. If you want that time zone to be in a specific format (Windows or IANA), you can first update the preferred time zone in that format as a mailbox setting. Subsequently you will be able to get the time zone in that format. Alternatively, you can manage the format conversion separately in your app.

Note: You can always refer to Changelog portal to track latest changes made to Graph APIs.

Hope this helps.

If the answer is helpful, please click Accept Answer and kindly upvote. If you have any further questions about this answer, please click Comment.

Answer 2

Thanks for your answer.