class CO2GDateUtils

Brief

The class converts between the OLE Automation date, SYSTEMTIME, and the C time formats.

Details

All methods of the class are static. One does not need to have an instance of the class.

SYSTEMTIME is a time structure that is used by the Windows API functions to work with date and time. The structure contains date and time, using individual members for month, day, year, weekday, hour, minute, second, and millisecond. On Unix/Mac/IOS operating systems, the same structure is declared in the ForexConnect API headers.

The OLE automation DATE format is represented by an 8-byte floating-point number, counting days since midnight of December 30, 1899. Hours and minutes are represented as fractional days. So, a second is 1.0 / 86400.0, a minute is 1.0 / 1440.0 and an hour is 1.0 / 24.0. The format is used in OLE automation functions on Windows.

tm is a standard C structure for date representation. The structure contains calendar date and time broken down into components. The structure does not contain milliseconds. The structure is available on all operation systems and from any C/C++ compiler.

Example:

#include <ForexConnect.h>
#include <sstream>
#include <iomanip>
#include <string>
 
 
void formatDate(DATE d, std::string &buf)
{
    struct tm t;
    CO2GDateUtils::OleTimeToCTime(d, &t);
    std::stringstream sstream;
    sstream << std::setfill('0') << std::setw(4) << t.tm_year + 1900 << "/"
            << std::setfill('0') << std::setw(2) << t.tm_mon + 1 << "/"
            << std::setfill('0') << std::setw(2) << t.tm_mday << " "
            << std::setfill('0') << std::setw(2) << t.tm_hour << ":"
            << std::setfill('0') << std::setw(2) << t.tm_min << ":"
            << std::setfill('0') << std::setw(2) << t.tm_sec;
    buf = sstream.str();
}