OnixS CME Drop Copy Handler for C++  5.3.0.0
Public Member Functions | Static Public Member Functions | Static Public Attributes | List of all members
TimeSpan Class Reference

Represents time interval. More...

Public Member Functions

 TimeSpan ()
 Initializes zero span.
 
 TimeSpan (Int32 hours, Int32 minutes, Int32 seconds, Int32 nanoseconds=0)
 Initializes with given set of values. More...
 
 TimeSpan (Int32 days, Int32 hours, Int32 minutes, Int32 seconds, Int32 nanoseconds)
 Initializes with given set of values. More...
 
 TimeSpan (Int64 totalSeconds, Int32 nanoseconds)
 Initializes time interval from total number seconds and its fractional (nanosecond) part. More...
 
 TimeSpan (const TimeSpan &other)
 Initializes as clone of other instance.
 
Int64 totalSeconds () const
 Whole number of seconds in time interval.
 
Int64 totalSubseconds (Subsecond subsecondType) const
 Whole number of subseconds in time interval.
 
Int32 days () const
 Days component of time interval. More...
 
Int32 hours () const
 Hours component of time interval. More...
 
Int32 minutes () const
 Minutes component of time interval. More...
 
Int32 seconds () const
 Seconds component of time interval. More...
 
Int32 milliseconds () const
 Milliseconds component of time interval. More...
 
Int32 microseconds () const
 Microseconds component of time interval. More...
 
Int32 nanoseconds () const
 Nanoseconds component of time interval. More...
 
bool operator== (const TimeSpan &other) const
 Compares with other instance for equality.
 
bool operator!= (const TimeSpan &other) const
 Compares with other instance for in-equality.
 
bool operator< (const TimeSpan &other) const
 Checks whether time interval less than other one.
 
bool operator> (const TimeSpan &other) const
 Checks whether time interval greater than other one.
 
TimeSpanoperator+= (const TimeSpan &other)
 Adds time interval to current one.
 
TimeSpanoperator-= (const TimeSpan &other)
 Subtracts time interval from current one.
 
TimeSpanoperator= (const TimeSpan &other)
 Re-assigns time interval from other one.
 
void toString (std::string &str, TimeSpanFormat format=TimeSpanFormats::SDHHMMSSnsec) const
 Serializes time stamp into text presentation using specified time-span presentation format. More...
 
std::string toString (TimeSpanFormat format=TimeSpanFormats::SDHHMMSSnsec) const
 Serializes time stamp into text presentation using specified time-span presentation format. More...
 

Static Public Member Functions

static TimeSpan deserialize (const std::string &str)
 De-serializes time interval from its text presentation.
 

Static Public Attributes

static const TimeSpan Zero
 Time interval of zero length.
 

Detailed Description

Represents time interval.

Used primarily to present time-only stamps and to measure time intervals between two timestamps.

Constructor & Destructor Documentation

TimeSpan ( Int32  hours,
Int32  minutes,
Int32  seconds,
Int32  nanoseconds = 0 
)

Initializes with given set of values.

Input parameters are treated as quantities, but not as a time stamp. Therefore, there's no requirement to fit in a certain range like hours must fit into [0, 24) range. After initialization time span will be normalized.

TimeSpan ( Int32  days,
Int32  hours,
Int32  minutes,
Int32  seconds,
Int32  nanoseconds 
)

Initializes with given set of values.

Input parameters are treated as quantities, but not as a time stamp. Therefore, there's no requirement to fit in a certain range like hours must fit into [0, 24) range. After initialization time span will be normalized.

TimeSpan ( Int64  totalSeconds,
Int32  nanoseconds 
)

Initializes time interval from total number seconds and its fractional (nanosecond) part.

Member Function Documentation

Int32 days ( ) const

Days component of time interval.

Whole number of days in time interval.

Int32 hours ( ) const

Hours component of time interval.

Values are in range from -23 through 23.

Int32 microseconds ( ) const

Microseconds component of time interval.

Values are in range from -999999 through 999999.

Int32 milliseconds ( ) const

Milliseconds component of time interval.

Values are in range from -999 through 999.

Int32 minutes ( ) const

Minutes component of time interval.

Values are in range from -59 through 59.

Int32 nanoseconds ( ) const
inline

Nanoseconds component of time interval.

Values are in range from -999999999 through 999999999.

Int32 seconds ( ) const

Seconds component of time interval.

Values are in range from -59 through 59.

void toString ( std::string &  str,
TimeSpanFormat  format = TimeSpanFormats::SDHHMMSSnsec 
) const

Serializes time stamp into text presentation using specified time-span presentation format.

std::string toString ( TimeSpanFormat  format = TimeSpanFormats::SDHHMMSSnsec) const
inline

Serializes time stamp into text presentation using specified time-span presentation format.