1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/ossrv/genericservices/taskscheduler/SCHSVR/SCHTIME.CPP Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,214 @@
1.4 +// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
1.5 +// All rights reserved.
1.6 +// This component and the accompanying materials are made available
1.7 +// under the terms of "Eclipse Public License v1.0"
1.8 +// which accompanies this distribution, and is available
1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.10 +//
1.11 +// Initial Contributors:
1.12 +// Nokia Corporation - initial contribution.
1.13 +//
1.14 +// Contributors:
1.15 +//
1.16 +// Description:
1.17 +//
1.18 +
1.19 +#include <e32def.h>
1.20 +#include <s32strm.h>
1.21 +#include "SCHTIME.H"
1.22 +#include "SCHEXEC.H"
1.23 +
1.24 +/**
1.25 +UTC/Local Time flag value
1.26 +@internalComponent
1.27 +*/
1.28 +const TUint32 KIsUtc = 0x00000001;
1.29 +
1.30 +/**
1.31 +Default constructor for TTsTime.
1.32 +This constructor initialises its member data to zero.
1.33 +By default this sets it to be UTC based.
1.34 +*/
1.35 +EXPORT_C TTsTime::TTsTime():
1.36 + iUtcTime(0),
1.37 + iOffset(0),
1.38 + iFlags(KIsUtc)
1.39 + {
1.40 + }
1.41 +
1.42 +/**
1.43 +Copy constructor for TTsTime
1.44 +@param aTTsTime value to duplicate
1.45 +*/
1.46 +EXPORT_C TTsTime::TTsTime(const TTsTime& aTTsTime)
1.47 + {
1.48 + *this = aTTsTime;
1.49 + }
1.50 +
1.51 +/**
1.52 +Constructs a TTsTime with a TTime.
1.53 +If the iIsUtc is ETrue, then TTsTime is UTC based time, if iIsUtc is EFalse
1.54 +then TTsTime is local time based. This constructor will update all the member data as appropriate.
1.55 +@param aTime The TTime value
1.56 +@param aIsUtc is Etrue when aTime is UTC and EFalse when aTime is local time.
1.57 +*/
1.58 +EXPORT_C TTsTime::TTsTime(const TTime& aTime, TBool aIsUtc)
1.59 + {
1.60 + // if the time passed as argument is UTC based
1.61 + if(aIsUtc)
1.62 + SetUtcTime(aTime);
1.63 +
1.64 + // if the time passed is local time
1.65 + else
1.66 + SetLocalTime(aTime);
1.67 + }
1.68 +
1.69 +/**
1.70 +Sets this object to a local time based value updating its parameters as appropriate.
1.71 +@param aLocalTime The local time to be set.
1.72 +*/
1.73 +EXPORT_C void TTsTime::SetLocalTime(const TTime& aLocalTime)
1.74 + {
1.75 + iOffset = User::UTCOffset(); // sets the current UTC offset to iOffset
1.76 + iUtcTime = aLocalTime - iOffset; // converts the given aLocalTime to a UTC time value
1.77 + iFlags &= ~KIsUtc; //set the Bit 0 to zero for Local Time
1.78 + }
1.79 +
1.80 +/**
1.81 +Sets this object to a UTC time based value updating its parameters as appropriate.
1.82 +@param aUtcTime The UTC time to be set
1.83 +*/
1.84 +EXPORT_C void TTsTime::SetUtcTime(const TTime& aUtcTime)
1.85 + {
1.86 + iUtcTime = aUtcTime;
1.87 + iOffset = 0;
1.88 + iFlags |= KIsUtc; //set the Bit 0 to one as TTsTime is UTC
1.89 + }
1.90 +
1.91 +/**
1.92 +This function returns a home time value.
1.93 +@return Retrieves time from object in local time
1.94 +*/
1.95 +EXPORT_C const TTime TTsTime::GetLocalTime()
1.96 + {
1.97 + return DetermineLocalTime();
1.98 + }
1.99 +
1.100 +/**
1.101 +This function returns a home time value.
1.102 +@return Retrieves time from object in local time
1.103 +*/
1.104 +EXPORT_C TTime TTsTime::GetLocalTime() const
1.105 + {
1.106 + return DetermineLocalTime();
1.107 + }
1.108 +
1.109 +/**
1.110 +This function returns a UTC value.
1.111 +@return Returns the UTC time value.
1.112 +*/
1.113 +EXPORT_C const TTime& TTsTime::GetUtcTime()
1.114 + {
1.115 + return iUtcTime;
1.116 + }
1.117 +
1.118 +/**
1.119 +This function returns a UTC value.
1.120 +@return Returns the UTC time value.
1.121 +*/
1.122 +EXPORT_C const TTime& TTsTime::GetUtcTime() const
1.123 + {
1.124 + return iUtcTime;
1.125 + }
1.126 +
1.127 +/**
1.128 +@return ETrue, if TTsTime object is UTC and EFalse if TTsTime object is local time
1.129 +*/
1.130 +EXPORT_C TBool TTsTime::IsUtc() const
1.131 + {
1.132 + return iFlags & KIsUtc ? ETrue: EFalse;
1.133 + }
1.134 +
1.135 +
1.136 +/**
1.137 +This function returns a home time value.
1.138 +If UTC based returns UTC time + User::UTCOffset(). If local time based returns
1.139 +local time of the object.
1.140 +@internalComponent
1.141 +*/
1.142 +TTime TTsTime::DetermineLocalTime() const
1.143 + {
1.144 + TTime localTime;
1.145 + if(IsUtc())
1.146 + localTime = iUtcTime+User::UTCOffset();
1.147 + else
1.148 + localTime = iUtcTime+iOffset;
1.149 +
1.150 + return localTime;
1.151 + }
1.152 +
1.153 +/**
1.154 +This class does not explicitly update iOffSet if the system TimeZone/DST offset changes.
1.155 +When called this API will update the object if the system TimeZone/DST offset has changed.
1.156 +Keeping the offset in objects of this class correct is the responsibility of the
1.157 +Task Scheduler server.This applies to local time objects only. UTC objects will be unaffected.
1.158 +@internalComponent
1.159 +*/
1.160 +void TTsTime::ProcessOffsetEvent()
1.161 + {
1.162 + if(iFlags & KIsUtc)
1.163 + return;
1.164 +
1.165 + TTimeIntervalSeconds kernelOffset = User::UTCOffset();
1.166 +
1.167 + // check if there was an offset event happened without TTsTime being updated
1.168 + // localTime will always be the addition of UTC time and kernel offset
1.169 + if (iOffset != kernelOffset)
1.170 + {
1.171 + // If TTsTime is home time and there was a time zone change then TTsTime needs to be update.
1.172 + // If not then TTsTime remains the same, as UTC times are the same everywhere.
1.173 + iUtcTime = (iUtcTime+iOffset) - kernelOffset;
1.174 + iOffset = kernelOffset;
1.175 + }
1.176 + }
1.177 +/**
1.178 +Overloaded assignment operator for TTsTime
1.179 +@param aTsTime time value to copy
1.180 +*/
1.181 +EXPORT_C TTsTime& TTsTime::operator=(const TTsTime& aTsTime)
1.182 + {
1.183 + Mem::Copy(this,&aTsTime,sizeof(*this));
1.184 + return *this;
1.185 + }
1.186 +
1.187 +/**
1.188 +Uses the standard template operator>>() to internalize the object from aStream.
1.189 +Additionally this method will ensure that the object is updated in the event that
1.190 +the system TimeZone/DST offset changed since it was externalised.
1.191 +@internalComponent
1.192 +*/
1.193 +void TTsTime::InternalizeL(RReadStream& aStream)
1.194 + {
1.195 + TInt32 offset;
1.196 + TInt64 utcTime;
1.197 +
1.198 + // Updates TTsTime if local time based and the system Timezone/DST change occurred.
1.199 + ProcessOffsetEvent();
1.200 +
1.201 + aStream >> utcTime;
1.202 + iUtcTime = TTime(utcTime);
1.203 + aStream >> offset;
1.204 + iOffset = offset;
1.205 + aStream >> iFlags;
1.206 + }
1.207 +
1.208 +/**
1.209 +Uses the standard template operator>>() to externalize the object to aStream
1.210 +@internalComponent
1.211 +*/
1.212 +void TTsTime::ExternalizeL(RWriteStream& aStream) const
1.213 + {
1.214 + aStream << iUtcTime.Int64();
1.215 + aStream.WriteInt32L(iOffset.Int());
1.216 + aStream.WriteUint32L(iFlags);
1.217 + }