*文字列処理関数 [#t1e50003]

RIGHT:[[「ヘルプ補足」諸注意>../「ヘルプ補足」諸注意]]	
#contents


**Format関数 [#de98d77f]
''書式'' Format(数値,書式)

&color(red){◆保証未確認動作'''(確認ver 2.2.25)'''};~
この関数で端数が丸められるときは、''普通の四捨五入''が行われます。

***Format関数の書式文字列 [#z80754ac]
&color(red){◆保証未確認動作'''(確認ver 2.2.25)'''};~
Format関数は、VBのFormat$関数を使っています。この関数は、ヘルプ記載のほか、さまざまな書式文字列が使用できます。

以下に例を示します。(うち、「//仕様」としたもののみは&color(red){◆仕様補足説明};です)~

 # **数値**
 Talk
   $(Format(123.45, "00000.0000"))
   # "00123.4500" と表示          //仕様
 Talk
   $(Format(123.45, "0.0"))
   # "123.5" と表示
   # 整数部は"0"が一つでもすべて表示される。
   # 小数部は指定桁数で四捨五入。
 Talk
   $(Format(123.45, "#####.####"))
   # "123.45" と表示              //仕様
 Talk
   $(Format(123.45, "#.#"))
   # "123.5" と表示
   # 整数部は"#"が一つでもすべて表示される。
   # 小数部は指定桁数で四捨五入。
 Talk
   $(Format(0.12345, "#.###"))
   # ".123" と表示
   # 整数部が全て"#"なら、絶対値1未満の数は整数部表示を省略
 Talk
   $(Format(0.12345, "#0.###"))
   # "0.123" と表示
   # 整数部に"0"があれば、整数部が表示される  //仕様
 Talk
   $(Format(0.12345, "##.##%"))
   # "12.35%" と表示
   # "%" 付きは 100倍                        //仕様
 Talk
   $(Format(123456789, "###,###,##0"))
   # "123,456,789" と表示
   # 整数部末尾以外の","は、桁区切り文字     //仕様
 Talk
   $(Format(123456789, "#####,"))
   # "123457" と表示
   # 整数部末尾が","なら 1/1000 される
 Talk
   $(Format(123456789, "#####,,"))
   # "123" と表示
   # 末尾の","が増えるごとに 1/1000
 Talk
   $(Format(123456789, "#####.#E+"))
   # "12345.7E+4" と表示
   # "E+"を付けると浮動小数点表示
 Talk
   $(Format(123456789, "#####.#E-"))
   # "12345.7E4" と表示
   # "E-"なら、指数部がプラスの場合"+"を省略
 Talk
   $(Format(12345678901234, "#.###e+"))
   # "1.235e+13" と表示
   # 小文字"e+"でもよい
 Talk
   $(Format(123456789, "#.###e-00"))
   # "1.235e08" と表示
   # 指数部表示も"0", "#"で桁数指定が可能
 Talk
   $(Format(123.45, "+( ###. ##)-"))
   # "+( 123.45)-" と表示
   # -, + , (, ), 半角スペースはそのまま表示される
   # VBの仕様では"$"も同様だが未試験。
 Talk
   $(Format(123.45, "\a\b\c\=###.##"))
   # "abc=123.45" と表示
   # "\"の後の文字はそのまま表示
 Talk
   $(Format(123.45, ""abc="###.##"))
   # "abc=123.45" と表示
   # ダブルクォーテーションで囲われた文字列もそのまま表示
 Talk
   $(Format(123.45, "\\###"))
   # "\123" と表示
 
 # **定義済み書式**
 Talk
   $(Format(123.45, "General Number"))
   # "123.45" と表示
   # 元のまま表示
 Talk
   $(Format(1234567.8901, "Currency"))
   # "\1,234,568" と表示
   # "Currency"は、通貨記号、3桁区切り","、小数部四捨五入を同時に
 Talk
   $(Format(0, "Fixed"))  $(Format(12345.678, "Fixed"))
   # "0.00  12345.68" と表示
   # "Fixed"は、整数部1桁以上、小数部は2桁で四捨五入
 Talk
   $(Format(123456789, "Standard"))  $(Format(12.34567, "Standard"))
   # "123,456,789.00  12.35" と表示
   # "Standard"は、"Fixed"に加えて、3桁ごとの","を付加
 Talk
   $(Format(12.345, "Percent"))  $(Format(0.1234567, "Percent"))
   # "1234.50%  12.35%" と表示
   # 100倍して小数部2桁で四捨五入し、末尾に"%"を付加
 Talk
   $(Format(123.45, "Scientific"))  $(Format(0.000987, "Scientific"))
   # "1.23E+02  9.87E-04" と表示
   # "Scientific"は、科学記法に。
 Talk
   $(Format(1, "True/False"))  $(Format(0, "True/False"))
   # "True  False" と表示
   # 値がゼロなら"False"、それ以外は"True"
 Talk
   $(Format(1, "Yes/No"))  $(Format(0, "Yes/No"))
   # "Yes  No" と表示
 Talk
   $(Format(1, "On/Off"))  $(Format(0, "On/Off"))
   # "On  Off" と表示
 Talk
   $(Format(1, "Maru/Batsu"))  $(Format(0, "Maru/Batsu"))
   # **エラーになる**   "/"で分ける記法は上の三つだけ。
 End

#hr

第1引数には、文字列も可能です。

 Talk
   $(Format("abc", "@"))
   # "abc" と表示
   # 文字列の表示
 Talk
   $("*" & Format("abc", "@@@@@") & "*")
   # "*  abc*" と表示
   # "@"が多いと右詰め。左にスペース付加。
 Talk
   $("*" & Format("abc", "@@@@@!") & "*")
   # "*abc  *" と表示
   # "!"が付くと左詰(右にスペース)に。
 Talk
   $(Format("abc", "&"))
   # "abc" と表示
   # "&"も文字列指定
 Talk
   $("*" & Format("abc", "&&&&&") & "*")
   # "*abc*" と表示
   # "&"なら余分な指定長は切り詰められる
 Talk
   $(Format("AbCdeF", "@@@@@@<"))
   # "abcdef" と表示
   # "<"が付くと大文字→小文字に。全角には無効
 Talk
   $(Format("AbCdeF", "@@@@@@>"))
   # "ABCDEF" と表示
   # ">"が付くと小文字→大文字に。全角には無効