COleDateTimeSpan::Format

Статья
06/09/2015

Создает форматированное строковое представление объекта COleDateTimeSpan.

CString Format( 
   LPCTSTR pFormat  
) const; 
CString Format( 
   UINT nID  
) const;

Параметры

pFormat
Строка формата, аналогичную printf при форматировании строки. Коды форматирования предшествуемые роста (%) подписывают, заменены соответствующим компонентом COleDateTimeSpan. Другие знаки в строке форматирования копируются неизменным на возвращенную строку. Значение и значения кодов форматирования для Формат перечислены ниже:
- Часы %H в текущем нижней части
- Минуты %M в текущем час
- Секунды в текущей минуте %S
- %% Символ процента
4 Приведенного выше кода формата являются единственными коды, формат примет.
nID
Идентификатор ресурса для строки формат- элемента управления.

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

CString, содержащее форматированное значение даты/промежутка времени.

Заметки

Вызовите эти функции, чтобы создать форматированное представление значения промежутка времени. Если состояние данного объекта COleDateTimeSpan равно null, то возвращаемым значением является пустая строка. Если недопустимое состояние, возвращаемая строка определяется ресурсом IDS_INVALID_DATETIMESPAN строки.

Краткое описание с помощью форм для данной функции:

Format( pFormat )
Эта форма форматирует значение, используя строку форматирования, которая содержит специальные коды форматирования, предшествуются символ процента (%), как в printf. Строка формата передается в качестве параметра функции.
Format( nID )
Эта форма форматирует значение, используя строку форматирования, которая содержит специальные коды форматирования, предшествуются символ процента (%), как в printf. Строка формата ресурс. Идентификатор данного ресурса строки передается как параметр.

Пример

// get the current time
COleDateTime tmStart = COleDateTime::GetCurrentTime();

// waste some time
CString str;
::Sleep(3000);

// get the current time again
COleDateTime tmFinish = COleDateTime::GetCurrentTime();

// find the difference
COleDateTimeSpan tmSpan = tmFinish - tmStart;

// tell the user
str = tmSpan.Format(_T("%S seconds elapsed"));
_tprintf_s(_T("%s\n"), (LPCTSTR) str);