SessionSettings.TimeZone([Text]) Method
Version: Available or changed with runtime version 1.0.
Gets or sets the time zone property in a SessionSettings object.
Syntax
[TimeZone := ] SessionSettings.TimeZone([NewTimeZone: Text])
Note
This method can be invoked using property access syntax.
Parameters
SessionSettings
Type: SessionSettings
An instance of the SessionSettings data type.
[Optional] NewTimeZone
Type: Text
Specifies 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.
Return Value
[Optional] TimeZone
Type: Text
The time zone set in the SessionSettings object.
Remarks
The default time zone is UTC. This method can also be used with web service sessions.
Example
This 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.
var
MySessionSettings : SessionSettings;
begin
MySessionSettings.Init;
MySessionSettings.TimeZone('UTC');
MySessionSettings.RequestSessionUpdate(false);
end;
Related information
SessionSettings Data Type
Get Started with AL
Developing Extensions
Managing Time Zones with Web Services