FORMAT関数は、%Nの出現箇所を N 番目の引数に置き換えて文字列を書式設定した後、指定した文字列を文字列値として返します。
Syntax
FORMAT (string, argument 1[, argument 2, …, argument N])
Arguments
string: 文字列
書式設定する 文字列 型のデータ ソースへの参照。 この引数は必須です。
argument 1: 文字列
最初の引数。 %1の出現箇所を置き換えます。 この引数は必須です。
argument N: 文字列
N番目の引数は、%2、%3などの出現箇所を置き換えます。 これらの追加引数はオプションです。
戻り値
ストリング
結果テキスト値。
使用に関する注記
パラメーターの引数を指定しない場合、文字列には "%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"))
2025年12月17日に Litware小売 顧客のレポートを EN-US 文化および EN-US 言語で処理した場合、この式は以下のテキストを返し、ユーザーに例外メッセージとして提示できます。
印刷対象なし。 カスタマーリトウェアリテールは2025年12月17日に停止されます。
2025年12月17日にLitware小売顧客に対してDE文化とDE言語で同じレポートを処理すると、式は異なる日付形式を用いた以下のテキストを返します。
Nichts zu drucken。 Debitor 'Litware Retail' wird für 17.12.2025 gesperrt.
Note
次の構文は ER の式でラベルに適用されます。
- Microsoft Dynamics 365 Finance アプリ内のリソースからのラベル:@X。ここで、X はアプリケーション オブジェクト ツリー (AOT) のラベル ID です
- ER コンフィギュレーションに存在するラベルの場合:X が ER コンフィギュレーションのラベル ID にある @"GER_LABEL:X"
その他のリソース
テキスト関数