doc/c%2B%2Butilities/chronotests_8cpp_source.html

#define CHRONO_UTILITIES_TIMESPAN_INTEGER_SCALE_OVERLOADS


#include "../chrono/datetime.h"

#include "../chrono/format.h"

#include "../chrono/period.h"

#include "../chrono/timespan.h"

#include "../conversion/conversionexception.h"

#include "../tests/testutils.h"


#include <cppunit/TestFixture.h>

#include <cppunit/extensions/HelperMacros.h>


#include <chrono>

#include <cmath>

#include <iostream>


using namespace std;

using namespace CppUtilities;

using namespace CppUtilities::Literals;


using namespace CPPUNIT_NS;


// compile-time checks for DateTime class

static_assert(DateTime().isNull(), "isNull()");

static_assert(DateTime(1).totalTicks() == 1, "construction with ticks");

static_assert(DateTime(2) == DateTime(2), "operator ==");

static_assert(DateTime(2) != DateTime(3), "operator !=");

static_assert(DateTime(2) < DateTime(3), "operator <");

static_assert(DateTime(3) > DateTime(2), "operator >");

static_assert(DateTime::eternity().isEternity() && !DateTime().isEternity(), "isEternity()");

static constexpr auto dateFromUnixEpoch(

    DateTime::unixEpochStart() + TimeSpan::fromHours(1.0) + TimeSpan::fromMinutes(2.0) + TimeSpan::fromSeconds(3.1256789));

static_assert(dateFromUnixEpoch.dayOfWeek() == DayOfWeek::Thursday, "dayOfWeek()");

static_assert(dateFromUnixEpoch.hour() == 1, "hour()");

static_assert(dateFromUnixEpoch.minute() == 2, "minute()");

static_assert(dateFromUnixEpoch.second() == 3, "second()");

static_assert(dateFromUnixEpoch.millisecond() == 125, "millisecond()");

static_assert(dateFromUnixEpoch.microsecond() == 678, "microsecond()");

static_assert(dateFromUnixEpoch.nanosecond() == 900, "nanosecond()");

static_assert(dateFromUnixEpoch.isSameDay(DateTime::unixEpochStart()), "isSameDay()");

static_assert(!dateFromUnixEpoch.isSameDay(DateTime::unixEpochStart() + TimeSpan::fromHours(24.0)), "!isSameDay()");


// compile-time checks for TimeSpan class

static_assert(TimeSpan().isNull(), "isNull()");

static_assert(TimeSpan(1).totalTicks() == 1, "construction with ticks");

static_assert(TimeSpan(-1).isNegative() && !TimeSpan(1).isNegative(), "isNegative()");

static_assert(TimeSpan::infinity().isInfinity() && !TimeSpan().isInfinity(), "isInfinity()");

static_assert(TimeSpan::negativeInfinity().isNegativeInfinity() && !TimeSpan().isNegativeInfinity(), "isNegativeInfinity()");

static_assert(TimeSpan::fromMilliseconds(1.0125).nanoseconds() == 500, "fromMilliseconds()/nanoseconds()");

static_assert(TimeSpan::fromMilliseconds(1.0125).microseconds() == 12, "fromMilliseconds()/microseconds()");

static_assert(TimeSpan::fromMilliseconds(1.0125).milliseconds() == 1, "fromMilliseconds()/milliseconds()");

static_assert(TimeSpan::fromSeconds(TimeSpan::TickType(61)).seconds() == 1, "fromSeconds()/seconds()");

static_assert(TimeSpan::fromSeconds(TimeSpan::TickType(61)).minutes() == 1, "fromSeconds()/minutes()");

static_assert(TimeSpan::fromMinutes(TimeSpan::TickType(61)).minutes() == 1, "fromMinutes()/minutes()");

static_assert(TimeSpan::fromHours(TimeSpan::TickType(25)).hours() == 1, "fromMinutes()/hours()");

static_assert(TimeSpan::fromDays(20.5).days() == 20, "fromDays()/days()");

static_assert(TimeSpan::fromMinutes(1.5).totalMicroseconds() == 90e6, "totalMicroseconds()");

static_assert(TimeSpan::fromMinutes(1.5).totalMilliseconds() == 90e3, "totalMilliseconds()");

static_assert(TimeSpan::fromMinutes(1.5).totalSeconds() == 90.0, "totalSeconds()");

static_assert(TimeSpan::fromHours(1.5).totalMinutes() == 90.0, "totalMinutes()");

static_assert(TimeSpan::fromDays(1.5).totalHours() == 36.0, "totalHours()");

static_assert(TimeSpan::fromDays(20.5).totalDays() == 20.5, "totalDays()");


class ChronoTests : public TestFixture {

    CPPUNIT_TEST_SUITE(ChronoTests);

    CPPUNIT_TEST(testDateTime);

    CPPUNIT_TEST(testDateTimeExpression);

    CPPUNIT_TEST(testTimeSpan);

    CPPUNIT_TEST(testOperators);

    CPPUNIT_TEST(testPeriod);

    CPPUNIT_TEST(testHashing);

    CPPUNIT_TEST_SUITE_END();


public:


    void setUp()

    {

    }


    void tearDown()

    {

    }


    void testDateTime();

    void testDateTimeExpression();

    void testTimeSpan();

    void testOperators();

    void testPeriod();

    void testHashing();

};


CPPUNIT_TEST_SUITE_REGISTRATION(ChronoTests);


void ChronoTests::testDateTime()

{

    // test year(), month(), ...

    CPPUNIT_ASSERT_EQUAL(DateTime::daysInMonth(2000, 2), 29);

    CPPUNIT_ASSERT_EQUAL(DateTime::daysInMonth(2001, 2), 28);

    CPPUNIT_ASSERT_EQUAL(DateTime::daysInMonth(2100, 2), 28);

    const auto test1 = DateTime::fromDateAndTime(2012, 2, 29, 15, 34, 20, 33.0);

    CPPUNIT_ASSERT_EQUAL(2012, test1.year());

    CPPUNIT_ASSERT_EQUAL(2, test1.month());

    CPPUNIT_ASSERT_EQUAL(29, test1.day());

    CPPUNIT_ASSERT_EQUAL(15, test1.hour());

    CPPUNIT_ASSERT_EQUAL(34, test1.minute());

    CPPUNIT_ASSERT_EQUAL(20, test1.second());

    CPPUNIT_ASSERT_EQUAL(33, test1.millisecond());

    CPPUNIT_ASSERT_EQUAL(DayOfWeek::Wednesday, test1.dayOfWeek());

    CPPUNIT_ASSERT_EQUAL((31 + 29), test1.dayOfYear());

    CPPUNIT_ASSERT(test1.isLeapYear());

    CPPUNIT_ASSERT(test1.isSameDay(test1 + TimeSpan::fromHours(8.0)));

    CPPUNIT_ASSERT(!test1.isSameDay(test1 + TimeSpan::fromHours(9.0)));

    CPPUNIT_ASSERT_EQUAL("Wed 2012-02-29 15:34:20.033"s, test1.toString(DateTimeOutputFormat::DateTimeAndShortWeekday));

    const auto test2 = DateTime::fromDateAndTime(1, 1, 1, 15, 34, 20, 33.0);

    CPPUNIT_ASSERT_EQUAL(1, test2.year());

    CPPUNIT_ASSERT_EQUAL(1, test2.month());

    CPPUNIT_ASSERT_EQUAL(1, test2.day());

    CPPUNIT_ASSERT_EQUAL(15, test2.hour());

    CPPUNIT_ASSERT_EQUAL(34, test2.minute());

    CPPUNIT_ASSERT_EQUAL(20, test2.second());

    CPPUNIT_ASSERT_EQUAL(33, test2.millisecond());


    // test fromTimeStamp()/toTimeStamp()

    const auto timeStamp = static_cast<time_t>(1453840331);

    const auto fromTimeStampGmt = DateTime::fromTimeStampGmt(timeStamp), fromTimeStamp = DateTime::fromTimeStamp(timeStamp);

    CPPUNIT_ASSERT_EQUAL("Tue 2016-01-26 20:32:11"s, fromTimeStampGmt.toString(DateTimeOutputFormat::DateTimeAndShortWeekday));

    CPPUNIT_ASSERT(fabs((fromTimeStamp - fromTimeStampGmt).totalDays()) <= 1.0);

    CPPUNIT_ASSERT_EQUAL(DateTime(), DateTime::fromTimeStamp(0));

    CPPUNIT_ASSERT_EQUAL(timeStamp, fromTimeStampGmt.toTimeStamp());


    // test fromChronoTimePointGmt()

    const auto fromChronoTimePointGmt = DateTime::fromChronoTimePointGmt(chrono::system_clock::from_time_t(timeStamp));

    CPPUNIT_ASSERT_EQUAL("Tue 2016-01-26 20:32:11"s, fromChronoTimePointGmt.toString(DateTimeOutputFormat::DateTimeAndShortWeekday));


    // test whether ConversionException() is thrown when invalid values are specified

    CPPUNIT_ASSERT_THROW(DateTime::fromDate(0, 1, 1), ConversionException);

    CPPUNIT_ASSERT_THROW(DateTime::fromDate(2012, 15, 1), ConversionException);

    CPPUNIT_ASSERT_THROW(DateTime::fromDateAndTime(0, 2, 29, 15, 34, 20, 33), ConversionException);

    CPPUNIT_ASSERT_THROW(DateTime::fromDateAndTime(2013, 2, 29, 15, 34, 20, 33), ConversionException);

    CPPUNIT_ASSERT_THROW(DateTime::fromDateAndTime(2012, 2, 29, 15, 61, 20, 33), ConversionException);

    CPPUNIT_ASSERT_THROW(DateTime::fromDateAndTime(2012, 4, 31, 15, 0, 20, 33), ConversionException);

    CPPUNIT_ASSERT_THROW(DateTime::fromDateAndTime(2012, 3, 31, 15, 0, 61, 33), ConversionException);

    CPPUNIT_ASSERT_THROW(DateTime::fromDateAndTime(2012, 1, 1, 61, 2, 1), ConversionException);

    CPPUNIT_ASSERT_THROW(DateTime::fromDateAndTime(2012, 1, 1, 15, 2, 1, 2000.0), ConversionException);


    // test fromString()/toString()

    CPPUNIT_ASSERT_EQUAL(test1, DateTime::fromString("2012-02-29 15:34:20.033"));

    CPPUNIT_ASSERT_EQUAL_MESSAGE("surplus parts ignored", test1, DateTime::fromString("2012-02-29 15:34:20.033:12"));

    CPPUNIT_ASSERT_EQUAL("2012-02-29 15:34:20.033"s, test1.toString(DateTimeOutputFormat::DateAndTime, false));

    CPPUNIT_ASSERT_THROW(TimeSpan::fromString("2012-02-29 15:34:34:20.033"), ConversionException);

    const auto test3 = DateTime::fromIsoString("2016-08-29T21:32:31.125+02:00");

    CPPUNIT_ASSERT_EQUAL("2016-08-29T21:32:31.125+02:00"s, test3.first.toIsoString(test3.second));

    CPPUNIT_ASSERT_THROW(DateTime::fromString("#"), ConversionException);

    // test accuracy (of 100 nanoseconds)

    const auto test4 = DateTime::fromIsoString("2017-08-23T19:40:15.985077682+02:30");

    CPPUNIT_ASSERT_EQUAL(2.5, test4.second.totalHours());

    CPPUNIT_ASSERT_EQUAL(15, test4.first.second());

    CPPUNIT_ASSERT_EQUAL(985, test4.first.millisecond());

    CPPUNIT_ASSERT_EQUAL(77, test4.first.microsecond());

    CPPUNIT_ASSERT_EQUAL(600, test4.first.nanosecond());

    CPPUNIT_ASSERT_EQUAL("2017-08-23T19:40:15.9850776+02:30"s, test4.first.toIsoString(test4.second));

    // test negative delta

    const auto test5 = DateTime::fromIsoString("2017-08-23T19:40:15.985077682-02:30");

    CPPUNIT_ASSERT_EQUAL(-2.5, test5.second.totalHours());

    CPPUNIT_ASSERT_EQUAL(15, test5.first.second());

    CPPUNIT_ASSERT_EQUAL(985, test5.first.millisecond());

    CPPUNIT_ASSERT_EQUAL(77, test5.first.microsecond());

    CPPUNIT_ASSERT_EQUAL(600, test5.first.nanosecond());

    CPPUNIT_ASSERT_EQUAL("2017-08-23T19:40:15.9850776-02:30"s, test5.first.toIsoString(test5.second));

    // test further variants

    CPPUNIT_ASSERT_EQUAL_MESSAGE("only year", DateTime::fromDate(2008), DateTime::fromIsoStringGmt("2008"));

    CPPUNIT_ASSERT_EQUAL_MESSAGE("only year and month", DateTime::fromDate(2008, 12), DateTime::fromIsoStringGmt("2008-12"));

    CPPUNIT_ASSERT_EQUAL_MESSAGE("only date", DateTime::fromDate(2008, 12, 5), DateTime::fromIsoStringGmt("2008-12-05"));

    CPPUNIT_ASSERT_EQUAL_MESSAGE("Zulu time", TimeSpan(), DateTime::fromIsoString("2017-08-23T19:40:15.985077682Z").second);

    CPPUNIT_ASSERT_EQUAL_MESSAGE("no minutes", TimeSpan::fromHours(3.0), DateTime::fromIsoString("2017-08-23T19:40:15.985077682+03").second);

    const auto test6 = DateTime::fromIsoString("1970-01-01T01:02:03+01:00");

    CPPUNIT_ASSERT_EQUAL_MESSAGE("no seconds fraction (positive timezone offset, 1)", DateTime::fromDateAndTime(1970, 1, 1, 1, 2, 3), test6.first);

    CPPUNIT_ASSERT_EQUAL_MESSAGE("no seconds fraction (positive timezone offset, 2)", TimeSpan::fromHours(1.0), test6.second);

    const auto test7 = DateTime::fromIsoString("2021-05-20T23:02:45-04:00");

    CPPUNIT_ASSERT_EQUAL_MESSAGE("no seconds fraction (negative timezone offset, 1)", DateTime::fromDateAndTime(2021, 5, 20, 23, 2, 45), test7.first);

    CPPUNIT_ASSERT_EQUAL_MESSAGE("no seconds fraction (negative timezone offset, 2)", TimeSpan::fromHours(-4.0), test7.second);

    // implied separators / too many digits

    CPPUNIT_ASSERT_EQUAL_MESSAGE("no separators", test5.first - test5.second, DateTime::fromIsoStringGmt("20170823T194015.985077682-0230"));

    CPPUNIT_ASSERT_EQUAL_MESSAGE(

        "not even T separator", DateTime::fromDateAndTime(2017, 8, 23, 19, 40, 15), DateTime::fromIsoStringGmt("20170823194015"));

    CPPUNIT_ASSERT_THROW_MESSAGE("too many digits after seconds", DateTime::fromIsoString("2017082319401516"), ConversionException);

    CPPUNIT_ASSERT_THROW_MESSAGE("too many digits after timezone offset", DateTime::fromIsoString("20170823194015.16+02300"), ConversionException);

    // test invalid characters

    CPPUNIT_ASSERT_THROW_MESSAGE("digits after Z", DateTime::fromIsoString("2017-O8-23T19:40:15.985077682Z02:00"), ConversionException);

    CPPUNIT_ASSERT_THROW_MESSAGE("invalid letter", DateTime::fromIsoString("2017-O8-23T19:40:15.985077682:+02:00"), ConversionException);

    CPPUNIT_ASSERT_THROW_MESSAGE("invalid T", DateTime::fromIsoString("2017-08-23T19:T40:15.985077682+02:00"), ConversionException);

    CPPUNIT_ASSERT_THROW_MESSAGE("invalid -", DateTime::fromIsoString("2017-08-23T19:40-15.985077682+02:00"), ConversionException);

    CPPUNIT_ASSERT_THROW_MESSAGE("invalid .", DateTime::fromIsoString("2017-08.5-23T19:40:15.985077682+02:00"), ConversionException);

    CPPUNIT_ASSERT_THROW_MESSAGE("invalid :", DateTime::fromIsoString("2017:08-23T19:40:15.985077682+02:00"), ConversionException);

    CPPUNIT_ASSERT_THROW_MESSAGE("invalid :", DateTime::fromIsoString("2017-08-23T19:40:15:985077682+02:00"), ConversionException);

    // ISO string via toString() format option

    CPPUNIT_ASSERT_EQUAL("1234-05-06T07:08:09.0105005"s, DateTime::fromDateAndTime(1234, 5, 6, 7, 8, 9, 10.5005).toString(DateTimeOutputFormat::Iso));

    CPPUNIT_ASSERT_EQUAL("1234-05-06T07:08:09.0105005"s,

        DateTime::fromDateAndTime(1234, 5, 6, 7, 8, 9, 10.5005).toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));

    CPPUNIT_ASSERT_EQUAL("1234-05-06T07:08:09.010500"s,

        DateTime::fromDateAndTime(1234, 5, 6, 7, 8, 9, 10.500).toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));

    CPPUNIT_ASSERT_EQUAL(

        "1234-05-06T07:08:09.010"s, DateTime::fromDateAndTime(1234, 5, 6, 7, 8, 9, 10).toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));

    CPPUNIT_ASSERT_EQUAL(

        "1234-05-06T07:08:09"s, DateTime::fromDateAndTime(1234, 5, 6, 7, 8, 9).toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));

    CPPUNIT_ASSERT_EQUAL(

        "1234-05-06T07:08"s, DateTime::fromDateAndTime(1234, 5, 6, 7, 8).toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));

    CPPUNIT_ASSERT_EQUAL("1234-05-06T07"s, DateTime::fromDateAndTime(1234, 5, 6, 7).toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));

    CPPUNIT_ASSERT_EQUAL("1234-05-06"s, DateTime::fromDateAndTime(1234, 5, 6).toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));

    CPPUNIT_ASSERT_EQUAL("1234-05"s, DateTime::fromDateAndTime(1234, 5).toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));

    CPPUNIT_ASSERT_EQUAL("1234"s, DateTime::fromDateAndTime(1234).toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));

    CPPUNIT_ASSERT_EQUAL("0001"s, DateTime().toString(DateTimeOutputFormat::IsoOmittingDefaultComponents));


// test now() and exactNow() (or at least whether both behave the same)

#if defined(PLATFORM_UNIX)

    const auto delta = DateTime::gmtNow() - DateTime::exactGmtNow();

    CPPUNIT_ASSERT(delta < TimeSpan::fromSeconds(2.0) && delta > TimeSpan::fromSeconds(-2.0));

#endif

}


void ChronoTests::testDateTimeExpression()

{

    // check adding ISO timestamp parts one-by-one and serialization back to string

    auto expr = DateTimeExpression::fromIsoString("1");

    auto parts = DateTimeParts::Year;

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts, expr.parts);

    CPPUNIT_ASSERT_EQUAL("0001"s, expr.toIsoString());

    expr = DateTimeExpression::fromIsoString("1-1");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Month, expr.parts);

    CPPUNIT_ASSERT_EQUAL("0001-01"s, expr.toIsoString());

    expr = DateTimeExpression::fromIsoString("1-1-1");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Day, expr.parts);

    CPPUNIT_ASSERT_EQUAL("0001-01-01"s, expr.toIsoString());

    expr = DateTimeExpression::fromIsoString("1-1-1T0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Hour, expr.parts);

    CPPUNIT_ASSERT_EQUAL("0001-01-01T00"s, expr.toIsoString());

    expr = DateTimeExpression::fromIsoString("1-1-1T0:0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Minute, expr.parts);

    CPPUNIT_ASSERT_EQUAL("0001-01-01T00:00"s, expr.toIsoString());

    expr = DateTimeExpression::fromIsoString("1-1-1T0:0:0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Second, expr.parts);

    CPPUNIT_ASSERT_EQUAL("0001-01-01T00:00:00"s, expr.toIsoString());

    expr = DateTimeExpression::fromIsoString("1-1-1T0:0:0.0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::SubSecond, expr.parts);

    CPPUNIT_ASSERT_EQUAL("0001-01-01T00:00:00.000"s, expr.toIsoString());

    expr = DateTimeExpression::fromIsoString("1-1-1T0:0:0.0+0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::DeltaHour, expr.parts);

    CPPUNIT_ASSERT_EQUAL("0001-01-01T00:00:00.000+00"s, expr.toIsoString());

    expr = DateTimeExpression::fromIsoString("1-1-1T0:0:0.0-0:0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::DeltaMinute, expr.parts);

    CPPUNIT_ASSERT_EQUAL("0001-01-01T00:00:00.000+00:00"s, expr.toIsoString());


    // check that omitting parts in the middle is not possible anyways

    CPPUNIT_ASSERT_THROW(DateTimeExpression::fromIsoString("1-1T0"), ConversionException);


    // check ::fromString()

    expr = DateTimeExpression::fromString("1");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts = DateTimeParts::Year, expr.parts);

    expr = DateTimeExpression::fromString("1/1");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Month, expr.parts);

    expr = DateTimeExpression::fromString("1/1/1");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Day, expr.parts);

    expr = DateTimeExpression::fromString("1/1/1 0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Hour, expr.parts);

    expr = DateTimeExpression::fromString("1/1/1 0:0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Minute, expr.parts);

    expr = DateTimeExpression::fromString("1/1/1 0:0:0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::Second, expr.parts);

    expr = DateTimeExpression::fromString("1/1/1 0:0:0.0");

    CPPUNIT_ASSERT_EQUAL(DateTime(), expr.value);

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), expr.delta);

    CPPUNIT_ASSERT_EQUAL(parts |= DateTimeParts::SubSecond, expr.parts);

}


void ChronoTests::testTimeSpan()

{

    // test various usages of fromString(...), all other from...() functions and the plus operator

    CPPUNIT_ASSERT_EQUAL(TimeSpan(), TimeSpan::fromString(string()));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromSeconds(5.0), TimeSpan::fromString("5.0"));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromMinutes(5.5), TimeSpan::fromString("5:30"));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromHours(7.0) + TimeSpan::fromMinutes(5.5), TimeSpan::fromString("7:5:30"));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromDays(14.0), TimeSpan::fromString("14:::"));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromDays(14.0), TimeSpan::fromString("14d"));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromDays(14.0) + TimeSpan::fromHours(5.0), TimeSpan::fromString("14d 5h"));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromDays(14.0) + TimeSpan::fromMinutes(5.0), TimeSpan::fromString(" 14d   5m"));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromDays(14.0) + TimeSpan::fromMinutes(5.0) + TimeSpan::fromSeconds(24.5), TimeSpan::fromString("2 w 24.5s 5m "));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromDays(14.0) + TimeSpan::fromSeconds(24.5), TimeSpan::fromString("2 w 24.5"));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromDays(14.0) + TimeSpan::fromString("1:2:3:4"), TimeSpan::fromString("2 w 1:2:3:4"));

    CPPUNIT_ASSERT_THROW(TimeSpan::fromString("2:34a:53:32.5"), ConversionException);

    CPPUNIT_ASSERT_THROW(TimeSpan::fromString("1:2:3:4:5"), ConversionException);


    // test fromString(...) again and days(), hours(), ...

    const auto test1 = TimeSpan::fromString("2:34:53:2.5");

    CPPUNIT_ASSERT_EQUAL(3, test1.days());

    CPPUNIT_ASSERT_EQUAL(10, test1.hours());

    CPPUNIT_ASSERT_EQUAL(53, test1.minutes());

    CPPUNIT_ASSERT_EQUAL(2, test1.seconds());

    CPPUNIT_ASSERT_EQUAL(500, test1.milliseconds());

    CPPUNIT_ASSERT(test1.totalDays() > 3.0 && test1.totalDays() < 4.0);

    CPPUNIT_ASSERT(test1.totalHours() > (2 * 24 + 34) && test1.totalHours() < (2 * 24 + 35));

    CPPUNIT_ASSERT(test1.totalMinutes() > (2 * 24 * 60 + 34 * 60 + 53) && test1.totalHours() < (2 * 24 * 60 + 34 * 60 + 54));


    // test toString(...)

    CPPUNIT_ASSERT_EQUAL("3 d 10 h 53 min 2 s 500 ms"s, test1.toString(TimeSpanOutputFormat::WithMeasures, false));

    CPPUNIT_ASSERT_EQUAL("07:05:30"s, (TimeSpan::fromHours(7.0) + TimeSpan::fromMinutes(5.5)).toString());

    CPPUNIT_ASSERT_EQUAL("-5 s"s, TimeSpan::fromSeconds(-5.0).toString(TimeSpanOutputFormat::WithMeasures, false));

    CPPUNIT_ASSERT_EQUAL("0 s"s, TimeSpan().toString(TimeSpanOutputFormat::WithMeasures, false));

    CPPUNIT_ASSERT_EQUAL("5e+02 µs"s, TimeSpan::fromMilliseconds(0.5).toString(TimeSpanOutputFormat::WithMeasures, false));


    // test accuracy (of 100 nanoseconds)

    const auto test2 = TimeSpan::fromString("15.985077682");

    CPPUNIT_ASSERT_EQUAL(15.9850776, test2.totalSeconds());

    CPPUNIT_ASSERT_EQUAL(15, test2.seconds());

    CPPUNIT_ASSERT_EQUAL(985, test2.milliseconds());

    CPPUNIT_ASSERT_EQUAL(77, test2.microseconds());

    CPPUNIT_ASSERT_EQUAL(600, test2.nanoseconds());

    CPPUNIT_ASSERT_EQUAL("00:00:15.9850776"s, test2.toString());

    CPPUNIT_ASSERT_EQUAL("15 s 985 ms 77 µs 600 ns"s, test2.toString(TimeSpanOutputFormat::WithMeasures));

    CPPUNIT_ASSERT_EQUAL("15.9850776"s, test2.toString(TimeSpanOutputFormat::TotalSeconds));

}


void ChronoTests::testOperators()

{

    auto dateTime = DateTime::fromDateAndTime(1999, 1, 5, 4, 16);

    CPPUNIT_ASSERT_EQUAL(7, (dateTime + TimeSpan::fromDays(2.0)).day());

    CPPUNIT_ASSERT_EQUAL(6, (dateTime + TimeSpan::fromHours(24.0)).day());

    CPPUNIT_ASSERT_EQUAL(3, (dateTime + TimeSpan::fromHours(24.0) + TimeSpan::fromHours(-1.0)).hour());

    CPPUNIT_ASSERT_EQUAL(17, (dateTime + TimeSpan::fromHours(24.0) - TimeSpan::fromMinutes(-1.0)).minute());

    dateTime += TimeSpan::fromDays(365.0);

    CPPUNIT_ASSERT_EQUAL(2000, dateTime.year());

    CPPUNIT_ASSERT_EQUAL(5, dateTime.day());

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromDays(1.0), TimeSpan::fromHours(12.0) * 2.0);

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromHours(12.0), TimeSpan::fromDays(1.0) / 2.0);

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromDays(1.0), TimeSpan::fromHours(12.0) * TimeSpan::TickType(2));

    CPPUNIT_ASSERT_EQUAL(TimeSpan::fromHours(12.0), TimeSpan::fromDays(1.0) / TimeSpan::TickType(2));

    CPPUNIT_ASSERT_EQUAL(2.0, TimeSpan::fromDays(1.0) / TimeSpan::fromHours(12.0));

}


void ChronoTests::testPeriod()

{

    const auto begin(DateTime::fromDateAndTime(1994, 7, 18, 15, 30, 21)), end(DateTime::fromDateAndTime(2017, 12, 2, 15, 30, 21));

    const Period period(begin, end);

    CPPUNIT_ASSERT_EQUAL(23, period.years());

    CPPUNIT_ASSERT_EQUAL(4, period.months());

    CPPUNIT_ASSERT_EQUAL(14, period.days());

    CPPUNIT_ASSERT_EQUAL(end.toString(), (begin + period).toString());


    const auto end2(DateTime::fromDateAndTime(2018, 1, 2, 15, 30, 21));

    const Period period2(begin, end2);

    CPPUNIT_ASSERT_EQUAL(23, period2.years());

    CPPUNIT_ASSERT_EQUAL(5, period2.months());

    CPPUNIT_ASSERT_EQUAL_MESSAGE("one more day, because December has 31 days", 15, period2.days());

    CPPUNIT_ASSERT_EQUAL(end2.toString(), (begin + period2).toString());

}


void ChronoTests::testHashing()

{

    set<DateTime> dateTimes;

    dateTimes.emplace(DateTime::fromDate(2500, 2, 1));

    dateTimes.emplace(DateTime::fromDate(2500, 2, 2));

    dateTimes.emplace(DateTime::fromDate(2500, 2, 1));

    CPPUNIT_ASSERT_EQUAL(2_st, dateTimes.size());


    set<TimeSpan> timeSpans;

    timeSpans.emplace(TimeSpan::fromDays(5.0));

    timeSpans.emplace(TimeSpan::fromDays(10.0));

    timeSpans.emplace(TimeSpan::fromDays(5.0));

    CPPUNIT_ASSERT_EQUAL(2_st, timeSpans.size());

}


CPPUNIT_TEST_SUITE_REGISTRATION
CPPUNIT_TEST_SUITE_REGISTRATION(ChronoTests)

ChronoTests
The ChronoTests class tests classes and functions provided by the files inside the chrono directory.
Definition chronotests.cpp:70

ChronoTests::setUp
void setUp()
Definition chronotests.cpp:81

ChronoTests::testTimeSpan
void testTimeSpan()
Tests most important TimeSpan features.
Definition chronotests.cpp:318

ChronoTests::testHashing
void testHashing()
Tests hashing DateTime / TimeSpan by using in a set.
Definition chronotests.cpp:408

ChronoTests::testOperators
void testOperators()
Tests operators of DateTime / TimeSpan.
Definition chronotests.cpp:368

ChronoTests::testDateTime
void testDateTime()
Tests most important DateTime features.
Definition chronotests.cpp:101

ChronoTests::testPeriod
void testPeriod()
Tests Period.
Definition chronotests.cpp:388

ChronoTests::testDateTimeExpression
void testDateTimeExpression()
Tests parsing a DateTimeExpression.
Definition chronotests.cpp:231

ChronoTests::tearDown
void tearDown()
Definition chronotests.cpp:84

CppUtilities::ConversionException
The ConversionException class is thrown by the various conversion functions of this library when a co...
Definition conversionexception.h:11

CppUtilities::DateTime::fromTimeStampGmt
static constexpr DateTime fromTimeStampGmt(std::time_t timeStamp)
Constructs a new DateTime object with the GMT time from the specified UNIX timeStamp.
Definition datetime.h:274

CppUtilities::DateTime::unixEpochStart
static constexpr DateTime unixEpochStart()
Returns the DateTime object for the "1970-01-01T00:00:00Z".
Definition datetime.h:494

CppUtilities::DateTime::fromChronoTimePointGmt
static constexpr DateTime fromChronoTimePointGmt(TimePoint timePoint)
Constructs a new DateTime object with the GMT time from the specified std::chrono::time_point.
Definition datetime.h:294

CppUtilities::DateTime::fromIsoString
static std::pair< DateTime, TimeSpan > fromIsoString(const char *str)
Parses the specified ISO date time denotation provided as C-style string.
Definition datetime.cpp:105

CppUtilities::DateTime::fromString
static DateTime fromString(const std::string &str)
Parses the given std::string as DateTime.
Definition datetime.h:244

CppUtilities::DateTime::fromDateAndTime
static DateTime fromDateAndTime(int year=1, int month=1, int day=1, int hour=0, int minute=0, int second=0, double millisecond=0.0)
Constructs a DateTime to the specified year, month, day, hour, minute, second and millisecond.
Definition datetime.h:230

CppUtilities::DateTime::fromDate
static DateTime fromDate(int year=1, int month=1, int day=1)
Constructs a DateTime to the specified year, month, and day.
Definition datetime.h:211

CppUtilities::DateTime::gmtNow
static DateTime gmtNow()
Returns a DateTime object that is set to the current date and time on this computer,...
Definition datetime.h:512

CppUtilities::DateTime::fromTimeStamp
static DateTime fromTimeStamp(std::time_t timeStamp)
Constructs a new DateTime object with the local time from the specified UNIX timeStamp.
Definition datetime.cpp:69

CppUtilities::DateTime::isEternity
constexpr bool isEternity() const
Returns whether the instance has the maximal number of ticks.
Definition datetime.h:434

CppUtilities::DateTime::fromIsoStringGmt
static DateTime fromIsoStringGmt(const char *str)
Parses the specified ISO date time denotation provided as C-style string.
Definition datetime.h:255

CppUtilities::DateTime::daysInMonth
static int daysInMonth(int year, int month)
Returns the number of days in the specified month and year.
Definition datetime.h:450

CppUtilities::DateTime::eternity
static constexpr DateTime eternity()
Constructs a new instance of the DateTime class with the maximal number of ticks.
Definition datetime.h:486

CppUtilities::Period
Represents a period of time.
Definition period.h:8

CppUtilities::Period::days
constexpr int days() const
Returns the days component of the period represented by the current instance.
Definition period.h:48

CppUtilities::Period::years
constexpr int years() const
Returns the years component of the period represented by the current instance.
Definition period.h:32

CppUtilities::Period::months
constexpr int months() const
Returns the months component of the period represented by the current instance.
Definition period.h:40

CppUtilities::TimeSpan
Represents a time interval.
Definition timespan.h:25

CppUtilities::TimeSpan::totalHours
constexpr double totalHours() const
Returns the value of the current TimeSpan class expressed in whole and fractional hours.
Definition timespan.h:289

CppUtilities::TimeSpan::totalSeconds
constexpr double totalSeconds() const
Returns the value of the current TimeSpan class expressed in whole and fractional seconds.
Definition timespan.h:273

CppUtilities::TimeSpan::isNull
constexpr bool isNull() const
Returns true if the time interval represented by the current TimeSpan class is null.
Definition timespan.h:538

CppUtilities::TimeSpan::seconds
constexpr int seconds() const
Returns the seconds component of the time interval represented by the current TimeSpan class.
Definition timespan.h:331

CppUtilities::TimeSpan::isNegativeInfinity
constexpr bool isNegativeInfinity() const
Returns whether the time interval represented by the current instance is the smallest representable T...
Definition timespan.h:554

CppUtilities::TimeSpan::minutes
constexpr int minutes() const
Returns the minutes component of the time interval represented by the current TimeSpan class.
Definition timespan.h:339

CppUtilities::TimeSpan::totalMicroseconds
constexpr double totalMicroseconds() const
Returns the value of the current TimeSpan class expressed in whole and fractional microseconds.
Definition timespan.h:257

CppUtilities::TimeSpan::totalTicks
constexpr TickType totalTicks() const
Returns the number of ticks that represent the value of the current TimeSpan class.
Definition timespan.h:249

CppUtilities::TimeSpan::days
constexpr int days() const
Returns the days component of the time interval represented by the current TimeSpan class.
Definition timespan.h:355

CppUtilities::TimeSpan::TickType
std::int64_t TickType
Definition timespan.h:29

CppUtilities::TimeSpan::milliseconds
constexpr int milliseconds() const
Returns the milliseconds component of the time interval represented by the current TimeSpan class.
Definition timespan.h:323

CppUtilities::TimeSpan::fromDays
static constexpr TimeSpan fromDays(double days)
Constructs a new instance of the TimeSpan class with the specified number of days.
Definition timespan.h:162

CppUtilities::TimeSpan::fromHours
static constexpr TimeSpan fromHours(double hours)
Constructs a new instance of the TimeSpan class with the specified number of hours.
Definition timespan.h:154

CppUtilities::TimeSpan::fromMinutes
static constexpr TimeSpan fromMinutes(double minutes)
Constructs a new instance of the TimeSpan class with the specified number of minutes.
Definition timespan.h:146

CppUtilities::TimeSpan::infinity
static constexpr TimeSpan infinity()
Constructs a new instance of the TimeSpan class with the maximal number of ticks.
Definition timespan.h:233

CppUtilities::TimeSpan::fromSeconds
static constexpr TimeSpan fromSeconds(double seconds)
Constructs a new instance of the TimeSpan class with the specified number of seconds.
Definition timespan.h:138

CppUtilities::TimeSpan::isInfinity
constexpr bool isInfinity() const
Returns whether the time interval represented by the current instance is the longest representable Ti...
Definition timespan.h:562

CppUtilities::TimeSpan::negativeInfinity
static constexpr TimeSpan negativeInfinity()
Constructs a new instance of the TimeSpan class with the minimal number of ticks.
Definition timespan.h:225

CppUtilities::TimeSpan::microseconds
constexpr int microseconds() const
Returns the microseconds component of the time interval represented by the current TimeSpan class.
Definition timespan.h:315

CppUtilities::TimeSpan::totalDays
constexpr double totalDays() const
Returns the value of the current TimeSpan class expressed in whole and fractional days.
Definition timespan.h:297

CppUtilities::TimeSpan::fromString
static TimeSpan fromString(const std::string &str, char separator=':')
Parses the given std::string as TimeSpan.
Definition timespan.h:217

CppUtilities::TimeSpan::totalMilliseconds
constexpr double totalMilliseconds() const
Returns the value of the current TimeSpan class expressed in whole and fractional milliseconds.
Definition timespan.h:265

CppUtilities::TimeSpan::isNegative
constexpr bool isNegative() const
Returns true if the time interval represented by the current TimeSpan class is negative.
Definition timespan.h:546

CppUtilities::TimeSpan::hours
constexpr int hours() const
Returns the hours component of the time interval represented by the current TimeSpan class.
Definition timespan.h:347

CppUtilities::TimeSpan::totalMinutes
constexpr double totalMinutes() const
Returns the value of the current TimeSpan class expressed in whole and fractional minutes.
Definition timespan.h:281

CppUtilities::TimeSpan::nanoseconds
constexpr int nanoseconds() const
Returns the nanoseconds component of the time interval represented by the current TimeSpan class.
Definition timespan.h:307

CppUtilities::TimeSpan::fromMilliseconds
static constexpr TimeSpan fromMilliseconds(double milliseconds)
Constructs a new instance of the TimeSpan class with the specified number of milliseconds.
Definition timespan.h:130

conversionexception.h

datetime.h

format.h

CppUtilities::Literals
Contains literals to ease asserting with CPPUNIT_ASSERT_EQUAL.
Definition testutils.h:368

CppUtilities
Contains all utilities provides by the c++utilities library.
Definition argumentparser.h:18

CppUtilities::TimeSpanOutputFormat::TotalSeconds
@ TotalSeconds
Definition timespan.h:22

CppUtilities::TimeSpanOutputFormat::WithMeasures
@ WithMeasures
Definition timespan.h:21

CppUtilities::DateTimeParts::Day
@ Day
Definition datetime.h:149

CppUtilities::DateTimeParts::SubSecond
@ SubSecond
Definition datetime.h:153

CppUtilities::DateTimeParts::Year
@ Year
Definition datetime.h:147

CppUtilities::DateTimeParts::Minute
@ Minute
Definition datetime.h:151

CppUtilities::DateTimeParts::Month
@ Month
Definition datetime.h:148

CppUtilities::DateTimeParts::DateTime
@ DateTime
Definition datetime.h:158

CppUtilities::DateTimeParts::DeltaMinute
@ DeltaMinute
Definition datetime.h:155

CppUtilities::DateTimeParts::Hour
@ Hour
Definition datetime.h:150

CppUtilities::DateTimeParts::Second
@ Second
Definition datetime.h:152

CppUtilities::DateTimeParts::DeltaHour
@ DeltaHour
Definition datetime.h:154

CppUtilities::DateTimeOutputFormat::DateTimeAndShortWeekday
@ DateTimeAndShortWeekday
Definition datetime.h:24

CppUtilities::DateTimeOutputFormat::Iso
@ Iso
Definition datetime.h:25

CppUtilities::DateTimeOutputFormat::DateAndTime
@ DateAndTime
Definition datetime.h:20

CppUtilities::DateTimeOutputFormat::IsoOmittingDefaultComponents
@ IsoOmittingDefaultComponents
Definition datetime.h:26

CppUtilities::DayOfWeek::Thursday
@ Thursday
Definition datetime.h:37

CppUtilities::DayOfWeek::Wednesday
@ Wednesday
Definition datetime.h:36

std
STL namespace.

period.h

CppUtilities::DateTimeExpression::fromString
static DateTimeExpression fromString(const char *str)
Parses the given C-style string.
Definition datetime.cpp:488

CppUtilities::DateTimeExpression::fromIsoString
static DateTimeExpression fromIsoString(const char *str)
Parses the specified ISO date time denotation provided as C-style string.
Definition datetime.cpp:388

testutils.h

timespan.h