Description:

Represents a date in the systems calendar without the provision of a clock time. This class internally uses types DateTime and CalendarDateTime to perform operators +, -, += and -=, but is much more efficient with in- and decrement operators ++ and –. Furthermore it uses only 32-bits of storage.

Besides storing clock-time agnostic date values, the type is useful to securely iterate over dates, because there is no risk of false comparisons due to mixed time-zone and daylight saving properties and in general due to arbitrarily set clock times.

Another small difference is that field DayOfWeek is always kept in a reliable (correct) state, which is not the case with field CalendarDateTime::DayOfWeek.

Internally, the values are stored a 32-bit storage word using the following scheme

bits 1-3 encode the day of week (from 0 (= Sunday) to 6 (= Saturday)
bits 4-8 encode the calendar day (1..31)
bits 9-12 encode the calendar month (1..12)
bits 13-32 encode the calendar year consequently, for the calendar year 20 bits are available, which evaluates to a range of 1,048,576 years. For simplicity and speed, the values are not defined in accordance to class CalendarDateTime, where a value of 0 represents year 1900. This class just stores the year value as is and does not allow negative values. As a result, this class is capable of storing values between 1/1/0000 and 12/31/1,048,576.

Definition at line 354 of file calendar.inl.

Public Method Index:
	CalendarDate ()=default
	Default constructor leaving this object uninitialized (random value). **************.

	CalendarDate (CalendarDate &&) noexcept=default
	Trivial default move constructor. ***************************************************.

	CalendarDate (const CalendarDate &) noexcept=default
	Trivial default copy constructor. ***************************************************.

ALIB_DLL	CalendarDate (const CalendarDateTime &calendarDateTime)

	CalendarDate (const DateTime &dateTime, lang::Timezone timezone)

	CalendarDate (int year, int month, int day, int dayOfWeek=-1)

	CalendarDate (lang::Timezone timezone)

	~CalendarDate () noexcept=default
	Trivial default destructor. ***************************************************.

int	Day () const

int	DayOfWeek () const

ALIB_DLL DateTime	Get (lang::Timezone timezone=lang::Timezone::Local, int hour=12, int minute=0, int second=0) const

int	Month () const

bool	operator!= (const CalendarDate &other) const

ALIB_DLL CalendarDate	operator+ (int daysToAdd) const

ALIB_DLL CalendarDate	operator++ ()

CalendarDate	operator++ (int)

CalendarDate	operator+= (int daysToAdd)

CalendarDate	operator- (int daysToSubtract) const

ALIB_DLL CalendarDate	operator-- ()

CalendarDate	operator-- (int)

CalendarDate	operator-= (int daysToSubtract)

bool	operator< (const CalendarDate &other) const

bool	operator<= (const CalendarDate &other) const

CalendarDate &	operator= (CalendarDate &&) noexcept=default

CalendarDate &	operator= (const CalendarDate &) noexcept=default

bool	operator== (const CalendarDate &other) const

bool	operator> (const CalendarDate &other) const

bool	operator>= (const CalendarDate &other) const

ALIB_DLL void	Set (const DateTime &dateTime, lang::Timezone timezone)

ALIB_DLL void	Set (int year, int month, int day, int dayOfWeek=-1)

ALIB_DLL CalendarDateTime	ToCalendarDateTime () const

int	Year () const

Protected Field Index:
uint32_t	stamp
	Encoded date value.

Field Details:

◆ stamp

uint32_t alib::strings::util::CalendarDate::stamp

protected

Encoded date value.

Definition at line 357 of file calendar.inl.

Constructor(s) / Destructor Details:

◆ CalendarDate() [1/4]

alib::strings::util::CalendarDate::CalendarDate	(	int	year,
		int	month,
		int	day,
		int	dayOfWeek = -1 )

inline

Constructor taking the date as separated values.

Parameters

year	The year to use. Must be between 0 and 1,048,575
month	The month to use. Must be between 1 and 12
day	The day to use. Must be between 1 and 31
dayOfWeek	The day of week that results from the previous values. Defaults to `-1` which instructs this constructor to retrieve that correct value. If given, values must be between 0 (Sunday) and 6 (Saturday). In debug compilations an assertion will be raised if the value is out of range or inconsistent.

Definition at line 395 of file calendar.inl.

Here is the call graph for this function:

◆ CalendarDate() [2/4]

alib::strings::util::CalendarDate::CalendarDate ( lang::Timezone timezone )

inlineexplicit

Constructor creating a date that represents "today".

Parameters

timezone Determines whether the local time zone should be used or UTC.

Definition at line 405 of file calendar.inl.

Here is the call graph for this function:

◆ CalendarDate() [3/4]

ALIB_DLL alib::strings::util::CalendarDate::CalendarDate ( const CalendarDateTime & calendarDateTime )

inlineexplicit

Constructor taking a DateTime value.

Parameters

calendarDateTime The value to take the date from.

Definition at line 415 of file calendar.inl.

Here is the call graph for this function:

◆ CalendarDate() [4/4]

alib::strings::util::CalendarDate::CalendarDate	(	const DateTime &	dateTime,
		lang::Timezone	timezone )

inline

Constructor taking a DateTime value.

Parameters

dateTime	The value to take the date from.
timezone	Determines whether the local time zone should be used or UTC.

Definition at line 428 of file calendar.inl.

Here is the call graph for this function:

Method Details:

◆ Day()

int alib::strings::util::CalendarDate::Day ( ) const

inline

Extracts the day of month from this date as a value between 1 and 31.

Returns: The calendar day of month.

Definition at line 496 of file calendar.inl.

◆ DayOfWeek()

int alib::strings::util::CalendarDate::DayOfWeek ( ) const

inline

Extracts the day of week from this date as a value between 0 (representing sunday) and 6 (representing Saturday) in accordance with field CalendarDateTime::DayOfWeek.

Returns: The calendar day of month.

Definition at line 502 of file calendar.inl.

◆ Get()

DateTime alib::strings::util::CalendarDate::Get	(	lang::Timezone	timezone = lang::Timezone::Local,
		int	hour = 12,
		int	minute = 0,
		int	second = 0 ) const

Creates a DateTime object from this calendar date.

Attention: The resolution and possible time range of class DateTime is platform-dependent. This method must not be used if inconsistent values are stored.

Parameters

timezone	Denote if the time that is calculated should be local or UTC. Defaults to `TimeZone::Local`.
hour	The hour of day (0..23) that the value returned should represent. Defaults to noon time (`12`).
minute	The minute of the hour (0..59) that the value returned should represent. Defaults to `0`.
second	The second of the minute (0..59) that the value returned should represent. Defaults to `0`.

Returns: The point in time represented by this class and the given clock values.

Definition at line 252 of file calendar.cpp.

Here is the call graph for this function:

◆ Month()

int alib::strings::util::CalendarDate::Month ( ) const

inline

Extracts the month from this date as a value between 1 and 12.

Returns: The calendar day of month.

Definition at line 492 of file calendar.inl.

◆ operator!=()

bool alib::strings::util::CalendarDate::operator!= ( const CalendarDate & other ) const

inline

Not equal to operator.

Parameters

other The date stamp to compare.

Returns: The result of the comparison.

Definition at line 597 of file calendar.inl.

Here is the call graph for this function:

◆ operator+()

CalendarDate alib::strings::util::CalendarDate::operator+ ( int daysToAdd ) const

Adds the given number of days to this date.

Parameters

daysToAdd The days to add. May be negative for subtraction.

Returns: A copy of this object after modification.

Definition at line 257 of file calendar.cpp.

Here is the call graph for this function:

◆ operator++() [1/2]

CalendarDate alib::strings::util::CalendarDate::operator++ ( )

Prefix increment operator.

Returns: A copy of this object after modification.

Definition at line 265 of file calendar.cpp.

Here is the call graph for this function:

◆ operator++() [2/2]

CalendarDate alib::strings::util::CalendarDate::operator++ ( int )

inline

Postfix increment operator.

Returns: A copy of this object before its modification.

Definition at line 542 of file calendar.inl.

Here is the call graph for this function:

◆ operator+=()

CalendarDate alib::strings::util::CalendarDate::operator+= ( int daysToAdd )

inline

Adds the given number of days to this date.

Parameters

daysToAdd The days to add. May be negative for subtraction.

Returns: A copy of this object after modification.

Definition at line 565 of file calendar.inl.

Here is the call graph for this function:

◆ operator-()

CalendarDate alib::strings::util::CalendarDate::operator- ( int daysToSubtract ) const

inline

Subtracts the given number of days to this date.

Parameters

daysToSubtract The days to add. May be negative for additions.

Returns: A copy of this object after modification.

Definition at line 519 of file calendar.inl.

Here is the call graph for this function:

◆ operator--() [1/2]

CalendarDate alib::strings::util::CalendarDate::operator-- ( )

Prefix decrement operator.

Returns: A copy of this object after modification.

Definition at line 298 of file calendar.cpp.

Here is the call graph for this function:

◆ operator--() [2/2]

CalendarDate alib::strings::util::CalendarDate::operator-- ( int )

inline

Postfix decrement operator.

Returns: A copy of this object before its modification.

Definition at line 553 of file calendar.inl.

Here is the call graph for this function:

◆ operator-=()

CalendarDate alib::strings::util::CalendarDate::operator-= ( int daysToSubtract )

inline

Subtracts the given number of days to this date.

Parameters

daysToSubtract The days to add. May be negative for additons.

Returns: A copy of this object after modification.

Definition at line 575 of file calendar.inl.

Here is the call graph for this function:

◆ operator<()

bool alib::strings::util::CalendarDate::operator< ( const CalendarDate & other ) const

inline

Less than operator.

Parameters

other The date stamp to compare.

Returns: A reference to this object.

Definition at line 607 of file calendar.inl.

Here is the call graph for this function:

◆ operator<=()

bool alib::strings::util::CalendarDate::operator<= ( const CalendarDate & other ) const

inline

Less than or equal to operator.

Parameters

other The date stamp to compare.

Returns: The result of the comparison.

Definition at line 617 of file calendar.inl.

Here is the call graph for this function:

◆ operator=() [1/2]

CalendarDate & alib::strings::util::CalendarDate::operator= ( CalendarDate && )

defaultnoexcept

Trivial default move assign operator.

Returns: A reference to this. ***************************************************

Here is the call graph for this function:

◆ operator=() [2/2]

CalendarDate & alib::strings::util::CalendarDate::operator= ( const CalendarDate & )

defaultnoexcept

Trivial default copy assign operator.

Returns: A reference to this. ***************************************************

Here is the call graph for this function:

◆ operator==()

bool alib::strings::util::CalendarDate::operator== ( const CalendarDate & other ) const

inline

Equal to operator.

Parameters

other The date stamp to compare.

Returns: The result of the comparison.

Definition at line 587 of file calendar.inl.

Here is the call graph for this function:

◆ operator>()

bool alib::strings::util::CalendarDate::operator> ( const CalendarDate & other ) const

inline

Greater than operator.

Parameters

other The date stamp to compare.

Returns: The result of the comparison.

Definition at line 627 of file calendar.inl.

Here is the call graph for this function:

◆ operator>=()

bool alib::strings::util::CalendarDate::operator>= ( const CalendarDate & other ) const

inline

Greater than or equal to operator.

Parameters

other The date stamp to compare.

Returns: The result of the comparison.

Definition at line 637 of file calendar.inl.

Here is the call graph for this function:

◆ Set() [1/2]

void alib::strings::util::CalendarDate::Set	(	const DateTime &	dateTime,
		lang::Timezone	timezone )

Sets this class to the date represented by the given DateTime instance.

Parameters

dateTime	The value to take the date from.
timezone	Determines whether the local time zone applies to `dateTime` or whether it refers to UTC.

Definition at line 215 of file calendar.cpp.

◆ Set() [2/2]

void alib::strings::util::CalendarDate::Set	(	int	year,
		int	month,
		int	day,
		int	dayOfWeek = -1 )

Sets this class to the given values.

Parameters

year	The year to use. Must be between 0 and 1,048,575
month	The month to use. Must be between 1 and 12
day	The day to use. Must be between 1 and 31
dayOfWeek	The day of week that results from the previous values. Defaults to `-1` which instructs this constructor to retrieve that correct value. If given, values must be between 0 (Sunday) and 6 (Saturday). In debug compilations an assertion will be raised if the value is out of range or inconsistent.

Definition at line 223 of file calendar.cpp.

Here is the call graph for this function:

◆ ToCalendarDateTime()

ALIB_DLL CalendarDateTime alib::strings::util::CalendarDate::ToCalendarDateTime ( ) const

Returns a date and time value, by adding 12 o'clock noon time.

Returns: A corresponding DateTime value.

◆ Year()

int alib::strings::util::CalendarDate::Year ( ) const

inline

Extracts the day of month from this date as a value between 1 and 31.

Returns: The calendar day of month.

Definition at line 488 of file calendar.inl.

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

Description:

Public Method Index:

Protected Field Index:

Field Details:

◆ stamp

Constructor(s) / Destructor Details:

◆ CalendarDate() [1/4]

◆ CalendarDate() [2/4]

◆ CalendarDate() [3/4]

◆ CalendarDate() [4/4]

Method Details:

◆ Day()

◆ DayOfWeek()

◆ Get()

◆ Month()

◆ operator!=()

◆ operator+()

◆ operator++() [1/2]

◆ operator++() [2/2]

◆ operator+=()

◆ operator-()

◆ operator--() [1/2]

◆ operator--() [2/2]

◆ operator-=()

◆ operator<()

◆ operator<=()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ operator>()

◆ operator>=()

◆ Set() [1/2]

◆ Set() [2/2]

◆ ToCalendarDateTime()

◆ Year()