COleDateTime::COleDateTime

Статья
06/09/2015

Создает объект COleDateTime.

COleDateTime( ) throw( ); 
COleDateTime( 
   const VARIANT& varSrc  
) throw( ); 
COleDateTime( 
   DATE dtSrc  
) throw( ); 
COleDateTime( 
   time_t timeSrc  
) throw( ); 
COleDateTime( 
   __time64_t timeSrc  
) throw( ); 
COleDateTime( 
   const SYSTEMTIME& systimeSrc  
) throw( ); 
COleDateTime( 
   const FILETIME& filetimeSrc  
) throw( ); 
COleDateTime( 
   int nYear, 
   int nMonth, 
   int nDay, 
   int nHour, 
   int nMin, 
   int nSec  
) throw( ); 
COleDateTime( 
   WORD wDosDate, 
   WORD wDosTime  
) throw( ); 
COleDateTime( 
   const DBTIMESTAMP& dbts 
) throw();

Параметры

dateSrc
Существующий объект COleDateTime для копирования в новый объект COleDateTime.
varSrc
Существующая структура данных VARIANT (возможно, объект COleVariant ) для преобразования в значение даты-времени (VT_DATE) и COleDateTime скопированную в новый объект.
dtSrc
Значение даты и времени (DATE), копируемых в новый объект COleDateTime.
timeSrc
Значение time_t или __time64_t для преобразования в значение даты-времени и скопированный в новый COleDateTime объект.
systimeSrc
Структура SYSTEMTIME для преобразования в значение даты-времени и COleDateTime скопированную в новый объект.
filetimeSrc
Структура FILETIME для преобразования в значение даты-времени и COleDateTime скопированную в новый объект. Обратите внимание, что универсалия польз FILETIME координировала время (UTC), поэтому при передаче локальное время в структуре, то результаты будут неверны. См. раздел времена файла в Windows SDK дополнительные сведения.
nYear, nMonth, nDay, nHour, nMin, nSec
Отображает дату и время для копирования в новый объект COleDateTime.
wDosDate, wDosTime
Значения даты и времени, MS-DOS, которое необходимо преобразовать в значение даты-времени и скопированные в новый COleDateTime объект.
dbts
Ссылка на структуру DBTimeStamp, содержащий текущее местное время.

Заметки

Все эти конструкторы создают новые объекты, инициализируемые COleDateTime в указанное значение. В следующей таблице показаны допустимые диапазоны для каждого компонента даты и времени:

Компонент даты и времени	Допустимый диапазон
year	100 – 9999
месяц	0 – 12
день	0 – 31
час	0 – 23
min	0 – 59
second	0 – 59

Обратите внимание, что фактическая граница для компонента дней меняется на основе компонентах месяца и года. Дополнительные сведения см. в разделе функции-члены SetDate или SetDateTime.

Далее приводится краткое описание каждого конструктора:

COleDateTime() создает инициализированный объект COleDateTime до 0 (полночь 30-ое декабря 1899).
COleDateTime(dateSrc) создает объект COleDateTime из существующего объекта COleDateTime.
varSrc**)COleDateTime(** создает объект COleDateTime. Пытается преобразовать структура VARIANT или объект COleVariant к значению даты и времени (VT_DATE). Если нужное преобразование успешно, преобразованное значение копируется в новый объект COleDateTime. Если это не так, то значение объекта COleDateTime установлено в 0 (полночь 30-ое декабря 1899) и его состояние на недопустимый.
COleDateTime(dtSrc) создает объект COleDateTime от значения DATE.
COleDateTime(timeSrc) создает объект COleDateTime от значения time_t.
systimeSrc**)COleDateTime(** создает объект COleDateTime от значения SYSTEMTIME.
COleDateTime(filetimeSrc) создает объект COleDateTime от значения FILETIME. . Обратите внимание, что универсалия польз FILETIME координировала время (UTC), поэтому при передаче локальное время в структуре, то результаты будут неверны. См. раздел времена файла в Windows SDK дополнительные сведения.
COleDateTime(nYear, nMonth, nDay, nHour, nMin, nSec) создает объект COleDateTime из указанных числовых значений.
COleDateTime(wDosDate, wDosTime) создает объект COleDateTime из заданных дат и значений времени MS-DOS.

Дополнительные сведения о типе данных time_t см. в описании функции время в справочнике по библиотеке времени выполнения.

Дополнительные сведения см. в разделе макета и SYSTEMTIME FILETIME в Windows SDK.

Дополнительные сведения о диапазоне для значений COleDateTime см. в статье Дата и время: поддержка автоматизации.

Примечание

Конструктор DBTIMESTAMP используя параметр доступен, только если OLEDB.h включается.

Пример

time_t osBinaryTime;   // C run-time time (defined in <time.h>)
time(&osBinaryTime);   // Get the current time from the  
                     // operating system.

COleDateTime time1;   // initialized to 00:00am, 30 December 1899 
                     // (and m_nStatus is valid!)

COleDateTime time2 = time1; // Copy constructor
COleDateTime time3(osBinaryTime);   // from time_t
COleDateTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999

SYSTEMTIME sysTime;   // Win32 time information
GetSystemTime(&sysTime);

COleDateTime time5(sysTime);