---

time.Date.h

/*----------------------------------------------------------------------------
  SWORD 2000 - Software With Objects for Rapid Development
  Copyright (C) 2003 Eric NICOLAS
  ----------------------------------------------------------------------------
  SWORD is free software; you can redistribute it and/or modify
  it under the terms of the GNU Lesser General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  SWORD 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 Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with SWORD; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  --------------------------------------------------------------------------*/
#ifndef _SWORD_TIME_DATE_
#define _SWORD_TIME_DATE_

#include "sword/time.Time.h"
#include "sword/time.CalendarWestern.h"
#include "sword/time.CalendarGregorian.h"

namespace sword {

        class SWORDDECL Date : public Comparable<Date> {
        public:
                Date() throw();

                Date(const Date &rhs) throw();

                Date &operator=(const Date &rhs) throw();

                Date(word day, word month, word year, word hour, word minute, word second, word millis, const Calendar &calendar) throw();


                Date(word day, word month, word year, word hour, word minute, word second, word millis) throw();


                Date(word day, word month, word year, const Calendar &calendar) throw();


                Date(word day, word month, word year) throw();

                Date(Time time, const Calendar &calendar);


                Date(Time time);

                Date(int packed, const Calendar &calendar);


                Date(int packed);


                static Date now(const Calendar &calendar);


                static Date now();


                static Date nowUTC(const Calendar &calendar);


                static Date nowUTC();

                // --- Read Accessors

                word day() const throw();

                word month() const throw();

                word year() const throw();

                word hour() const throw();

                word minute() const throw();

                word second() const throw();

                word millis() const throw();

                const Calendar& calendar() const throw();

                // --- Other Accessors (computed data)


                word weekDay() const;

                word weekNumber() const;

                word dayWithinYear() const;

                // --- Write Accessors

                void day(word value) throw();

                void month(word value) throw();

                void year(word value) throw();

                void hour(word value) throw();

                void minute(word value) throw();

                void second(word value) throw();

                void millis(word value) throw();

                // --- Other access

                bool empty() const throw();

                void clear() throw();

                void set(word day, word month, word year, word hour, word minute, word second, word millis, const Calendar &calendar) throw();

                void set(word day, word month, word year, const Calendar &calendar) throw();

                // --- Simple date arithmetic


                void addYears(int years, bool endToEnd = false);


                void addMonths(int months, bool endToEnd = false);

                void addDays(int days);

                void addHours(int hours);

                void addMinutes(int minutes);

                void addSeconds(int seconds);

                void addMillis(int millis);

                void next();

                void prev();

                // --- Time conversion

                void fromTime(Time time, const Calendar &calendar);


                void fromTime(Time time);

                Time toTime() const;

    void fromPackedDate(int packed, const Calendar &calendar);

                void fromPackedDate(int packed);

                int toPackedDate() const;

                bool valid() const;

                // --- Input / Output


                std::string toString(const std::string &format) const;


                void fromString(const std::string &format, const std::string &data);

                // Standard formats
                static const char *formatRFC822UTC;
                static const char *formatRFC822;

                static int compare(const Date &lhs, const Date &rhs);

                // --- Exception

                class FormatException : public Exception {};
    class RangeException  : public Exception {};

        private:
                word  day_;       // The day of the month (1-based)
                word  month_;     // The month (1-based)
                word  year_;      // The year (absolute)
                word  hour_;      // The hour (0-based)
                word  minute_;    // The minutes (0-based)
                word  second_;    // The seconds (0-based)
                word  millis_;    // The milliseconds (0-based)
                Calendar &calendar_;  // The calendar used for all conversions

                // computes a pseudo-serial number for this date (unique hash value,
                // which is ordered just like the date is)
                int64 pseudoSerial_() const;
        };

} // namespace sword

#include "sword.private/time.Date.inl"

#endif // _SWORD_TIME_DATE_

---