--- a/epoc32/include/mw/tzupdate.h Wed Mar 31 12:27:01 2010 +0100
+++ b/epoc32/include/mw/tzupdate.h Wed Mar 31 12:33:34 2010 +0100
@@ -1,9 +1,9 @@
// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
-// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// under the terms of "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
-// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
@@ -17,6 +17,7 @@
#define __TZUPDATE_H__
#include <e32cmn.h> // TUid.
+#include <e32std.h>
/** UTC Offset update notification constants. When the UTC offset is automatically
adjusted for Daylight Saving then it is possible to receive
@@ -25,22 +26,35 @@
as this is the only component that can modify the UTC Offset.
@see RProperty in e32property.h
-@publishedAll
-@released
-@since 9.1
*/
namespace NTzUpdate
{
+ /** Time zone services publish and subscribe property category.
+ @publishedAll
+ @released
+ */
const TUid KPropertyCategory = { 0x1020383E };
+ /** Time zone services publish and subscribe property keys.
+ @publishedAll
+ @released
+ */
enum TPropertyKeys
{
EUtcOffsetChangeNotification,
ECurrentTimeZoneId,
EHomeTimeZoneId,
- ENextDSTChange
+ ENextDSTChange,
+ ETzRulesChange,
+ ETzNamesChange,
};
+ /** Structure used to return the value for ECurrentTimeZoneId or
+ EHomeTimeZoneId property.
+ @see RTz::NotifyHomeTimeZoneChangedL
+ @publishedAll
+ @released
+ */
struct TTimeZoneChange
{
TInt iNewTimeZoneId;
@@ -48,10 +62,11 @@
};
/** This struct is used to publish DST Change info in an RProperty.
- Subscribers to the property will define a copy of this struct
+ Subscribers to the ENextDSTChange property will define a copy of this struct
so that they are not dependant on the tz component.
If this struct changes then the copies must also be changed.
- @internalTechnology
+ @publishedAll
+ @released
*/
struct TDSTChangeInfo
{
@@ -69,10 +84,32 @@
/** The offset from UTC (in minutes) before the previous DST change took place. This member is only valid
if the version is 2 or above.*/
TInt iPreviousUTCOffset;
-
- /** Reserved for future use. */
+ private:
+ /** Reserved for future use.
+ */
TInt iReserved[12];
};
- }
+ /** Structure used to return the value for ETzRulesChange property.
+ This property covers changes to the system TZ database, the current/system
+ TZ rules or user-defined TZ rules.
+ @publishedAll
+ @released
+ */
+ struct TTzRulesChange
+ {
+ TTime iUTCTimeOfRulesChange;
+ };
+
+ /** Structure used to return the value for ETzNamesChange property.
+ This property covers changes to either the localized system TZ names
+ or non-localized user-defined TZ names.
+ @publishedAll
+ @released
+ */
+ struct TTzNamesChange
+ {
+ TTime iUTCTimeOfNamesChange;
+ };
+ }
#endif // __TZUPDATE_H__