1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
// $Id: Timestamp.hh 2641 2007-09-02 21:31:02Z flaterco $
// Timestamp: A point in time. See also Year, Date, Interval.
/*
Copyright (C) 1998 David Flater.
This program is free software: you can redistribute it 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.
This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
*/
class Timestamp: public Nullable {
public:
// Create a null Timestamp.
Timestamp ();
// Create a Timestamp from a Posix timestamp.
Timestamp (time_t posixTime);
// Create a Timestamp for the beginning of the specified year in UTC
// (YEAR-01-01 00:00:00Z), or a null timestamp if not possible.
Timestamp (Year year);
// Create a Timestamp corresponding to a string in YYYY-MM-DD HH:MM
// format, but with separate time zone. Return null on error.
// WARNING: SECONDS, IF SPECIFIED, ARE TRUNCATED TO THE PREVIOUS MINUTE.
Timestamp (const Dstr &timeString, const Dstr &timezone);
// Create a Timestamp for the specified Julian date.
Timestamp (double julianDate);
// Convert to Julian date. Error if null.
const double jd() const;
// Convert to time_t. Error if null.
const time_t timet() const;
// Convert to tm in specified time zone.
const tm tmStruct (const Dstr &timezone) const;
// Return the UTC year that this timestamp falls in. Error if null.
const Year year() const;
// Return the day that this timestamp falls in. Error if null.
const date_t date (const Dstr &timezone) const;
// Output timestamp in local time zone, no seconds. Error if null.
void print (Dstr &text_out, const Dstr &timezone) const;
void printHour (Dstr &text_out, const Dstr &timezone) const;
void printDate (Dstr &text_out, const Dstr &timezone) const;
void printTime (Dstr &text_out, const Dstr &timezone) const;
void printCalendarHeading (Dstr &text_out, const Dstr &timezone) const;
void printCalendarDay (Dstr &text_out, const Dstr &timezone) const;
// Output timestamp in format complying with RFC 2445 (iCalendar).
// zeroOutSecs: YYYYMMDDTHHMM00Z
// keepSecs: YYYYMMDDTHHMMSSZ
enum SecStyle {zeroOutSecs, keepSecs};
void print_iCalendar (Dstr &text_out, SecStyle secStyle) const;
// Can't do this when null.
void operator+= (Interval b);
void operator-= (Interval b);
// This forces initialization of the time zone mapping and returns
// true if it can do Rarotonga correctly.
const bool zoneinfoIsNotHorriblyObsolete() const;
// The moonrise and moonset logic blows up if you go before 1900 or
// after 2099. This is just a range check for that.
const bool inRangeForLunarRiseSet() const;
// Following are four methods for finding hour transitions (i.e.,
// minutes and seconds are 0) and day transitions (i.e., midnight).
// This is not as simple as one might think.
// If an hour transition does not exist due to a DST change,
// floorHour and nextHour will go on to the following hour
// transition. If a day transition does not exist due to a DST
// change, floorDay and nextDay will return the time of the
// discontinuity. If a day transition occurs more than once due to
// a DST change (see example in Calendar.hh), it is not
// deterministic which of the timepoints floorDay and nextDay will
// return. However, it is assured that the timepoint returned by
// floorDay will be in the same day as where you started, and it is
// assured that the timepoint returned by nextDay will be in the
// next day. In the pathological case where midnight comes twice,
// nextDay will not jump from one twin to the other but will always
// go to the next day. This causes one of the midnights not to be
// marked in graphs but is necessary for nextDay to be usable as an
// incrementor function in Date.
// Find the previous hour or day transition given an arbitrary
// starting time. Like the mathematical floor operation, these
// return the input unchanged if it is already on the boundary.
void floorHour (const Dstr &timezone); // Error if timestamp is null.
void floorDay (const Dstr &timezone); // Error if timestamp is null.
// Find the next hour or day transition assuming that we are already
// on the previous transition.
void nextHour (const Dstr &timezone); // Error if timestamp is null.
void nextDay (const Dstr &timezone); // Error if timestamp is null.
protected:
time_t _posixTime;
// strftime in specified timezone with format fmt
void strftime (Dstr &text_out,
const Dstr &timezone,
const Dstr &formatString) const;
};
// Comparing with a null is an error.
const bool operator> (Timestamp a, Timestamp b);
const bool operator>= (Timestamp a, Timestamp b);
const bool operator< (Timestamp a, Timestamp b);
const bool operator<= (Timestamp a, Timestamp b);
const bool operator== (Timestamp a, Timestamp b);
const bool operator!= (Timestamp a, Timestamp b);
// You can't add or subtract from a null.
const Timestamp operator+ (Timestamp a, Interval b);
const Timestamp operator- (Timestamp a, Interval b);
const Interval operator- (Timestamp a, Timestamp b);
// Cleanup2006 Done
|
