ktimezones.h

/*
   This file is part of the KDE libraries
   Copyright (c) 2005 S.R.Haque <srhaque@iee.org>.
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License version 2 as published by the Free Software Foundation.
 
   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.
 
   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/
 
#ifndef _KTIMEZONES_H
#define _KTIMEZONES_H
 
#include "tdelibs_export.h"
#include <tqdatetime.h>
#include <tqnamespace.h>
#include <tqmap.h>
#include <tqstring.h>
#include <ksharedptr.h>
 
class KTimezoneDetails;
class KTimezoneDetailsPrivate;
class KTimezonePrivate;
class KTimezonesPrivate;

class TDECORE_EXPORT KTimezoneSource :
    public TDEShared
{
public:
    KTimezoneSource(const TQString &db);
    virtual ~KTimezoneSource();

    virtual TQString db();

    virtual bool parse(const TQString &zone, KTimezoneDetails &dataReceiver) const;
 
private:
    TQString m_db;
};

class TDECORE_EXPORT KTimezone
{
public:
    static const float UNKNOWN;

    static bool isValidLatitude(float latitude);

    static bool isValidLongitude(float longitude);

    KTimezone(
        TDESharedPtr<KTimezoneSource> db, const TQString &name,
        const TQString &countryCode = TQString(), float latitude = UNKNOWN, float longitude = UNKNOWN,
        const TQString &comment = TQString());
    ~KTimezone();

    TQString name() const;

    TQString countryCode() const;

    float latitude() const;

    float longitude() const;

    int offset(TQt::TimeSpec basisSpec = TQt::UTC) const;

    int offset(const TQDateTime &dateTime) const;

    TQDateTime convert(const KTimezone *newZone, const TQDateTime &dateTime) const;

    TQString comment() const;

    bool parse(KTimezoneDetails &dataReceiver) const;
 
private:
    KTimezone(const KTimezone&);
    KTimezone& operator=(const KTimezone&);
 
    TDESharedPtr<KTimezoneSource> m_db;
    TQString m_name;
    TQString m_countryCode;
    float m_latitude;
    float m_longitude;
    TQString m_comment;
    KTimezonePrivate *d;
};

class TDECORE_EXPORT KTimezoneDetails
{
public:
    KTimezoneDetails();
    virtual ~KTimezoneDetails();

    virtual void parseEnded();

    virtual void parseStarted();

    virtual void gotHeader(
        unsigned ttIsGmtCnt, unsigned ttIsStdCnt, unsigned leapCnt,
        unsigned timeCnt, unsigned typeCnt, unsigned charCnt);

    virtual void gotTransitionTime(int index, unsigned transitionTime);

    virtual void gotLocalTimeIndex(int index, unsigned localTimeIndex);

    virtual void gotLocalTime(int index, int gmtOff, bool isDst, unsigned abbrIndex);

    virtual void gotAbbreviation(int index, const TQString &abbr);

    virtual void gotLeapAdjustment(int index, unsigned leapTime, unsigned leapSeconds);

    virtual void gotIsStandard(int index, bool isStandard);

    virtual void gotIsUTC(int index, bool isUTC);
 
private:
    KTimezoneDetailsPrivate *d;
};

class TDECORE_EXPORT KTimezones
{
public:
    KTimezones();
    ~KTimezones();

    const KTimezone *local();

    const KTimezone *zone(const TQString &name);
 
    typedef TQMap<TQString, KTimezone *> ZoneMap;

    const ZoneMap allZones();

    void add(KTimezone *zone);
 
private:
    KTimezones(const KTimezones&);
    KTimezones& operator=(const KTimezones&);
 
    float convertCoordinate(const TQString &coordinate);
 
    TQString m_zoneinfoDir;
    ZoneMap *m_zones;
    KTimezone *m_UTC;
    KTimezonesPrivate *d;
};
 
#endif