/*
- Copyright (C) 2014-2015 Carl Hetherington <cth@carlh.net>
+ Copyright (C) 2014-2021 Carl Hetherington <cth@carlh.net>
This file is part of libdcp.
You should have received a copy of the GNU General Public License
along with libdcp. If not, see <http://www.gnu.org/licenses/>.
+
+ In addition, as a special exception, the copyright holders give
+ permission to link the code of portions of this program with the
+ OpenSSL library under certain conditions as described in each
+ individual source file, and distribute linked combinations
+ including the two.
+
+ You must obey the GNU General Public License in all respects
+ for all of the code used other than OpenSSL. If you modify
+ file(s) with this exception, you may extend this exception to your
+ version of the file(s), but you are not obligated to do so. If you
+ do not wish to do so, delete this exception statement from your
+ version. If you delete this exception statement from all source
+ files in the program, then also delete it here.
*/
+
/** @file src/local_time.h
- * @brief LocalTime class.
+ * @brief LocalTime class
*/
+
#ifndef LIBDCP_LOCAL_TIME_H
#define LIBDCP_LOCAL_TIME_H
+
+#include "utc_offset.h"
#include <boost/date_time/posix_time/posix_time.hpp>
#include <string>
-class local_time_test;
+
+struct local_time_basic_test;
+
namespace dcp {
+
/** @class LocalTime
* @brief A representation of a local time (down to the second), including its offset
* from GMT (equivalent to xs:dateTime).
* to parse strings of the required format (those that include time zones).
*
* See http://www.w3.org/TR/xmlschema-2/#dateTime
+ *
+ * Note that operator== for this class will return true for times that have different
+ * offsets but are the same actual time.
*/
class LocalTime
{
public:
+ /** Construct a LocalTime from the current time */
LocalTime ();
- LocalTime (boost::posix_time::ptime);
- LocalTime (boost::posix_time::ptime, int tz_hour, int tz_minute);
- LocalTime (std::string);
- std::string as_string (bool with_millisecond = false) const;
+ explicit LocalTime (struct tm tm);
+
+ /** Construct a LocalTime from a boost::posix_time::ptime using the local
+ * time zone
+ */
+ explicit LocalTime (boost::posix_time::ptime);
+
+ /** Construct a LocalTime from a boost::posix_time::ptime and a time zone offset */
+ LocalTime(boost::posix_time::ptime, UTCOffset offset);
+
+ /** @param s A string of the form 2013-01-05T18:06:59[.123][+04:00] */
+ explicit LocalTime (std::string s);
+
+ LocalTime(int year, int month, int day, int hour, int minute, UTCOffset offset)
+ : _year(year)
+ , _month(month)
+ , _day(day)
+ , _hour(hour)
+ , _minute(minute)
+ , _offset(offset)
+ {}
+
+ /** @return A string of the form 2013-01-05T18:06:59+04:00, 2013-01-05T18:06:59.123+04:00
+ * 2013-01-05T18:06:59 or 2013-01-05T18:06:59.123
+ */
+ std::string as_string(bool with_millisecond = false, bool with_timezone = true) const;
+
+ /** @return The date in the form YYYY-MM-DD */
std::string date () const;
- std::string time_of_day (bool with_millisecond = false) const;
+
+ /** @return The time in the form HH:MM:SS or HH:MM:SS.mmm */
+ std::string time_of_day (bool with_second, bool with_millisecond) const;
+
+ int day () const {
+ return _day;
+ }
+
+ int month () const {
+ return _month;
+ }
+
+ int year () const {
+ return _year;
+ }
+
+ int hour () const {
+ return _hour;
+ }
+
+ int minute () const {
+ return _minute;
+ }
+
+ int second () const {
+ return _second;
+ }
+
+ int millisecond() const {
+ return _millisecond;
+ }
+
+ void set_day(int d) {
+ _day = d;
+ }
+
+ void set_month(int m) {
+ _month = m;
+ }
+
+ void set_year (int y) {
+ _year = y;
+ }
+
+ void set_offset(UTCOffset offset) {
+ _offset = offset;
+ }
+
+ void add_days (int d);
+ void add_months (int a);
+ void add_minutes (int a);
+
+ void add(boost::posix_time::time_duration duration);
+
+ static LocalTime from_asn1_utc_time (std::string time);
+ static LocalTime from_asn1_generalized_time (std::string time);
bool operator== (LocalTime const & other) const;
bool operator!= (LocalTime const & other) const;
+ bool operator< (LocalTime const & other) const;
+ bool operator<=(LocalTime const & other) const;
+ bool operator>(LocalTime const & other) const;
+ bool operator>=(LocalTime const & other) const;
private:
- friend class ::local_time_test;
+ friend struct ::local_time_basic_test;
+ void set (struct tm const * tm);
+ void set (boost::posix_time::ptime);
void set_local_time_zone ();
+ dcp::LocalTime as_utc() const;
/* Local time */
- int _year; ///< year
- int _month; ///< month number of the year (1-12)
- int _day; ///< day number of the month (1-31)
- int _hour; ///< hour number of the day (0-23)
- int _minute; ///< minute number of the hour (0-59)
- int _second; ///< second number of the minute (0-59)
- int _millisecond; ///< millisecond number of the second (0-999)
-
- int _tz_hour; ///< hours by which this time is offset from UTC
- int _tz_minute; ///< minutes by which this time is offset from UTC
+ int _year = 0; ///< year
+ int _month = 0; ///< month number of the year (1-12)
+ int _day = 0; ///< day number of the month (1-31)
+ int _hour = 0; ///< hour number of the day (0-23)
+ int _minute = 0; ///< minute number of the hour (0-59)
+ int _second = 0; ///< second number of the minute (0-59)
+ int _millisecond = 0; ///< millisecond number of the second (0-999)
+
+ UTCOffset _offset;
};
+
std::ostream&
operator<< (std::ostream& s, LocalTime const & t);
+
}
+
#endif