COleDateTime Class

Статья
06/09/2015

Инкапсулирует тип данных DATE, используемый в ole-автоматизации.

class COleDateTime

Члены

Открытые конструкторы

Имя	Описание
COleDateTime::COleDateTime	Создает объект COleDateTime.

Открытые методы

Имя	Описание
COleDateTime::Format	Создает форматированное строковое представление объекта COleDateTime.
COleDateTime::GetAsDBTIMESTAMP	Вызовите этот метод, чтобы получить время в объекте COleDateTime как структура данных DBTIMESTAMP.
COleDateTime::GetAsSystemTime	Вызовите этот метод, чтобы получить время в объекте COleDateTime как структура данных SYSTEMTIME.
COleDateTime::GetAsUDATE	Вызовите этот метод, чтобы получить время в COleDateTime как структура данных UDATE.
COleDateTime::GetCurrentTime	Создает объект COleDateTime, представляющий текущее время (функция статического элемента).
COleDateTime::GetDay	Возвращает день этот объект представляет COleDateTime (от 1 до 31).
COleDateTime::GetDayOfWeek	Возвращает день недели этот объект представляет COleDateTime (воскресенье = 1).
COleDateTime::GetDayOfYear	Возвращает день года этот объект представляет COleDateTime (1-ое января = 1).
COleDateTime::GetHour	Возвращает этот объект COleDateTime представляет час (от 0 до 23).
COleDateTime::GetMinute	Возвращает минуту этот объект представляет COleDateTime (от 0 до 59).
COleDateTime::GetMonth	Возвращает этот объект COleDateTime представляет месяц (от 1 до 12).
COleDateTime::GetSecond	Возвращает второй объект COleDateTime представляющий (от 0 до 59).
COleDateTime::GetStatus	Получает состояние (допустимость) данного объекта COleDateTime.
COleDateTime::GetYear	Возвращает год COleDateTime представляет данный объект.
COleDateTime::ParseDateTime	Считывает значение даты и времени из строки и задает значение COleDateTime.
COleDateTime::SetDate	Устанавливает значение данного объекта COleDateTime равным заданному значению даты - только для чтения.
COleDateTime::SetDateTime	Устанавливает значение данного объекта COleDateTime равным заданному значению даты и времени.
COleDateTime::SetStatus	Устанавливает состояние (допустимость) данного объекта COleDateTime.
COleDateTime::SetTime	Устанавливает значение данного объекта COleDateTime равным заданному значению типа Time - только для чтения.

Открытые операторы

Имя	Описание
== COleDateTime::operator, COleDateTime::operator < и т д.	Сравнение значения COleDateTime 2.
COleDateTime::operator +, - COleDateTime::operator	Add и subtract значения COleDateTime.
COleDateTime::operator +=, COleDateTime::operator - =	Add и subtract значение COleDateTime из данного объекта COleDateTime.
COleDateTime::operator =	Копирует значение COleDateTime.
ДАТА COleDateTime::operator, COleDateTime::operator Date*	Преобразует значение COleDateTime в DATE или DATE*.

Открытые члены данных

Имя	Описание
COleDateTime::m_dt	Содержит основные date для данного объекта COleDateTime.
COleDateTime::m_status	Содержит состояние данного объекта COleDateTime.

Заметки

COleDateTime не имеет базовый класс.

Он один из возможных типов для типа данных ВАРИАНТ ole-автоматизации. Значение COleDateTime представляет собой абсолютные дату и время.

Тип DATE реализуется в виде значения с плавающей запятой. Дни измеряются в полночь начиная с 30-ого декабря 1899. В следующей таблице показаны некоторые даты и связанные с ними значения:

Дата	Значение
В полночь 29-ое декабря 1899.	-1.0
29-ое декабря 1899, 6	-1.25
В полночь 30-ое декабря 1899.	0.0
В полночь 31-ое декабря 1899.	1.0
1-ое января 1900, 6..	2.25

Предупреждение

Заметка в таблице перед тем как значения дня до полночью будут отрицательными значениями времени дня 30-ого декабря 1899.Например, 6:00 AM всегда представляется частичным значение 0,25, независимо от того, является целое число, представляющее день положительным (после 30-ого декабря 1899) или недостатки (до 30-ого декабря 1899).Это означает, что простое сравнение с плавающей запятой ошибочно отсортированные COleDateTime, представляющий 6:00 AM на 12/29/1899 по мере later того, представляющий 7:00 AM в тот же день.

Класс COleDateTime обрабатывает даты за начиная с 1-ого января 100, до 31-ого декабря 9999. Класс COleDateTime используется григорианский календарь. он не поддерживает юлианские даты. COleDateTime игнорирует летнее время. (См. Дата и время: поддержка автоматизации).

Примечание

Можно использовать формат %y, чтобы извлечь год 2 - числа только даты, начиная с 1900.Если используется формат %y на дату до 1900, то код вызывает сбой УТВЕРЖДЕНИЯ.

Этот тип используется также для представления значений даты или времени - только только для чтения. По соглашению дата 0 (30-ое декабря 1899) используется для значения времени - только и времени 00:00 (полуночи) для значений даты - только для чтения.

При создании объекта COleDateTime с помощью дат меньше 100, то принятьа дата, но последующие вызовы GetYear, GetMonth, GetDay, GetHour, GetMinute, и происходит сбой GetSecond и равен -1. Ранее, можно использовать дат 2 - числа, но даты необходимо 100 или выше в MFC 4,2 и более поздних версий.

Чтобы избежать проблем, укажите дату 4 - числа. Например:

COleDateTime mytime(1996, 1, 1, 0, 0, 0);

Основные арифметические операции для значений COleDateTime используют класс COleDateTimeSpan сопровождающий. Значения COleDateTimeSpan определяют интервал времени. Связь между этими классами похоже на связь между CTime и CTimeSpan.

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