COleDateTime::ParseDateTime

Статья
02/20/2013

Анализирует строку для чтения значение даты и времени.

bool ParseDateTime(
   LPCTSTR lpszDate,
   DWORD dwFlags = 0,
   LCID lcid = LANG_USER_DEFAULT 
) throw( );

Параметры

lpszDate
Указатель на null- завершенной строке, в которой анализируется.Дополнительные сведения см. в разделе "Примечания".
dwFlags
Отображает флаги параметров и анализа языковых стандартов.Один или несколько следующих флагов:
- Использование LOCALE_NOUSEROVERRIDE параметры языкового стандарта значения по умолчанию системы, а не пользовательские параметры пользователя.
- Ignore VAR_TIMEVALUEONLY часть даты во время синтаксического анализа.
- Ignore VAR_DATEVALUEONLY часть времени во время синтаксического анализа.
lcid
Отображает код языка, который будет использоваться для преобразования.

Возвращаемое значение

Возвращает true если строка была успешно преобразована к значению даты и времени; в противном случае false.

Заметки

Если строка была успешно преобразована в значение даты-времени, значение этого объекта COleDateTime установлено к этому значению и его состояние на допустимое.

Примечание
Значения года должны находиться в диапазоне от 100 до 9999 включительно.

Параметр lpszDate может принимать различные форматы.Например, следующие строки содержат допустимые форматы даты и времени:

"25 January 1996"

"8:30:00"

"20:30:00"

"January 25, 1996 8:30:00"

"8:30:00 Jan. 25, 1996"

"1/25/1996 8:30:00" // always specify the full year,

// even in a 'short date' format

Обратите внимание, что код языка также влияет на строковый формат приемлем ли для преобразования в значение даты-времени.

В случае VAR_DATEVALUEONLY, значение времени устанавливаются для времени 0 или полуночи.В случае VAR_TIMEVALUEONLY, значение даты для датировать установлено значение 0, 30-ое декабря 1899.

Если строка не может быть преобразована к значению даты и времени или если было numeric переполнение, то состояние данного объекта COleDateTime недопустимо.

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