UserProfile.timeZone property (JavaScript API for Office)

Office Add-ins

Gets the user's default time zone.

Last modified: August 07, 2015

Note Note

The name "apps for Office" is changing to "Office Add-ins". During the transition, the documentation and the UI of some Office host applications and Visual Studio tools might still use the term "apps for Office". For details, see New name for apps for Office and SharePoint.

Hosts:Outlook

Add-in type: Mail

Available in requirement sets

Mailbox

Last changed in Mailbox

1.0

Applicable Outlook modes

Compose or read

See all support details

Office.context.mailbox.userProfile.timeZone

A string that represents the user's default time zone, as specified in the host application.

The timeZone property returns time zone information as set in the host application. It also returns any information about the transition between standard time and daylight saving time.

In Outlook for Windows and Outlook RT, the user can set the time zone in the Office Fluent Backstage view which is synchronized with the time zone specified for Windows on the client computer. Similarly in Outlook for Mac, the user can set the time zone in Outlook Preferences, which is synchronized with the Date & Time preferences on the client computer. In Outlook Web App and OWA for Devices, the timeZone property is the time zone set in the Exchange Admin Center (EAC) on the web for that mailbox. Therefore, the timeZone property value can be different in a rich client (Outlook for Windows, Outlook 2013 RT or Outlook for Mac) and in Outlook Web App or OWA for Devices.

A checkmark (√) in the following table indicates that this property is supported in the corresponding Outlook host application. An empty cell indicates that the Outlook host application doesn't support this property.

For more information about Office host application and server requirements, see Requirements for running Office Add-ins.

Supported hosts, by platform

Office for Windows desktop

Office Online
(in browser)

OWA for Devices

Office for Mac

Outlook

√ (Read mode only)

Available in requirement sets

Mailbox

Minimum permission level

ReadItem

Add-in types

Mail

Library

Office.js

Namespace

Office

Version

Changes

1.0

Introduced

Show:
© 2015 Microsoft