StrFromTimeIntervalW 関数 (shlwapi.h)

ミリ秒単位で指定された時間間隔を文字列に変換します。

構文

int StrFromTimeIntervalW(
  [out] PWSTR pszOut,
        UINT  cchMax,
        DWORD dwTimeMS,
        int   digits
);

パラメーター

[out] pszOut

型: PTSTR

この関数が正常に返されると、変換された数値を受け取るバッファーへのポインター。

cchMax

型: UINT

pszOutのサイズ (文字単位)。 cchMax が 0 に設定されている場合、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 時間 mm 分 秒 形式になります。 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 プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして StrFromTimeInterval を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	shlwapi.h
ライブラリ	Shlwapi.lib
DLL	Shlwapi.dll (バージョン 4.71 以降)