datetime.hpp

Go to the documentation of this file.

/************************************************************************
Copyright (C) 2011 - 2014 Project Wolframe.
All rights reserved.

This file is part of Project Wolframe.

Commercial Usage
Licensees holding valid Project Wolframe Commercial licenses may
use this file in accordance with the Project Wolframe
Commercial License Agreement provided with the Software or,
alternatively, in accordance with the terms contained
in a written agreement between the licensee and Project Wolframe.

GNU General Public License Usage
Alternatively, you can redistribute this file and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Wolframe 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.

You should have received a copy of the GNU General Public License
along with Wolframe. If not, see <http://www.gnu.org/licenses/>.

If you have questions regarding the use of this file, please contact
Project Wolframe.

************************************************************************/

#ifndef _Wolframe_TYPES_DATETIME_HPP_INCLUDED
#define _Wolframe_TYPES_DATETIME_HPP_INCLUDED
#include <string>
#include <cstring>
#include <cstdlib>
#include <stdexcept>
#include <boost/cstdint.hpp>

namespace _Wolframe {
namespace types {

class Variant;

typedef boost::uint64_t Timestamp;

class DateTime
{
public:
        enum SubType
        {
                YYYYMMDD,               
                YYYYMMDDhhmmss,         
                YYYYMMDDhhmmss_lll,     
                YYYYMMDDhhmmss_lllccc   
        };
        DateTime( const DateTime& o)
                :m_year(o.m_year),m_month(o.m_month),m_day(o.m_day),m_hour(o.m_hour),m_minute(o.m_minute),m_second(o.m_second),m_millisecond(o.m_millisecond),m_microsecond(o.m_microsecond),m_subtype(o.m_subtype)
        {}

        DateTime( unsigned short YY,
                  unsigned short MM,
                  unsigned short DD,
                  unsigned short hh,
                  unsigned short mm,
                  unsigned short ss,
                  unsigned short ll,
                  unsigned short cc)
                :m_year(YY),m_month((unsigned char)MM),m_day((unsigned char)DD),m_hour((unsigned char)hh),m_minute((unsigned char)mm),m_second((unsigned char)ss),m_millisecond(ll),m_microsecond(cc),m_subtype(YYYYMMDDhhmmss_lllccc)
        {
                check( YY, MM, DD, hh, mm, ss, ll, cc);
        }

        DateTime( unsigned short YY,
                  unsigned short MM,
                  unsigned short DD,
                  unsigned short hh,
                  unsigned short mm,
                  unsigned short ss,
                  unsigned short ll)
                :m_year(YY),m_month((unsigned char)MM),m_day((unsigned char)DD),m_hour((unsigned char)hh),m_minute((unsigned char)mm),m_second((unsigned char)ss),m_millisecond(ll),m_microsecond(0),m_subtype(YYYYMMDDhhmmss_lll)
        {
                check( YY, MM, DD, hh, mm, ss, ll, 0);
        }

        DateTime( unsigned short YY,
                  unsigned short MM,
                  unsigned short DD,
                  unsigned short hh,
                  unsigned short mm,
                  unsigned short ss)
                :m_year(YY),m_month((unsigned char)MM),m_day((unsigned char)DD),m_hour((unsigned char)hh),m_minute((unsigned char)mm),m_second((unsigned char)ss),m_millisecond(0),m_microsecond(0),m_subtype(YYYYMMDDhhmmss)
        {
                check( YY, MM, DD, hh, mm, ss, 0, 0);
        }

        DateTime( unsigned short YY,
                  unsigned short MM,
                  unsigned short DD)
                :m_year(YY),m_month((unsigned char)MM),m_day((unsigned char)DD),m_hour(0),m_minute(0),m_second(0),m_millisecond(0),m_microsecond(0),m_subtype(YYYYMMDD)
        {
                check( YY, MM, DD, 0, 0, 0, 0, 0);
        }

        unsigned int year() const               {return m_year;}
        unsigned int month() const              {return m_month;}
        unsigned int day() const                {return m_day;}
        unsigned int hour() const               {return m_hour;}
        unsigned int minute() const             {return m_minute;}
        unsigned int second() const             {return m_second;}
        unsigned int millisecond() const        {return m_millisecond;}
        unsigned int microsecond() const        {return m_microsecond;}
        unsigned int usecond() const            {return m_second * 1000 + m_microsecond;}
        SubType subtype() const                 {return m_subtype;}

        DateTime( const Timestamp& t)
        {
                init( t);
        }
        DateTime( const std::string& s)
        {
                init( s);
        }

        DateTime( const char* str, std::size_t strsize)
        {
                init( str, strsize);
        }

        DateTime( const Variant& v);

        Timestamp timestamp() const;

        void init( Timestamp timestamp_);

        void init( const std::string& str);

        //      The date time value gets a subtype depending on what is specified in the string (e.g. if the granularity in the parsed string is seconds then the subtype gets YYYYMMDDhhmmss)
        //      a) ISO date time 20011126T234312,123134
        //      b) 2001-11-26 23:43:12,123134
        //      c) 20011126234312123134
        void init( const char* str, std::size_t strsize);

        struct StringFormat
        {
                enum Id
                {
                        YYYYMMDDhhmmssxxxxxx,
                        ISOdateTime,
                        ExtendedISOdateTime
                };
        };

        double toMSDNtimestamp() const;

        static DateTime fromMSDNtimestamp( double tm);

        std::string tostring( StringFormat::Id sf=StringFormat::YYYYMMDDhhmmssxxxxxx) const;

        bool operator==( const DateTime& o) const       {return compare(o)==0;}
        bool operator!=( const DateTime& o) const       {return compare(o)!=0;}
        bool operator>=( const DateTime& o) const       {return compare(o)>=0;}
        bool operator> ( const DateTime& o) const       {return compare(o)> 0;}
        bool operator<=( const DateTime& o) const       {return compare(o)<=0;}
        bool operator< ( const DateTime& o) const       {return compare(o)< 0;}

        int compare( const DateTime& o) const;

private:
        static int compareValue( unsigned int aa, unsigned int bb)
        {
                if (aa == bb) return 0;
                if (aa < bb) return -1;
                return +1;
        }
        static void setBits( Timestamp& dest, unsigned int val, unsigned int bitidx, unsigned int bitrange)
        {
                dest |= ((Timestamp) val << (63-bitidx-bitrange));
        }
        static unsigned int getBits( const Timestamp& from, unsigned int bitidx, unsigned int bitrange)
        {
                return (unsigned int)(from >> (63-bitidx-bitrange)) & ((1<<bitrange)-1);
        }
        static unsigned int getSubstringAsInt( const char* from, unsigned int idx, unsigned int range)
        {
                return std::atoi( std::string( from + idx, range).c_str());
        }
        static void check_range( unsigned int val, unsigned int from, unsigned int to)
        {
                if (val < from || val > to)
                {
                        throw std::runtime_error("value out of range");
                }
        }
        static void check_range( unsigned int val, unsigned int maximum)
        {
                if (val > maximum)
                {
                        throw std::runtime_error("value out of range");
                }
        }
        static void check( unsigned short YY, unsigned short MM, unsigned short DD, unsigned short hh, unsigned short mm, unsigned short ss, unsigned short ll, unsigned short cc);

        static void appendValue( std::string& dest, unsigned int value, unsigned int nofDigits);

private:
        unsigned short m_year;          
        unsigned char m_month;          
        unsigned char m_day;            
        unsigned char m_hour;           
        unsigned char m_minute;         
        unsigned char m_second;         
        unsigned short m_millisecond;   
        unsigned short m_microsecond;   
        SubType m_subtype;              
};

}}//namespace
#endif