Time.h

// WARNING: Changes to this file must be contributed back to Sawyer or else they will
//          be clobbered by the next update from Sawyer.  The Sawyer repository is at
//          https://github.com/matzke1/sawyer.




#ifndef Sawyer_Time_H
#define Sawyer_Time_H

#include <Sawyer/Optional.h>
#include <Sawyer/Result.h>

#include <ctime>
#include <ostream>

namespace Sawyer {

class Time {
    Optional<unsigned> year_;                           // year, >= 1583
    Optional<unsigned> month_;                          // month of year, 1 through 12, only if year_ is defined
    Optional<unsigned> day_;                            // day of month, 1 through 31, only if month_ is defined

    Optional<unsigned> hour_;                           // 0 through 23
    Optional<unsigned> minute_;                         // 0 through 59, only if hour_ is defined
    Optional<unsigned> second_;                         // 0 through 60 (for a leap second), only if minute_ is defined

    Optional<int> tz_hour_;                             // -23 through +23
    Optional<int> tz_minute_;                           // -59 through 59, only if tz_hour_ is defined and having the same sign

public:
    Time();

    static Result<Time, std::string> parse(const std::string&);

    static Time now();

    bool isEmpty() const;

    bool hasDate() const;

    bool hasTime() const;

    bool hasZone() const;

    bool hasSpecificDate() const;

    bool hasSpecificTime() const;

    Time resolve(const Time&) const;

    Time lowerBound() const;

    Result<Time, std::string> upperBound() const;

    Time noDate() const;

    Time noTime() const;

    Time noZone() const;

    const Optional<unsigned>& year() const;

    const Optional<unsigned>& month() const;

    const Optional<unsigned>& day() const;

    const Optional<unsigned>& hour() const;

    const Optional<unsigned>& minute() const;

    const Optional<unsigned>& second() const;

    const Optional<int>& timeZoneHour() const;

    const Optional<int>& timeZoneMinute() const;

    Result<Time, std::string> toZulu() const;

    std::string toString() const;

    Result<time_t, std::string> toUnix() const;

    bool operator==(const Time&) const;
    bool operator!=(const Time&) const;
    bool operator<(const Time&) const;

private:
    // Normalization functions
    void normalizeSecond();
    void normalizeMinute();
    void normalizeHour();
    void normalizeMonth();
    void normalize();
};

std::ostream& operator<<(std::ostream&, const Time&);

} // namespace
#endif