timezone.h

Go to the documentation of this file.

// OSB library ********************************************* -*- C++ -*-
/*
  AUTHOR(S): Manikandan (mk)

  RCS information
   $Name: OSB_060808 $
   $Revision: 1.23 $

  License
   OSB rating and billing library for communication networks
   Copyright (C) 2004, 2005, 2006  OSB systems

   This file may be distributed and/or modify under the terms of the
   GNU General Public License (GPL) as published by the Free Software
   Foundation which is provided in the file LICENSE.GPL included in the
   packaging of this file.

   The file 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 General Public License
   for more details.

   Holders of a OSB Commercial License may use this file under the terms
   and conditions of this commercial license.
 */
#ifndef _TIMEZONE_H_
#define _TIMEZONE_H_

// *********************************************************************
// included header files
// + standard includes
#include <vector>

// + local headers
#include "chrono.h"
#include "osbid.h"
#include "osberror.h"

// *********************************************************************
// class declarations
namespace OSB_DB {
    class Session;
    struct TimeZoneGw;
}

// *********************************************************************
// namespace extensions
namespace OSB_LIB {

// *********************************************************************
// class definitions

    // *****************************************************************
    // class TimeZone
    class TimeZone {
        friend struct OSB_DB::TimeZoneGw;
    public:
        typedef Id<TimeZone> Oid;

        struct Interval {
            DateTime from;
            DateTime to;
            long     offset;
            bool     isDst;
        };

        typedef std::vector<Interval> Intervals;

        class Undefined : public OsbException {
            static const ErrorNo errNo = 535;
        public:
            Undefined();
        };

    public:
        TimeZone(
            const Oid&         oid,
            const std::string& name,
            const std::string& dstStart,
            const std::string& dstStartTime,
            const std::string& dstEnd,
            const std::string& dstEndTime,
                  long         stdOffset,
                  long         dstOffset
        );

        explicit TimeZone(const Oid& oid = Oid());



        const Oid& oid() const;

        const std::string& name() const;

        const std::string& dstStart() const;

        const std::string& dstEnd() const;

        const std::string& dstStartTime() const;

        const std::string& dstEndTime() const;

        long stdOffset() const;

        long dstOffset() const;

        long offset(DateTime& ts);

        void normalize(DateTime& ts);



        bool read(const OSB_DB::Session& session);

        bool insert(const OSB_DB::Session& session);

        bool remove(const OSB_DB::Session& session);

    private:
        Oid oid_;

        std::string name_;

        std::string dstStart_;

        std::string dstStartTime_;

        std::string dstEnd_;

        std::string dstEndTime_;

        long stdOffset_;

        long dstOffset_;

        mutable Intervals intervals_;

      private:
        const TimeZone::Intervals& intervals() const;

        DateTime mkDstStart(int year);

        DateTime mkDstEnd(int year);

        DateTime mkDateTime(
            std::string& dstDate,
            std::string& dstTime,
            int year
        );

        long find(const DateTime& ts) const;

        long mkInterval(const DateTime& ts);
    };

    typedef std::vector<TimeZone> TimeZones;

}                                       // namespace OSB_LIB
#endif                                  // #ifndef _TIMEZONE_H_

---