COleDateTime::Format
Создает форматированное представление значения даты и времени.
CString Format(
DWORD dwFlags = 0,
LCID lcid = LANG_USER_DEFAULT
) const;
CString Format(
LPCTSTR lpszFormat
) const;
CString Format(
UINT nFormatID
) const;
Параметры
dwFlags
Указывает один из следующих флагов языкового стандарта.Использование LOCALE_NOUSEROVERRIDE параметры языкового стандарта значения по умолчанию системы вместо пользовательских параметров пользователя.
Ignore VAR_TIMEVALUEONLY часть даты во время синтаксического анализа.
Ignore VAR_DATEVALUEONLY часть времени во время синтаксического анализа.
lcid
Отображает код языка, который будет использоваться для преобразования.Дополнительные сведения об идентификаторах языка см. в разделе идентификаторы языка.lpszFormat
Строка формата, аналогичную printf при форматировании строки.Каждый код форматирования предшествуемый роста (%) подписывает, заменить соответствующим компонентом COleDateTime.Другие знаки в строке форматирования копируются неизменным на возвращенную строку.См. описание функции среды выполнения strftime дополнительные сведения.Значение и значения кодов форматирования для Format:Часы %H в текущем нижней части
Минуты %M в текущем час
Секунды в текущей минуте %S
Символ процента %%
nFormatID
Идентификатор ресурса для строки формат- элемента управления.
Возвращаемое значение
CString, содержащее форматированное значение даты и времени.
Заметки
Если состояние данного объекта COleDateTime равно null, то возвращаемым значением является пустая строка.Если недопустимое состояние, возвращаемая строка определяется ресурсом ATL_IDS_DATETIME_INVALID строки.
Краткое описание 3 форм для данной функции:
Format( dwFlags, lcid)
Эта форма форматирует значение с помощью спецификации языка (идентификаторы языковых стандартов) для даты и времени.Использование параметров по умолчанию, эта форма напечатает дату и время, если часть времени не будет 0 (полночь), в этом случае он напечатает только дату или часть даты, 0 (30-ое декабря 1899) в этом случае он просто напечатает время.Если значение даты и времени 0 (полночь) 30-ое декабря 1899, эта форма с параметрами по умолчанию напечатает полуночи.Format( lpszFormat)
Эта форма форматируется с помощью строки форматирования, которая содержит специальные коды форматирования, предшествуются символ процента (%), как в printf.Строка формата передается в качестве параметра функции.Дополнительные сведения о кодах форматирования см. в разделе strftime, wcsftime в справочнике по библиотеке времени выполнения.Format( nFormatID)
Эта форма форматируется с помощью строки форматирования, которая содержит специальные коды форматирования, предшествуются символ процента (%), как в printf.Строка формата ресурс.Идентификатор данного ресурса строки передается как параметр.Дополнительные сведения о кодах форматирования см. в разделе strftime, wcsftime в Справочник по библиотеке времени выполнения.
Пример
COleDateTime t(1999, 3, 19, 22, 15, 0);
CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));
Требования
заголовок: atlcomtime.h