Функция StrFromTimeIntervalA (shlwapi.h)
Преобразует интервал времени, указанный в миллисекундах, в строку.
Синтаксис
int StrFromTimeIntervalA(
[out] PSTR pszOut,
UINT cchMax,
DWORD dwTimeMS,
int digits
);
Параметры
[out] pszOut
Тип: PTSTR
Указатель на буфер, который при успешном возвращении этой функции получает преобразованное число.
cchMax
Тип: UINT
Размер pszOut в символах. Если параметр cchMax равен нулю, StrFromTimeInterval вернет минимальный размер буфера символов, необходимый для хранения преобразованной строки. В этом случае pszOut не будет содержать преобразованную строку.
dwTimeMS
Тип: DWORD
Интервал времени в миллисекундах.
digits
Тип: int
Максимальное число значимых цифр, представленных в pszOut. Ниже приведены некоторые примеры.
dwTimeMS | digits | pszOut |
---|---|---|
34000 | 3 | 34 с |
34000 | 2 | 34 с |
34000 | 1 | 30 с |
74000 | 3 | 1 мин 14 с |
74000 | 2 | 1 мин 10 с |
74000 | 1 | 1 мин |
Возвращаемое значение
Тип: int
Возвращает количество символов в pszOut, за исключением завершающего символа NULL .
Комментарии
Значение времени, возвращаемое в pszOut, всегда будет находиться в формате чч чч часы , минсс секунды. Время, превышающее двадцать четыре часа, не преобразуется в дни или месяцы. Доли секунд игнорируются.
Примеры
#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"
void main(void)
{
char TimeString[256];
char *pszOut;
pszOut = TimeString;
cout << "The return value from the call to"
<< "\nthe function StrFromTimeInterval will"
<< "\nreturn the number of elements in the buffer: " << endl;
cout << "\nThe return from StrFromTimeInterval is "
<< StrFromTimeInterval(pszOut,30, 34000,30);
cout << "\nThe contents of the TimeString Buffer " << pszOut << endl;
cout << "The return from StrFromTimeInterval is "
<< StrFromTimeInterval(pszOut,30, 74000,3);
cout << "\nThe contents of the TimeString Buffer " << pszOut << endl;
cout << "The return from StrFromTimeInterval is "
<< StrFromTimeInterval(pszOut,30, 74000,2);
cout << "\nThe contents of the TimeString Buffer " << pszOut << endl;
cout << "The return from StrFromTimeInterval is "
<< StrFromTimeInterval(pszOut,30, 74000,1)
<< "\nThe contents of the TimeString Buffer " << pszOut << endl;
}
OUTPUT:
- - - - -
The return value from the call to
the function StrFromTimeInterval will
return the number of elements in the buffer:
The return from StrFromTimeInterval is 7
The contents of the TimeString Buffer 34 sec
The return from StrFromTimeInterval is 13
The contents of the TimeString Buffer 1 min 14 sec
The return from StrFromTimeInterval is 13
The contents of the TimeString Buffer 1 min 10 sec
The return from StrFromTimeInterval is 6
The contents of the TimeString Buffer 1 min
Примечание
Заголовок shlwapi.h определяет StrFromTimeInterval как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | shlwapi.h |
Библиотека | Shlwapi.lib |
DLL | Shlwapi.dll (версия 4.71 или более поздняя) |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по