GetDurationFormatEx

名前で指定したロケールに対し、時間の期間をタイム文字列として整形する。

GetDurationFormatEx lpLocaleName, dwFlags, lpDuration, ullDuration, lpFormat, lpDurationStr, cchDuration

lpLocaleName : [wstr] ロケール名へのポインタ、または以下の定義済み値のいずれか。
dwFlags : [int] 関数の動作を指定するフラグ。lpFormat が NULL でない場合、このパラメータは 0 に設定する必要がある。lpFormat が NULL の場合、アプリケーションは LOCALE_NOUSEROVERRIDE を指定して、指定したロケールのシステム既定の期間書式を用いて文字列を整形できる。注意: LOCALE_NOUSEROVERRIDE はユーザー設定を無効化するため、使用は強く非推奨である。
lpDuration : [var] 整形対象の期間情報を保持する SYSTEMTIME 構造体へのポインタ。本パラメータを無視して ullDuration を使用させたい場合、アプリケーションは NULL を設定する。
ullDuration : [int64] 期間に含まれる 100 ナノ秒間隔の数を表す 64 ビット符号なし整数。lpDuration と ullDuration の両方が設定されている場合、lpDuration パラメータが優先される。lpDuration が NULL かつ ullDuration が 0 の場合、期間は 0 になる。
lpFormat : [wstr] 後述する文字を含む書式文字列へのポインタ。指定したロケールの期間書式に従って文字列を整形する場合、アプリケーションは本パラメータに NULL を設定できる。lpFormat が NULL でない場合、関数は書式ピクチャ文字列で指定されていない情報のみロケールから参照する。
lpDurationStr : [wstr] 関数が期間文字列を取得するバッファへのポインタ。cchDuration が 0 の場合、本パラメータは NULL を取得することもできる。この場合、関数は期間文字列バッファに必要なサイズを返す。
cchDuration : [int] lpDurationStr が示すバッファのサイズ。文字数で指定する。あるいは、アプリケーションはこのパラメータを 0 に設定することもできる。その場合、関数は lpDurationStr に NULL を取得し、時間長文字列バッファに必要なサイズを返す。

(プラグイン / モジュール : kernel32.dll)

解説

名前で指定したロケールに対し、時間の期間をタイム文字列として整形する。

[戻り値]
成功した場合、lpDurationStr が示すバッファに取得した文字数を返す。lpDurationStr が NULL かつ
cchDuration が 0 の場合、関数は終端の null 文字を含む期間文字列バッファに必要なサイズを返す。例えば 10
文字をバッファに書き込む場合、終端の null 文字を含めて 11 を返す。関数が成功しなかった場合は 0
を返す。拡張エラー情報を取得するには GetLastError を呼ぶ。アプリケーションは以下のエラーコードのいずれかを取得できる。
（以下省略）

[備考]

本関数は、ファイル時刻を表示するマルチメディアアプリケーションや、フィニッシュタイムを表示するスポーツイベントアプリケーションで利用できる。本関数は
[SYSTEMTIME](https://learn.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-systemtime)
構造体の最初の 3 つのメンバ **wYear**、**wMonth**、**wDayOfWeek**
を無視する。本関数はカスタムロケールからもデータを取得できる。データはコンピュータ間やアプリケーションの実行間で同一であることは保証されない。アプリケーションがデータを永続化または送信する必要がある場合は、Using
Persistent Locale Data を参照すること。期間書式文字列の特徴は次のとおりである。
（以下省略）

情報