diff -r 80ef3a206772 -r 48780e181b38 Symbian3/SDK/Source/GUID-9A9654C4-4D7F-485E-8253-B2DB25D3DB78.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-9A9654C4-4D7F-485E-8253-B2DB25D3DB78.dita Tue Jul 20 12:00:49 2010 +0100 @@ -0,0 +1,72 @@ + + + + + +Creating a User-Defined Time Zone +

This tutorial describes how a device creator creates a user-defined +time zone using CTzUserData.

The high-level steps +to create a user-defined time zone are described in Procedure section: + +Create the +TZ rules object using CTzRules::NewL(). + +Use the CTzUserNames::NewL() function to create a TZ names object. + +Connect +to the TZ server using RTz::Connect(). + +Create a +user-defined time zone using CTzUserData::CreateL(). + + +

An illustration of the procedure is given below. Note +that cleanup stack management and CTzRules object +creation details are omitted for clarity.

#include <tz.h> // For CTzUserData etc. +#include <…> + +... + +// These strings would typically be supplied by the UI +layer. +_LIT( KTzUserStdName, ”Mountain Standard Time” ); +_LIT( KTzUserShortStdName, ”MST” ); +_LIT( KTzUserDstName, ”Mountain Daylight Time” ); +_LIT( KTzUserShortDstName, ”MDT” ); +_LIT( KTzUserCityName, ”Window Rock” ); +_LIT( KTzUserRegionName, ”America” ); + +// Create TZ rules object. +CTzRules* tzRules = ...; + +// Create TZ names object. +CTzUserNames* tzNames = CTzUserNames::NewL( KTzUserStdName, + KTzUserShortStdName, + KTzUserDstName, + KTzUserShortDstName, + KTzUserCityName, + KTzUserRegionName ); + +// Connect to TZ Server. +RTz tzServer; +User::LeaveIfError( tzServer.Connect() ); + +// Create user-defined TZ. +CTzUserData* tzUserData = CTzUserData::NewL( tzServer ); +CTzId* userTzId = tzUserData->CreateL( *tzRules, *tzNames ); + +... + + +Create +a user-defined time zone from an existing time zone +Time +Zone Services Overview + + \ No newline at end of file