/*

* Copyright (c) 2002-2005 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:        This utility class provides static methods for conversions

*                between Symbian class types and XSD time-date type

*

*/

#ifndef SEN_DATE_UTILS_H

#define SEN_DATE_UTILS_H

//  INCLUDES

#include <e32base.h>

// CLASS DECLARATION

/**

* This utility class provides static methods for conversions between Symbian 

* class types and XSD time-date type.

*  @lib SenUtils.lib

*  @since Series60 3.0

*/

class SenDateUtils

    {

    public: 

        enum { KXmlDateTimeMaxLength = 31 };

        // New functions

        /**

        * Convert dateTime (from XML schema) to Symbian TTime. 

        * A panic will occur if an attempt is made to set an invalid 

        * value for any of the fields. 

        * Panics: User 3 if illegal date.

        * Leave codes:  KErrUnderflow   Not enough data given or 

        *                               negative values

        *               KErrOverflow    Too big values for e.g. month

        *               KErrGeneral     Invalid date structure

        * No check is made upon the validity of the year.

        * @since Series60 3.0

        * @param aXmlDateTime   source datetime to convert from

        * @return The returned time will be in UTC.

        */

        IMPORT_C static TTime FromXmlDateTimeL(const TDesC8& aXmlDateTime);

        /**

        * Convert Symbian TTime to dateTime (from XML schema).

        * Leave codes:  KErrOverflow    target descriptor is less than

        *               KXmlDateTimeMaxLength (25 bytes)

        * @since Series60 3.0

        * @param aDest (UTF8) result will be written here. It must be at least

        *                KXmlDateTimeMaxLength long.

        * @param TTime in UTC.

        */

        IMPORT_C static void ToXmlDateTimeUtf8L(TDes8& aDest, 

                                                const TTime& aSrc);

        /**

        * Convert Symbian TTime to dateTime (from XML schema).

        * Leave codes:  KErrOverflow    target descriptor is less than

        *               KXmlDateTimeMaxLength (25 bytes)

        * @since Series60 5.0

        * @param aDest (UTF8) result will be written here. It must be at least

        *                KXmlDateTimeMaxLength long.

        * @param TTime in UTC.

        */

	IMPORT_C static void ToXmlDateTimeUtf82L(TDes8& aDest, const TTime& aSrc) ;

    private:

        /**

        * Hide default C++ constructor.

        */

        SenDateUtils() { }

        /**

        * Prohibit copy constructor if not deriving from CBase.

        */

        SenDateUtils( const SenDateUtils& );

        /**

        * Prohibit assignment operator if not deriving from CBase.

        */

        SenDateUtils& operator=( const SenDateUtils& );

    };

#endif // SEN_DATE_UTILS_H

// End of File