Store and operate on date (time_t). More...

#include <Date.h>

Classes
struct	EDateFormatDef
	Date formats for printing (use like 'enum class DateFormat') More...

struct	ETimeFormatDef
	Time formats for printing (use like 'enum class TimeFormat') More...

struct	ETimeZoneFormatDef
	Timezone indicator for printing (use like 'enum class TimeZoneFormat') More...

Public Types
typedef time_t	ValueType

typedef time_t	Duration

Public Member Functions
	Date ()
	Default ctor: 0.

	Date (ValueType date_r)
	Ctor taking time_t value.

	Date (const std::string &seconds_r)
	Ctor taking time_t value as string.

	Date (const std::string &date_str, const std::string &format)
	Ctor from a date_str (in localtime) formatted using format.

	Date (const std::string &date_str, const std::string &format, TimeBase base_r)

	operator ValueType () const
	Conversion to time_t.

Static Public Member Functions
static Date	now ()
	Return the current time.

Static Public Attributes
static const ValueType	second = 1

static const ValueType	minute = 60

static const ValueType	hour = 3600

static const ValueType	day = 86400

static const ValueType	month28 = 2419200

static const ValueType	month29 = 2505600

static const ValueType	month30 = 2592000

static const ValueType	month31 = 2678400

static const ValueType	month = month30

static const ValueType	year365 = 31536000

static const ValueType	year366 = 31622400

static const ValueType	year = year365

Friends
std::ostream &	operator<< (std::ostream &str, const Date &obj)

Related Functions
(Note that these are not member functions.)
std::ostream &	operator<< (std::ostream &str, const Date &obj)
	Stream output.

std::ostream &	dumpAsXmlOn (std::ostream &str, const Date &obj, const std::string &name_r="date")
	XML output.

Arithmetic operations.
enum	TimeBase { TB_LOCALTIME , TB_UTC }

Date	operator+ (const time_t rhs) const

Date	operator- (const time_t rhs) const

Date	operator* (const time_t rhs) const

Date	operator/ (const time_t rhs) const

Date &	operator+= (const time_t rhs)

Date &	operator-= (const time_t rhs)

Date &	operator*= (const time_t rhs)

Date &	operator/= (const time_t rhs)

Date &	operator++ ()

Date &	operator-- ()

Date	operator++ (int)

Date	operator-- (int)

std::string	form (const std::string &format_r) const
	Return string representation according to format as localtime.

std::string	form (const std::string &format_r, TimeBase base_r) const

std::string	asString () const
	Default string representation of Date.

std::string	asSeconds () const
	Convert to string representation of calendar time in numeric form (like "1029255142").

Printing in various predefined formats
typedef base::EnumClass< EDateFormatDef >	DateFormat
	'enum class DateFormat'

typedef base::EnumClass< ETimeFormatDef >	TimeFormat
	'enum class TimeFormat'

typedef base::EnumClass< ETimeZoneFormatDef >	TimeZoneFormat
	'enum class TimeZoneFormat'

ValueType	_date
	Calendar time.

std::string	print (DateFormat dateFormat_r=DateFormat::calendar, TimeFormat timeFormat_r=TimeFormat::seconds, TimeZoneFormat timeZoneFormat_r=TimeZoneFormat::name, TimeBase base_r=TB_LOCALTIME) const
	Default format is `'2014-02-07 07:06:41 CET'` The default is DateFormat::calendar, TimeFormat::seconds, TimeZoneFormat::name and TB_LOCALTIME.

std::string	print (TimeFormat timeFormat_r, TimeZoneFormat timeZoneFormat_r=TimeZoneFormat::name, TimeBase base_r=TB_LOCALTIME) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	print (DateFormat dateFormat_r, TimeZoneFormat timeZoneFormat_r, TimeBase base_r=TB_LOCALTIME) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	print (DateFormat dateFormat_r, TimeFormat timeFormat_r, TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	print (TimeZoneFormat timeZoneFormat_r, TimeBase base_r=TB_LOCALTIME) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	print (TimeFormat timeFormat_r, TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	print (DateFormat dateFormat_r, TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	print (TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printDate (DateFormat dateFormat_r=DateFormat::calendar, TimeBase base_r=TB_LOCALTIME) const
	Convenience for printing the date only [`'2014-02-07'`] The default is DateFormat::calendar and TB_LOCALTIME.

std::string	printDate (TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printTime (TimeFormat timeFormat_r=TimeFormat::seconds, TimeZoneFormat timeZoneFormat_r=TimeZoneFormat::name, TimeBase base_r=TB_LOCALTIME) const
	Convenience for printing the time only [`'07:06:41 CET'`] The default is DateFormat::calendar and TB_LOCALTIME.

std::string	printTime (TimeZoneFormat timeZoneFormat_r, TimeBase base_r=TB_LOCALTIME) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printTime (TimeFormat timeFormat_r, TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printTime (TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printISO (DateFormat dateFormat_r=DateFormat::calendar, TimeFormat timeFormat_r=TimeFormat::seconds, TimeZoneFormat timeZoneFormat_r=TimeZoneFormat::name, TimeBase base_r=TB_LOCALTIME) const
	Default ISO 8601 format is `'2014-02-07T07:06:41+01'`

std::string	printISO (TimeFormat timeFormat_r, TimeZoneFormat timeZoneFormat_r=TimeZoneFormat::name, TimeBase base_r=TB_LOCALTIME) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printISO (DateFormat dateFormat_r, TimeZoneFormat timeZoneFormat_r, TimeBase base_r=TB_LOCALTIME) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printISO (DateFormat dateFormat_r, TimeFormat timeFormat_r, TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printISO (TimeZoneFormat timeZoneFormat_r, TimeBase base_r=TB_LOCALTIME) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printISO (TimeFormat timeFormat_r, TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printISO (DateFormat dateFormat_r, TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

std::string	printISO (TimeBase base_r) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Detailed Description

Store and operate on date (time_t).

Definition at line 32 of file Date.h.

Member Typedef Documentation

◆ ValueType

typedef time_t zypp::Date::ValueType

Definition at line 38 of file Date.h.

◆ Duration

typedef time_t zypp::Date::Duration

Definition at line 39 of file Date.h.

◆ DateFormat

typedef base::EnumClass<EDateFormatDef> zypp::Date::DateFormat

'enum class DateFormat'

Definition at line 142 of file Date.h.

◆ TimeFormat

typedef base::EnumClass<ETimeFormatDef> zypp::Date::TimeFormat

'enum class TimeFormat'

Definition at line 151 of file Date.h.

◆ TimeZoneFormat

typedef base::EnumClass<ETimeZoneFormatDef> zypp::Date::TimeZoneFormat

'enum class TimeZoneFormat'

Definition at line 159 of file Date.h.

Member Enumeration Documentation

◆ TimeBase

enum with explicitly given ref zypp::Date::TimeBase

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Enumerator
TB_LOCALTIME
TB_UTC

Definition at line 54 of file Date.h.

Constructor & Destructor Documentation

◆ Date() [1/5]

zypp::Date::Date ( )

inline

Default ctor: 0.

Definition at line 57 of file Date.h.

◆ Date() [2/5]

zypp::Date::Date ( ValueType date_r )

inline

Ctor taking time_t value.

Definition at line 61 of file Date.h.

◆ Date() [3/5]

zypp::Date::Date ( const std::string & seconds_r )

explicit

Ctor taking time_t value as string.

Definition at line 163 of file Date.cc.

◆ Date() [4/5]

zypp::Date::Date	(	const std::string &	date_str,
		const std::string &	format
	)

Ctor from a date_str (in localtime) formatted using format.

Exceptions

DateFormatException in case date_str cannot be parsed according to format.

Definition at line 166 of file Date.cc.

◆ Date() [5/5]

zypp::Date::Date	(	const std::string &	date_str,
		const std::string &	format,
		Date::TimeBase	base_r
	)

Definition at line 170 of file Date.cc.

Member Function Documentation

◆ now()

static Date zypp::Date::now ( )

inlinestatic

Return the current time.

Definition at line 78 of file Date.h.

◆ operator ValueType()

zypp::Date::operator ValueType ( ) const

inline

Conversion to time_t.

Definition at line 83 of file Date.h.

◆ operator+()

Date zypp::Date::operator+ ( const time_t rhs ) const

inline

Definition at line 88 of file Date.h.

◆ operator-()

Date zypp::Date::operator- ( const time_t rhs ) const

inline

Definition at line 89 of file Date.h.

◆ operator*()

Date zypp::Date::operator* ( const time_t rhs ) const

inline

Definition at line 90 of file Date.h.

◆ operator/()

Date zypp::Date::operator/ ( const time_t rhs ) const

inline

Definition at line 91 of file Date.h.

◆ operator+=()

Date & zypp::Date::operator+= ( const time_t rhs )

inline

Definition at line 93 of file Date.h.

◆ operator-=()

Date & zypp::Date::operator-= ( const time_t rhs )

inline

Definition at line 94 of file Date.h.

◆ operator*=()

Date & zypp::Date::operator*= ( const time_t rhs )

inline

Definition at line 95 of file Date.h.

◆ operator/=()

Date & zypp::Date::operator/= ( const time_t rhs )

inline

Definition at line 96 of file Date.h.

◆ operator++() [1/2]

Date & zypp::Date::operator++ ( )

inline

Definition at line 98 of file Date.h.

◆ operator--() [1/2]

Date & zypp::Date::operator-- ( )

inline

Definition at line 99 of file Date.h.

◆ operator++() [2/2]

Date zypp::Date::operator++ ( int )

inline

Definition at line 101 of file Date.h.

◆ operator--() [2/2]

Date zypp::Date::operator-- ( int )

inline

Definition at line 102 of file Date.h.

◆ form() [1/2]

std::string zypp::Date::form ( const std::string & format_r ) const

inline

Return string representation according to format as localtime.

See also: 'man strftime' (which is used internaly) for valid conversion specifiers in format.

Returns: An empty string on illegal format, "0" if date is unspecified.

Definition at line 112 of file Date.h.

◆ form() [2/2]

std::string zypp::Date::form	(	const std::string &	format_r,
		Date::TimeBase	base_r
	)		const

Definition at line 185 of file Date.cc.

◆ asString()

std::string zypp::Date::asString ( ) const

inline

Default string representation of Date.

The preferred date and time representation for the current locale.

Definition at line 120 of file Date.h.

◆ asSeconds()

std::string zypp::Date::asSeconds ( ) const

inline

Convert to string representation of calendar time in numeric form (like "1029255142").

Definition at line 126 of file Date.h.

◆ print() [1/8]

std::string zypp::Date::print	(	DateFormat	dateFormat_r = `DateFormat::calendar`,
		TimeFormat	timeFormat_r = `TimeFormat::seconds`,
		TimeZoneFormat	timeZoneFormat_r = `TimeZoneFormat::name`,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

Default format is '2014-02-07 07:06:41 CET' The default is DateFormat::calendar, TimeFormat::seconds, TimeZoneFormat::name and TB_LOCALTIME.

For other formats you don't have to repeat all the defaults, just pass the values where you differ.

Definition at line 188 of file Date.cc.

◆ print() [2/8]

std::string zypp::Date::print	(	TimeFormat	timeFormat_r,
		TimeZoneFormat	timeZoneFormat_r = `TimeZoneFormat::name`,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 168 of file Date.h.

◆ print() [3/8]

std::string zypp::Date::print	(	DateFormat	dateFormat_r,
		TimeZoneFormat	timeZoneFormat_r,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 171 of file Date.h.

◆ print() [4/8]

std::string zypp::Date::print	(	DateFormat	dateFormat_r,
		TimeFormat	timeFormat_r,
		TimeBase	base_r
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 174 of file Date.h.

◆ print() [5/8]

std::string zypp::Date::print	(	TimeZoneFormat	timeZoneFormat_r,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 177 of file Date.h.

◆ print() [6/8]

std::string zypp::Date::print	(	TimeFormat	timeFormat_r,
		TimeBase	base_r
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 180 of file Date.h.

◆ print() [7/8]

std::string zypp::Date::print	(	DateFormat	dateFormat_r,
		TimeBase	base_r
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 183 of file Date.h.

◆ print() [8/8]

std::string zypp::Date::print ( TimeBase base_r ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 186 of file Date.h.

◆ printDate() [1/2]

std::string zypp::Date::printDate	(	DateFormat	dateFormat_r = `DateFormat::calendar`,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

inline

Convenience for printing the date only ['2014-02-07'] The default is DateFormat::calendar and TB_LOCALTIME.

Definition at line 192 of file Date.h.

◆ printDate() [2/2]

std::string zypp::Date::printDate ( TimeBase base_r ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 195 of file Date.h.

◆ printTime() [1/4]

std::string zypp::Date::printTime	(	TimeFormat	timeFormat_r = `TimeFormat::seconds`,
		TimeZoneFormat	timeZoneFormat_r = `TimeZoneFormat::name`,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

inline

Convenience for printing the time only ['07:06:41 CET'] The default is DateFormat::calendar and TB_LOCALTIME.

Definition at line 201 of file Date.h.

◆ printTime() [2/4]

std::string zypp::Date::printTime	(	TimeZoneFormat	timeZoneFormat_r,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 204 of file Date.h.

◆ printTime() [3/4]

std::string zypp::Date::printTime	(	TimeFormat	timeFormat_r,
		TimeBase	base_r
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 207 of file Date.h.

◆ printTime() [4/4]

std::string zypp::Date::printTime ( TimeBase base_r ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 210 of file Date.h.

◆ printISO() [1/8]

std::string zypp::Date::printISO	(	DateFormat	dateFormat_r = `DateFormat::calendar`,
		TimeFormat	timeFormat_r = `TimeFormat::seconds`,
		TimeZoneFormat	timeZoneFormat_r = `TimeZoneFormat::name`,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

Default ISO 8601 format is '2014-02-07T07:06:41+01'

Note: As timezone names are not used in ISO, TimeZoneFormat::name is the same as TimeZoneFormat::offset when printing in TB_LOCALTIME. When printing TB_UTC it uses a 'Z' to indicate UTC (Zulu time) rather than printing '+00'.

Definition at line 204 of file Date.cc.

◆ printISO() [2/8]

std::string zypp::Date::printISO	(	TimeFormat	timeFormat_r,
		TimeZoneFormat	timeZoneFormat_r = `TimeZoneFormat::name`,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 220 of file Date.h.

◆ printISO() [3/8]

std::string zypp::Date::printISO	(	DateFormat	dateFormat_r,
		TimeZoneFormat	timeZoneFormat_r,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 223 of file Date.h.

◆ printISO() [4/8]

std::string zypp::Date::printISO	(	DateFormat	dateFormat_r,
		TimeFormat	timeFormat_r,
		TimeBase	base_r
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 226 of file Date.h.

◆ printISO() [5/8]

std::string zypp::Date::printISO	(	TimeZoneFormat	timeZoneFormat_r,
		TimeBase	base_r = `TB_LOCALTIME`
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 229 of file Date.h.

◆ printISO() [6/8]

std::string zypp::Date::printISO	(	TimeFormat	timeFormat_r,
		TimeBase	base_r
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 232 of file Date.h.

◆ printISO() [7/8]

std::string zypp::Date::printISO	(	DateFormat	dateFormat_r,
		TimeBase	base_r
	)		const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 235 of file Date.h.

◆ printISO() [8/8]

std::string zypp::Date::printISO ( TimeBase base_r ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 238 of file Date.h.

Friends And Related Function Documentation

◆ operator<< [1/2]

std::ostream & operator<<	(	std::ostream &	str,
		const Date &	obj
	)

friend

◆ operator<<() [2/2]

std::ostream & operator<<	(	std::ostream &	str,
		const Date &	obj
	)

Definition at line 252 of file Date.h.

◆ dumpAsXmlOn()

std::ostream & dumpAsXmlOn	(	std::ostream &	str,
		const Date &	obj,
		const std::string &	name_r = `"date"`
	)

Print time_t and text attribute. Allow alternate node name [date].

Definition at line 233 of file Date.cc.

Member Data Documentation

◆ second

const Date::ValueType zypp::Date::second = 1

static

Definition at line 41 of file Date.h.

◆ minute

const Date::ValueType zypp::Date::minute = 60

static

Definition at line 42 of file Date.h.

◆ hour

const Date::ValueType zypp::Date::hour = 3600

static

Definition at line 43 of file Date.h.

◆ day

const Date::ValueType zypp::Date::day = 86400

static

Definition at line 44 of file Date.h.

◆ month28

const Date::ValueType zypp::Date::month28 = 2419200

static

Definition at line 45 of file Date.h.

◆ month29

const Date::ValueType zypp::Date::month29 = 2505600

static

Definition at line 46 of file Date.h.

◆ month30

const Date::ValueType zypp::Date::month30 = 2592000

static

Definition at line 47 of file Date.h.

◆ month31

const Date::ValueType zypp::Date::month31 = 2678400

static

Definition at line 48 of file Date.h.

◆ month

const Date::ValueType zypp::Date::month = month30

static

Definition at line 49 of file Date.h.

◆ year365

const Date::ValueType zypp::Date::year365 = 31536000

static

Definition at line 50 of file Date.h.

◆ year366

const Date::ValueType zypp::Date::year366 = 31622400

static

Definition at line 51 of file Date.h.

◆ year

const Date::ValueType zypp::Date::year = year365

static

Definition at line 52 of file Date.h.

◆ _date

ValueType zypp::Date::_date

private

Calendar time.

The number of seconds elapsed since 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC).

Definition at line 247 of file Date.h.

The documentation for this class was generated from the following files:

zypp/Date.h
zypp-core/Date.cc

Classes

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Friends

Related Functions

Arithmetic operations.

Printing in various predefined formats

Detailed Description

Member Typedef Documentation

◆ ValueType

◆ Duration

◆ DateFormat

◆ TimeFormat

◆ TimeZoneFormat

Member Enumeration Documentation

◆ TimeBase

Constructor & Destructor Documentation

◆ Date() [1/5]

◆ Date() [2/5]

◆ Date() [3/5]

◆ Date() [4/5]

◆ Date() [5/5]

Member Function Documentation

◆ now()

◆ operator ValueType()

◆ operator+()

◆ operator-()

◆ operator*()

◆ operator/()

◆ operator+=()

◆ operator-=()

◆ operator*=()

◆ operator/=()

◆ operator++() [1/2]

◆ operator--() [1/2]

◆ operator++() [2/2]

◆ operator--() [2/2]

◆ form() [1/2]

◆ form() [2/2]

◆ asString()

◆ asSeconds()

◆ print() [1/8]

◆ print() [2/8]

◆ print() [3/8]

◆ print() [4/8]

◆ print() [5/8]

◆ print() [6/8]

◆ print() [7/8]

◆ print() [8/8]

◆ printDate() [1/2]

◆ printDate() [2/2]

◆ printTime() [1/4]

◆ printTime() [2/4]

◆ printTime() [3/4]

◆ printTime() [4/4]

◆ printISO() [1/8]

◆ printISO() [2/8]

◆ printISO() [3/8]

◆ printISO() [4/8]

◆ printISO() [5/8]

◆ printISO() [6/8]

◆ printISO() [7/8]

◆ printISO() [8/8]

Friends And Related Function Documentation

◆ operator<< [1/2]

◆ operator<<() [2/2]

◆ dumpAsXmlOn()

Member Data Documentation

◆ second

◆ minute

◆ hour

◆ day

◆ month28

◆ month29

◆ month30

◆ month31

◆ month

◆ year365