OWBI1_DateTime.hpp

Go to the documentation of this file.

/*******************************************************************************
* Copyright (C) 2001-2004 Vintela, Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
*  - Redistributions of source code must retain the above copyright notice,
*    this list of conditions and the following disclaimer.
*
*  - Redistributions in binary form must reproduce the above copyright notice,
*    this list of conditions and the following disclaimer in the documentation
*    and/or other materials provided with the distribution.
*
*  - Neither the name of Vintela, Inc. nor the names of its
*    contributors may be used to endorse or promote products derived from this
*    software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS''
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL Vintela, Inc. OR THE CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*******************************************************************************/

#ifndef OWBI1_DATETIME_HPP_INCLUDE_GUARD_
#define OWBI1_DATETIME_HPP_INCLUDE_GUARD_
#include "OWBI1_config.h"
#include "OWBI1_Exception.hpp"
#include "OWBI1_Types.hpp"
#include "OWBI1_CommonFwd.hpp"

extern "C"
{
#include <time.h>
}

namespace OWBI1
{

OWBI1_DECLARE_APIEXCEPTION(DateTime, OWBI1_COMMON_API)


class OWBI1_COMMON_API DateTime
{
public:
   enum ETimeOffset
   {
      E_LOCAL_TIME,
      E_UTC_TIME
   };

   DateTime();
   explicit DateTime(const String& str);
   explicit DateTime(time_t t, UInt32 microseconds=0);
   DateTime(int year, int month, int day, int hour=0, int minute=0,
      int second=0, UInt32 microsecond=0, ETimeOffset timeOffset = E_LOCAL_TIME);

   explicit DateTime(const detail::DateTimeRepRef& rep);
   ~DateTime();
   int getHour(ETimeOffset timeOffset = E_LOCAL_TIME) const;
   int getMinute(ETimeOffset timeOffset = E_LOCAL_TIME) const;
   int getSecond(ETimeOffset timeOffset = E_LOCAL_TIME) const;
   UInt32 getMicrosecond() const;
   int getDay(ETimeOffset timeOffset = E_LOCAL_TIME) const;
   int getDow(ETimeOffset timeOffset = E_LOCAL_TIME) const;
   int getMonth(ETimeOffset timeOffset = E_LOCAL_TIME) const;
   int getYear(ETimeOffset timeOffset = E_LOCAL_TIME) const;
   time_t get() const;
   void setHour(int hour, ETimeOffset timeOffset = E_LOCAL_TIME);
   void setMinute(int minute, ETimeOffset timeOffset = E_LOCAL_TIME);
   void setSecond(int second, ETimeOffset timeOffset = E_LOCAL_TIME);
   void setMicrosecond(UInt32 microsecond);
   void setTime(int hour, int minute, int second, ETimeOffset timeOffset = E_LOCAL_TIME);
   void setDay(int day, ETimeOffset timeOffset = E_LOCAL_TIME);
   void setMonth(int month, ETimeOffset timeOffset = E_LOCAL_TIME);
   void setYear(int year, ETimeOffset timeOffset = E_LOCAL_TIME);
   void set(time_t t, UInt32 microseconds=0);
   void set(int year, int month, int day, int hour, int minute, int second, UInt32 microseconds, ETimeOffset timeOffset = E_LOCAL_TIME);
   void setToCurrent();
   void addDays(int days);
   void addWeeks(int weeks)
   {
      addDays(weeks * 7);
   }
   void addMonths(int months);
   void addYears(int years);
   void addSeconds(long seconds);
   void addMinutes(long minutes);
   void addHours(long hours);
   bool operator< ( const DateTime& tm ) const;
   bool operator> ( const DateTime& tm ) const
   {
      return tm < *this;
   }
   bool operator== ( const DateTime& tm ) const;
   bool operator!= ( const DateTime& tm ) const
   {
      return !(*this == tm);
   }
   bool operator<= ( const DateTime& tm ) const
   {
      return !(tm < *this);
   }
   bool operator>= ( const DateTime& tm ) const
   {
      return !(*this < tm);
   }
   DateTime& operator+= (long seconds)
   {
      addSeconds(seconds);
      return *this;
   }
   DateTime& operator-= (long seconds)
   {
      addSeconds(-seconds);
      return *this;
   }

   String toString(ETimeOffset timeOffset = E_LOCAL_TIME) const;

   String toString(
      char const * format, ETimeOffset timeOffset = E_LOCAL_TIME) const;

   static char const DEFAULT_FORMAT[];

   static Int16 getGMTOffsetMinutesNow()
   {
      time_t t = time(0);
      struct tm tt;
      return DateTime::localTimeAndOffset(t, tt);
   }

   Int16 toLocal(struct tm & tt) const;

   static DateTime getCurrent();

   detail::DateTimeRepRef getRep() const;

private:
   detail::DateTimeRepRef m_rep;

   tm getTm(ETimeOffset timeOffset) const;
   void setTime(tm& tmarg, ETimeOffset timeOffset);
   static Int16 localTimeAndOffset(time_t t, struct tm & tt);
};

} // end namespace OWBI1

#endif

---