EMA C++ Edition
List of all members | Public Types | Public Member Functions
refinitiv::ema::access::DateTimeStringFormat Class Reference

DateTimeStringFormat is an interface to string conversion methods for OmmDate, OmmTime & OmmDateTime. More...

Public Types

enum  DateTimeStringFormatTypes {
  STR_DATETIME_ISO8601 = 1 ,
  STR_DATETIME_RSSL = 2
}
 

Public Member Functions

const EmaStringdateAsString (OmmDate &date)
  More...
 
const EmaStringdateTimeAsString (OmmDateTime &dateTime)
  More...
 
 DateTimeStringFormat ()
 
void dateTimeStringFormatType (DateTimeStringFormatTypes format)
  More...
 
DateTimeStringFormatTypes getDateTimeStringFormatType ()
  More...
 
const EmaStringtimeAsString (OmmTime &time)
  More...
 

Detailed Description

Remarks
DateTimeStringFormat is single threaded.
If an application accesses a single object of DateTimeStringFormat via multiple threads,
it needs to implement its own locking mechanism.
See also
Data, OmmDate, OmmTime, OmmDateTime

Definition at line 37 of file DateTimeStringFormat.h.

Member Enumeration Documentation

◆ DateTimeStringFormatTypes

An enumeration representing item data state.

Enumerator
STR_DATETIME_ISO8601 

Indicates Date/Time/DateTime to string output in ISO8601's dateTime format: "YYYY-MM-DDThour:minute:second.nnnnnnnnn" (e.g., 2010-11-30T15:24:54.627529436).

STR_DATETIME_RSSL 

Indicates Date/Time/DateTime to string output in to string output in the default format: "DD MON YYYY hour:minute:second:milli:micro:nano" (e.g., 30 NOV 2010 15:24:54:627:529:436).

Definition at line 43 of file DateTimeStringFormat.h.

Member Function Documentation

◆ dateAsString()

const EmaString& refinitiv::ema::access::DateTimeStringFormat::dateAsString ( OmmDate date)

Returns the OmmDate value as a string in a specified format.

Parameters
[in]OmmDatethat needs to be converted to string.
Returns
string representation of this object OmmDate in the specified format

◆ dateTimeAsString()

const EmaString& refinitiv::ema::access::DateTimeStringFormat::dateTimeAsString ( OmmDateTime dateTime)

Returns the OmmDateTime value as a string in a specified format.

Parameters
[in]OmmDateTimethat needs to be converted to string.
Returns
string representation of this object OmmDateTime in the specified format

◆ dateTimeStringFormatType()

void refinitiv::ema::access::DateTimeStringFormat::dateTimeStringFormatType ( DateTimeStringFormatTypes  format)

Specifies DateTimeStringFormatType.

Exceptions
OmmOutOfRangeExceptionif format is not any of the enumerations of DateTimeStringFormatTypes.
Parameters
[in]DateTimeStringFormatTypesspecifies the format of the string output of Date/Time/DateTime
Returns
format of the output string.

◆ getDateTimeStringFormatType()

DateTimeStringFormatTypes refinitiv::ema::access::DateTimeStringFormat::getDateTimeStringFormatType ( )

Returns DateTimeStringFormatTypes.

Returns
value of DateTimeStringFormatTypes

◆ timeAsString()

const EmaString& refinitiv::ema::access::DateTimeStringFormat::timeAsString ( OmmTime time)

Returns the OmmTime value as a string in a specified format.

Parameters
[in]OmmTimethat needs to be converted to string.
Returns
string representation of this object OmmTime in the specified format