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://gitlab.com/charger7534/sawyer.git.
 
 
 
 
#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