关于

maxon::LocalDateTime is a MAXON API class used to create an object capable of representing local time and date in a convenient and effective manner to reduce the effort of handling localized time and date representation. It's indeed recommended to use the maxon::UniversalDateTime whenever possible to store normalized time and date values and convert them the localized as late as possible.

警告: maxon::LocalDateTime exposes all the available members as public leaving the developer the option to customize them. It must be noted that, if the customized values are incorrect, it could lead to an unpredictable behaviour when converting back to maxon::UniversalDateTime .

Creation and initialization

A maxon::LocalDateTime can be created and initialized using:

maxon::LocalDateTime::GetNow() : creates a maxon::LocalDateTime initialized at the current time and date;
maxon::LocalDateTime::FromUnixTimestamp() : creates a maxon::LocalDateTime object initialized at the given Unix timestamp ;
maxon::LocalDateTime::FromString() : creates a maxon::LocalDateTime initialized at the given date/time string and date/time formatting string;
maxon::LocalDateTime::FromValues() : creates a maxon::LocalDateTime given year, month, day, hours, minutes and seconds.

// This example allocates a few maxon::LocalDateTime objects showing different initialization methods.

// allocate a UniversalDateTime object on the stack initialized with the current time const maxon::LocalDateTime ldtNow( maxon::LocalDateTime::GetNow ());

// define a unix-compliant timestamp equal to 01.07.2016 09:00:00 (in UTC time) const UInt64 aTimeStamp(1467363600);

// allocate and initialize a second LocalDateTime object using a unix timestamp // NOTE: using LocalDateTime::FromUnixTimeStamp will add the local timezone to the passed timestamp const maxon::LocalDateTime ldtFromUnixTimestamp( maxon::LocalDateTime::FromUnixTimestamp (aTimeStamp));

// allocate and initialize a third LocalDateTime object using spare date/time values const maxon::LocalDateTime ldtFromValues = maxon::LocalDateTime::FromValues (2016, 7, 1, 9, 0, 0) iferr_return ;

// allocate and initialize a forth LocalDateTime object using a properly formatted date/time string const maxon :: String timedateStr = "2016-07-01 09:00:00"_s; const Char * timedateFrmtStr = "%Y-%m-%d %H:% M :% S "; const maxon ::LocalDateTime ldtFromString = maxon ::LocalDateTime::FromString(timedateStr, timedateFrmtStr) iferr_return ;

比较

A maxon::LocalDateTime can be compared by using standard operators:

maxon::LocalDateTime::operator==() : compares two LocalDateTime used in the expression returning true if all the member values are equal;
maxon::LocalDateTime::operator!=() : compares two LocalDateTime used in expression returning true if at least one of the member values is different.

// This example shows how to compare two LocalDateTime objects

// allocate and initialize a LocalDateTime const UInt64 timestamp = 1467363600; const maxon::LocalDateTime ldt = maxon::LocalDateTime::FromUnixTimestamp (timestamp);

// clone into a new LocalDateTime const maxon::LocalDateTime ldtCloned(ldt);

// allocate and initialize a LocalDateTime starting from the first one maxon::LocalDateTime ldtAnother(ldt);

// update the hours ldtAnother._hour -= 2;

// compare the initial with the clone if (ldt == ldtCloned) { // the two instances are equal // do something here DiagnosticOutput ( "ldt and ldtCloned share the same time/date values." ); }

// compare the initial with the clone if (ldtAnother != ldt) { // the first instance is smaller than the second // do something here DiagnosticOutput ( "ldtAnother time/date values are different than those stored in ldt." ); }

内容表

关于

Creation and initialization

比较

Conversion

Utilities

延伸阅读