FORMAT 関数は、N 番目の引数で %N の出現を置き換えることで書式設定した後に、文字列値として指定された文字列を返します。
構文
FORMAT (string, argument 1[, argument 2, …, argument N])
引数
string: 文字列
書式設定が必要な文字列タイプのデータ ソースを参照。 この引数は必須です。
argument 1: 文字列
%1 の出現に置き換えるために使用される最初の引数。 この引数は必須です。
argument N: 文字列
%2、%3 などの出現に置き換えるために使用される N 番目の引数。 これらの追加引数はオプションです。
戻り値
文字列
結果テキスト値。
使用上の注意
パラメーターに引数が指定されない場合は、文字列内では "%N" として返されます。 実数型の値では、既定の文字列変換が小数点第 2 位に制限されます。
例
次の図では、PaymentModel データ ソースが顧客コンポーネントを使用して顧客レコードの一覧を返します。 ProcessingDate フィールドを使用して、処理日の値を返します。
選択した顧客の電子ファイルを生成するよう設計されている電子申告 (ER) 形式では、PaymentModel がデータ ソースとして選択され、プロセス フローを制御します。 選択した顧客がレポートを処理される日付に停止されている場合、例外であることをユーザーに通知し、スローされます。 このタイプの処理制御のために設計された式は、次のリソースを使用できます。
次のテキストを含むラベル SYS70894:
- EN-US 言語の場合: "Nothing to print"
- DE 言語の場合: "Nichts zu drucken"
次のテキストを含むラベル SYS18389:
- EN-US 言語の場合: "顧客 %1 は停止 %2。"
- DE 言語の場合: "Debitor '%1' wird für %2 gesperrt."
設計できる式を次に示します。
FORMAT (CONCATENATE (@"SYS70894", ". ", @"SYS18389"), model.Customer.Name, DATETIMEFORMAT (model.ProcessingDate, "d"))
レポートが 2015 年 12 月 17 日に EN-US カルチャおよび EN-US 言語で Litware Retail の顧客に対して処理される場合、この式は例外メッセージとしてユーザーに示すことができる次のテキストを返します:
印刷対象なし。 顧客の Litware Retail は 2015 年 12 月 17 日に停止されます。
同じレポートが 2015 年 12 月 17 日に DE カルチャおよび DE 言語で Litware Retail の顧客に対して処理される場合、この式は別の日付形式を使用する次のテキストを返します。
Nichts zu drucken。 顧客の Litware Retail は 2015 年 12 月 17 日に停止されます。
メモ
次の構文は ER の式でラベルに適用されます。
- Microsoft Dynamics 365 Finance アプリにあるリソースからのラベルの場合:X がアプリケーション オブジェクト ツリー (AOT) のラベル ID にある @X
- ER コンフィギュレーションに存在するラベルの場合:@"GER_LABEL:X"、X は ER コンフィギュレーションのラベル ID です