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	數位	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 中所傳回的時間值一律會以小時 hh 小時 小時 分鐘 秒為單位。 超過24小時的時間不會轉換成天或月。 略過秒數。

例子

#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 標頭會根據 UNICODE 預處理器常數的定義，將 StrFromTimeInterval 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	shlwapi.h
連結庫	Shlwapi.lib
DLL	Shlwapi.dll （4.71 版或更新版本）