数値を文字列に変換します。
構文
STRING(数値, 長さ <,書式>)
パラメーター
名前 | 型 | 説明 |
---|---|---|
数値 |
数値 |
文字に変換する数値。 |
長さ | 数値 |
出力文字列の長さの文字数。
指定した長さのスペースが十分にあり、任意の書式パラメーターを指定した場合の数値以外の書式文字など、フィールドで最も長い数値が格納されることを確認してください。 |
書式
省略可能 |
文字 |
出力文字列に適用する書式。 書式は二重引用符で囲む必要があります。 例: "(9,999.99)" 任意の書式パラメーターを使用して、ソース データに存在しない出力文字列に書式を追加します。 ドル記号、パーセント記号、1 つ以上の小数点プレースホルダー、千の位の桁区切り文字、括弧などを追加できます。 メモ 指定する数値以外の書式文字では、数値の長さが増えます。 |
出力
文字。
例
基本的な例(出力が書式設定されていない)
数値 125.2
" 125.2" が返されます。
STRING(125.2, 6)
長さの値が 6 で、数値の桁数と書式文字よりも 1 文字長いため、出力文字列の先頭には 1 つのスペースが埋め込まれます。
数値 -125.2
"25.2" が返されます。
STRING(-125.2, 4)
長さの値が 4 で、数値の桁数と書式文字よりも 2 文字短いため、出力文字列は切り詰められます。
"-125.2" が返されます。
STRING(-125.2, 7)
長さの値が 7 で、数値の桁数と書式文字よりも 1 文字長いため、出力文字列の先頭には 1 つのスペースが埋め込まれます。
基本的な例(出力が書式設定されている)
数値 125.2
"25.20" が返されます。
STRING(125.2, 6, "(9,999.99)")
長さの値が 6 で、指定した書式が適用された後の数値よりも 1 文字短いため、出力文字列は切り詰められます。
"125.20" が返されます。
STRING(125.2, 7, "(9,999.99)")
メモ
特定の数値のインスタンスで書式文字が必要ではない場合であっても、書式に指定した文字は、右側から数値の長さの計算に含まれます。 上記の例では、数値で正値を表すために括弧が必要でない場合でも、右端の括弧が文字としてカウントされます。
数値 -125.2
" (125.20)" が返されます。
STRING(-125.2, 10, "(9,999.99)")
長さの値が 10 で、指定した書式が適用された後の数値よりも 2 文字長いため、出力文字列の先頭に 2 つのスペースが埋め込まれます。
基本的な例(フィールド入力)
文字列型の長さ 10 文字の数値を Employee_number フィールドが返されます。 必要に応じて、出力文字列は空白が埋め込まれたり、切り捨てられたりします。
STRING(Employee_number, 10)
備考
出力文字列の書式設定
出力文字列の書式を設定し、ソース データには含まれていない場合でも、書式を表示することができます。
書式のプレースホルダー桁数
指定する書式で、数字 9 は桁数のプレースホルダーとして機能します。 フィールドの最も長い数値を格納できるように、必ず十分なプレースホルダー桁数を指定してください。 たとえば、フィールドの金額が最大 $5,000,000 で、小数点 2 桁まである場合は、9 桁のプレースホルダー "$9,999,999.99" を指定する必要があります。
出力文字列で必要な最小の長さに書式が及ぼす影響
長さで指定する値は、少なくとも、フィールドの最も長い値のすべての数字と、指定するすべての書式文字を格納できる長さが必要です。
最大 $5,000,000 の金額を含むフィールドの値に、ドル記号と千の位の桁区切り文字を追加する場合は、長さに 13(9 桁 + 4 文字の数値以外の書式文字)以上を指定する必要があります。
金額フィールドの数値が、指定した書式が付いた文字列として返されます。
STRING(Amount, 13, "$9,999,999.99")
$4,789,123.50 が文字列として返されます。
STRING(4789123.50, 13, "$9,999,999.99")
関連する関数
STRING( ) 関数は VALUE( ) 関数の逆関数です。後者は、文字データを数値データに変換します。