COleDateTime::SetDateTime
Устанавливает дату и время создания данного объекта COleDateTime.
int SetDateTime(
int nYear,
int nMonth,
int nDay,
int nHour,
int nMin,
int nSec
) throw( );
Параметры
- nYear, nMonth, nDay, nHour, nMin, nSec
Отображает компоненты даты и времени, которые необходимо скопировать в данный объект COleDateTime.
Возвращаемое значение
Нуль, если значение данного объекта COleDateTime было установлено успешно; в противном случае – значение 1. Это возвращаемое значение основано на типе, указанном DateTimeStatus. Дополнительные сведения см. в разделе SetStatus функции-члена.
Заметки
См. следующую таблицу для границ значений параметров:
Параметр |
Границы |
|---|---|
nYear |
100 – 9999 |
nMonth |
1 – 12 |
nDay |
0 – 31 |
nHour |
0 – 23 |
nMin |
0 – 59 |
nSec |
0 – 59 |
Если день месяца, то он вызывает переполнение преобразовать в правильный день следующего месяца и месяц и год увеличиваются соответственно. Значение дня ноль указывает последний день предыдущего месяца. Реакция на событие совпадает с SystemTimeToVariantTime.
Если дата или время, определенные параметрами недопустимы, помещенные на недопустимое состояние этого объекта и не изменен значение данного объекта.
Ниже приведены некоторые примеры значений времени:
nHour |
nMin |
nSec |
Значение |
|---|---|---|---|
1 |
3 |
3 |
01:03:03 |
23 |
45 |
0 |
23:45:00 |
25 |
30 |
0 |
Недопустимый |
9 |
60 |
0 |
Недопустимый |
Ниже приведены некоторые примеры значений даты:
nYear |
nMonth |
nDay |
Значение |
|---|---|---|---|
1995 |
4 |
15 |
15 апреля 1995 г. |
1789 |
7 |
14 |
17 июля 1789 г. |
1925 |
2 |
30 |
Недопустимый |
10000 |
1 |
1 |
Недопустимый |
Чтобы задать дату только см. в разделе COleDateTime::SetDate. Чтобы задать время только см. в разделе COleDateTime::SetTime.
Дополнительные сведения о функций-членов, которые извлекают значения этого объекта COleDateTime см. в следующих функций элементов:
Дополнительные сведения о диапазоне для значений COleDateTime см. в статье Дата и время: поддержка автоматизации.
Пример
См. пример для GetStatus.
Требования
Header: atlcomtime.h