libzypp  17.14.0
Date.h
Go to the documentation of this file.
1 /*---------------------------------------------------------------------\
2 | ____ _ __ __ ___ |
3 | |__ / \ / / . \ . \ |
4 | / / \ V /| _/ _/ |
5 | / /__ | | | | | | |
6 | /_____||_| |_| |_| |
7 | |
8 \---------------------------------------------------------------------*/
12 #ifndef ZYPP_DATE_H
13 #define ZYPP_DATE_H
14 
15 #include <ctime>
16 #include <iosfwd>
17 #include <string>
18 
19 #include "zypp/base/Exception.h"
20 #include "zypp/base/EnumClass.h"
21 
23 namespace zypp
24 {
25 
27  //
28  // CLASS NAME : Date
29  //
32  class Date
33  {
34  friend std::ostream & operator<<( std::ostream & str, const Date & obj );
35 
36  public:
37 
38  typedef time_t ValueType;
39  typedef time_t Duration;
40 
41  static const ValueType second = 1;
42  static const ValueType minute = 60;
43  static const ValueType hour = 3600;
44  static const ValueType day = 86400;
45  static const ValueType month28 = 2419200;
46  static const ValueType month29 = 2505600;
47  static const ValueType month30 = 2592000;
48  static const ValueType month31 = 2678400;
49  static const ValueType month = month30;
50  static const ValueType year365 = 31536000;
51  static const ValueType year366 = 31622400;
52  static const ValueType year = year365;
53 
54  enum TimeBase { TB_LOCALTIME, TB_UTC };
55 
57  Date()
58  : _date( 0 )
59  {}
61  Date( ValueType date_r )
62  : _date( date_r )
63  {}
65  explicit Date( const std::string & seconds_r );
66 
73  Date( const std::string & date_str, const std::string & format );
75  Date( const std::string & date_str, const std::string & format, TimeBase base_r );
76 
78  static Date now()
79  { return ::time( 0 ); }
80 
81  public:
83  operator ValueType() const
84  { return _date; }
85 
88  Date operator+( const time_t rhs ) const { return _date + rhs; }
89  Date operator-( const time_t rhs ) const { return _date - rhs; }
90  Date operator*( const time_t rhs ) const { return _date * rhs; }
91  Date operator/( const time_t rhs ) const { return _date / rhs; }
92 
93  Date & operator+=( const time_t rhs ) { _date += rhs; return *this; }
94  Date & operator-=( const time_t rhs ) { _date -= rhs; return *this; }
95  Date & operator*=( const time_t rhs ) { _date *= rhs; return *this; }
96  Date & operator/=( const time_t rhs ) { _date /= rhs; return *this; }
97 
98  Date & operator++(/*prefix*/) { _date += 1; return *this; }
99  Date & operator--(/*prefix*/) { _date -= 1; return *this; }
100 
101  Date operator++(int/*postfix*/) { return _date++; }
102  Date operator--(int/*postfix*/) { return _date--; }
104 
105  public:
112  std::string form( const std::string & format_r ) const
113  { return form( format_r, TB_LOCALTIME ); }
115  std::string form( const std::string & format_r, TimeBase base_r ) const;
116 
120  std::string asString() const
121  { return form( "%c" ); }
122 
126  std::string asSeconds() const
127  { return form( "%s" ); }
128 
129  public:
133  struct EDateFormatDef { enum Enum {
134  none,
135  calendar,
136  month,
137  year,
138  week,
139  weekday,
140  ordinal,
141  };};
142  typedef base::EnumClass<EDateFormatDef> DateFormat;
143 
145  struct ETimeFormatDef { enum Enum {
146  none,
147  seconds,
148  minutes,
149  hours,
150  };};
151  typedef base::EnumClass<ETimeFormatDef> TimeFormat;
152 
154  struct ETimeZoneFormatDef { enum Enum {
155  none,
156  name,
157  offset,
158  };};
159  typedef base::EnumClass<ETimeZoneFormatDef> TimeZoneFormat;
160 
166  std::string print( DateFormat dateFormat_r = DateFormat::calendar, TimeFormat timeFormat_r = TimeFormat::seconds, TimeZoneFormat timeZoneFormat_r = TimeZoneFormat::name, TimeBase base_r = TB_LOCALTIME ) const;
168  std::string print( TimeFormat timeFormat_r, TimeZoneFormat timeZoneFormat_r = TimeZoneFormat::name, TimeBase base_r = TB_LOCALTIME ) const
169  { return print( DateFormat::calendar, timeFormat_r, timeZoneFormat_r, base_r ); }
171  std::string print( DateFormat dateFormat_r, TimeZoneFormat timeZoneFormat_r, TimeBase base_r = TB_LOCALTIME ) const
172  { return print( dateFormat_r, TimeFormat::seconds, timeZoneFormat_r, base_r ); }
174  std::string print( DateFormat dateFormat_r, TimeFormat timeFormat_r, TimeBase base_r ) const
175  { return print( dateFormat_r, timeFormat_r, TimeZoneFormat::name, base_r ); }
177  std::string print( TimeZoneFormat timeZoneFormat_r, TimeBase base_r = TB_LOCALTIME ) const
178  { return print( DateFormat::calendar, TimeFormat::seconds, timeZoneFormat_r, base_r ); }
180  std::string print( TimeFormat timeFormat_r, TimeBase base_r ) const
181  { return print( DateFormat::calendar, timeFormat_r, TimeZoneFormat::name, base_r ); }
183  std::string print( DateFormat dateFormat_r, TimeBase base_r ) const
184  { return print( dateFormat_r, TimeFormat::seconds, TimeZoneFormat::name, base_r ); }
186  std::string print( TimeBase base_r ) const
187  { return print( DateFormat::calendar, TimeFormat::seconds, TimeZoneFormat::name, base_r ); }
188 
192  std::string printDate( DateFormat dateFormat_r = DateFormat::calendar, TimeBase base_r = TB_LOCALTIME ) const
193  { return print( dateFormat_r, TimeFormat::none, TimeZoneFormat::none, base_r ); }
195  std::string printDate( TimeBase base_r ) const
196  { return printDate( DateFormat::calendar, base_r ); }
197 
201  std::string printTime( TimeFormat timeFormat_r = TimeFormat::seconds, TimeZoneFormat timeZoneFormat_r = TimeZoneFormat::name, TimeBase base_r = TB_LOCALTIME ) const
202  { return print( DateFormat::none, timeFormat_r, timeZoneFormat_r, base_r ); }
204  std::string printTime( TimeZoneFormat timeZoneFormat_r , TimeBase base_r = TB_LOCALTIME ) const
205  { return printTime( TimeFormat::seconds, timeZoneFormat_r, base_r ); }
207  std::string printTime( TimeFormat timeFormat_r , TimeBase base_r ) const
208  { return printTime( timeFormat_r, TimeZoneFormat::name, base_r ); }
210  std::string printTime( TimeBase base_r ) const
211  { return printTime( TimeFormat::seconds, TimeZoneFormat::name, base_r ); }
212 
218  std::string printISO( DateFormat dateFormat_r = DateFormat::calendar, TimeFormat timeFormat_r = TimeFormat::seconds, TimeZoneFormat timeZoneFormat_r = TimeZoneFormat::name, TimeBase base_r = TB_LOCALTIME ) const;
220  std::string printISO( TimeFormat timeFormat_r, TimeZoneFormat timeZoneFormat_r = TimeZoneFormat::name, TimeBase base_r = TB_LOCALTIME ) const
221  { return printISO( DateFormat::calendar, timeFormat_r, timeZoneFormat_r, base_r ); }
223  std::string printISO( DateFormat dateFormat_r, TimeZoneFormat timeZoneFormat_r, TimeBase base_r = TB_LOCALTIME ) const
224  { return printISO( dateFormat_r, TimeFormat::seconds, timeZoneFormat_r, base_r ); }
226  std::string printISO( DateFormat dateFormat_r, TimeFormat timeFormat_r, TimeBase base_r ) const
227  { return printISO( dateFormat_r, timeFormat_r, TimeZoneFormat::name, base_r ); }
229  std::string printISO( TimeZoneFormat timeZoneFormat_r, TimeBase base_r = TB_LOCALTIME ) const
230  { return printISO( DateFormat::calendar, TimeFormat::seconds, timeZoneFormat_r, base_r ); }
232  std::string printISO( TimeFormat timeFormat_r, TimeBase base_r ) const
233  { return printISO( DateFormat::calendar, timeFormat_r, TimeZoneFormat::name, base_r ); }
235  std::string printISO( DateFormat dateFormat_r, TimeBase base_r ) const
236  { return printISO( dateFormat_r, TimeFormat::seconds, TimeZoneFormat::name, base_r ); }
238  std::string printISO( TimeBase base_r ) const
239  { return printISO( DateFormat::calendar, TimeFormat::seconds, TimeZoneFormat::name, base_r ); }
241 
242  private:
247  ValueType _date;
248  };
250 
252  inline std::ostream & operator<<( std::ostream & str, const Date & obj )
253  { return str << obj.asString(); }
254 
258  std::ostream & dumpAsXmlOn( std::ostream & str, const Date & obj, const std::string & name_r = "date" );
259 
261  class DateFormatException : public Exception
262  {
263  public:
264  DateFormatException( const std::string & msg ) : Exception( msg )
265  {}
266  };
267 
269 } // namespace zypp
271 #endif // ZYPP_DATE_H