{"title":"SessionSettings.TimeZone([Text]) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/sessionsettings/sessionsettings-timezone-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/sessionsettings/sessionsettings-timezone-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/sessionsettings/sessionsettings-timezone-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Gets or sets the time zone property in a SessionSettings object.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"SessionSettings.TimeZone([Text]) Method","slug":"sessionsettingstimezonetext-method","at":0,"chars":1664},{"level":2,"title":"Syntax","slug":"syntax","at":167,"chars":148},{"level":2,"title":"Parameters","slug":"parameters","at":315,"chars":325},{"level":2,"title":"Return Value","slug":"return-value","at":640,"chars":116},{"level":2,"title":"Remarks","slug":"remarks","at":756,"chars":92},{"level":2,"title":"Example","slug":"example","at":848,"chars":614},{"level":2,"title":"Related information","slug":"related-information","at":1462,"chars":202}],"text":"# SessionSettings.TimeZone([Text]) Method\n> Version: _Available or changed with runtime version 1.0._\nGets or sets the time zone property in a SessionSettings object.\n## Syntax\n```al\n[TimeZone := ]  SessionSettings.TimeZone([NewTimeZone: Text])\n```\n> NOTE\n> This method can be invoked using property access syntax.\n## Parameters\nSessionSettings\nType: sessionsettings-data-type\nAn instance of the sessionsettings-data-type data type.\n*[Optional] NewTimeZone*\nType: ../text/text-data-type\nSpecifies the time zone property in the SessionsSettings object. The value must be a valid Windows time zone name, such as UTC or Pacific Standard Time.\n## Return Value\n*[Optional] TimeZone*\nType: ../text/text-data-type\nThe time zone set in the SessionSettings object.\n## Remarks\nThe default time zone is UTC. This method can't be used in web service sessions.\n## Example\nThis example creates a SessionSettings object that is populated with the current client user's personalization data, and then uses the TimeZone method to set the time zone to 'UTC' (Coordinated Universal Time). Finally, the RequestSessionUpdate method sends a request to the client to abandon the current session and start a new session that uses the new profile ID. This example requires a SessionSettings data type variable.\n```al\nvar\n  MySessionSettings : SessionSettings;\nbegin\n  MySessionSettings.Init;\n  MySessionSettings.TimeZone('UTC');\n  MySessionSettings.RequestSessionUpdate(false);\nend;\n```\n## Related information\nsessionsettings-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>\n../../../webservices/managing-time-zones-with-web-services"}