1 /* <!-- copyright */
2 /*
3  * aria2 - The high speed download utility
4  *
5  * Copyright (C) 2015 Tatsuhiro Tsujikawa
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  *
21  * In addition, as a special exception, the copyright holders give
22  * permission to link the code of portions of this program with the
23  * OpenSSL library under certain conditions as described in each
24  * individual source file, and distribute linked combinations
25  * including the two.
26  * You must obey the GNU General Public License in all respects
27  * for all of the code used other than OpenSSL.  If you modify
28  * file(s) with this exception, you may extend this exception to your
29  * version of the file(s), but you are not obligated to do so.  If you
30  * do not wish to do so, delete this exception statement from your
31  * version.  If you delete this exception statement from all source
32  * files in the program, then also delete it here.
33  */
34 /* copyright --> */
35 #ifndef D_TIME_H
36 #define D_TIME_H
37 
38 #include "common.h"
39 
40 #include <stdint.h>
41 
42 #include <string>
43 
44 #include "a2time.h"
45 
46 namespace aria2 {
47 
48 class Time {
49 public:
50   using Clock = std::chrono::system_clock;
51 
52   // The time value is initialized so that it represents the time at which
53   // this object was created.
54   Time();
55   Time(const Time& time) = default;
56   Time(Time&& time) = default;
57   Time(time_t sec);
58 
59   Time& operator=(const Time& time) = default;
60   Time& operator=(Time&& time) = default;
61 
62   bool operator<(const Time& time) const { return tp_ < time.tp_; }
63   bool operator>(const Time& time) const { return time < *this; }
64   bool operator<=(const Time& time) const { return !(time < *this); }
65   bool operator>=(const Time& time) const { return !(*this < time); }
66 
67   // Makes this object's time value up to date.
68   void reset();
69 
70   Clock::duration difference() const;
71   Clock::duration difference(const Time& now) const;
72 
getTime()73   const Clock::time_point& getTime() const { return tp_; }
74 
75   void setTimeFromEpoch(time_t sec);
getTimeFromEpoch()76   time_t getTimeFromEpoch() const { return Clock::to_time_t(tp_); }
77 
advance(const duration & t)78   template <typename duration> void advance(const duration& t) { tp_ += t; }
79 
good()80   bool good() const { return good_; }
bad()81   bool bad() const { return !good_; }
82 
null()83   static Time null() { return Time(0, false); }
84 
85   std::string toHTTPDate() const;
86 
87   // Currently timezone is assumed as GMT.
88   static Time parse(const std::string& datetime, const std::string& format);
89 
90   // Currently timezone is assumed to GMT.
91   static Time parseRFC1123(const std::string& datetime);
92 
93   // Like parseRFC1123, but only accepts trailing "+0000" instead of
94   // last 3 letters "GMT".
95   static Time parseRFC1123Alt(const std::string& datetime);
96 
97   // Currently timezone is assumed to GMT.
98   static Time parseRFC850(const std::string& datetime);
99 
100   // Currently timezone is assumed to GMT.  Basically the format is
101   // RFC850, but year part is 4digit, eg 2008 This format appears in
102   // original Netscape's PERSISTENT CLIENT STATE HTTP COOKIES
103   // Specification. http://curl.haxx.se/rfc/cookie_spec.html
104   static Time parseRFC850Ext(const std::string& datetime);
105 
106   // Currently timezone is assumed to GMT.
107   // ANSI C's asctime() format
108   static Time parseAsctime(const std::string& datetime);
109 
110   // Try parseRFC1123, parseRFC850, parseAsctime, parseRFC850Ext in
111   // that order and returns the first "good" Time object returned by
112   // these functions.
113   static Time parseHTTPDate(const std::string& datetime);
114 
115 private:
Time(time_t t,bool good)116   Time(time_t t, bool good) : tp_(Clock::from_time_t(t)), good_(good) {}
117 
118   Clock::time_point tp_;
119   bool good_;
120 };
121 
122 } // namespace aria2
123 
124 #endif // D_TIME_H
125