このサイトをビューするために JavaScript を有効化してください。

Altova MapForce 2020 Enterprise Edition

XSLT 1.0 や XSLT 2.0、Java、C#、C++ や内蔵の実行エンジンで利用することができます。

 

fn-format-number

 

引数

説明

value

必須の引数。 フォーマットする値。

format

必須の引数。 数値を整形(フォーマット)するためのフォーマット文字列。

この引数はformat-dateTime 関数内の format 引数と同じ方法で使用されます。

decimal-point-format

オプションの引数。 小数点に使用される文字。デフォルトでは "." になります

grouping-separator

オプションの引数。 数値グループを分割するために使用されるセパレーター/デリミタ。デフォルトでは "," になります。

 

メモ:値はターゲットの型へキャストされるため、関数の出力 (result) が string 型以外のノードへ接続されている場合、書式が失われる可能性があります。ターゲットコンポーネントのコンポーネント設定にて値をターゲットの方にキャストチェックボックスのチェックを外すことで、自動キャストを無効にすることができます。

 

フォーマット:

 format := subformat (;subformat)?

 subformat := (prefix)? integer (.fraction)? (suffix)?

 prefix := 特別文字以外の文字

 suffix := 特別文字以外の文字

 integer := (#)* (0)* ( allowing ',' to appear)

 fraction := (0)* (#)* (allowing ',' to appear)

 

最初の subformat が正の数のフォーマットに使用され、 2 番目の subformat が負の数に対して使用されます。subformat が 1 つだけ指定された場合、同じ subformat が正の数と負の数に使用され、負の数の場合は prefix の前にマイナス記号が挿入されます。

 

特別な文字

デフォルト

説明

zero-digit

0

result にてこの場所に常に数値が表示されます。

digit

#

最終的に 0 になる場合を除き、result の文字列にてこの場所に常に数値が表示されます。

decimal-point

.

数値の整数部と小数点以下を分けるために使用されます。

grouping-seperator

,

数値のグループ分けを行うのに使用されます。

percent-sign

%

数値を100倍して、パーセンテージとして表示します。

per-mille

数値を1000倍して、パーミルとして表示します。

 

decimal-point-character と grouping-separator に使用される文字は、それぞれ常に "." と "," になります。しかしこれらのノードに定数をマッピングすることで、出力されるフォーマットを変更することができます。

 

fn-form-nr

 

上に示される format-number 関数のマッピング結果を以下に示します:

decimal-point-character が "+" に変更されました。

grouping-separator が "-" に変更されました。

 

fn-form-nr2

 

四捨五入

端数処理には四捨五入が使用されます。つまり端数が 0.5 以上であれば切り上げが行われ、0.5 未満であれば切り捨てが行われます。このメソッドは、生成されたコードとビルトイン実行エンジンでのみ使用することができます。

 

XSLT 1.0 では四捨五入のモードが定義されておらず、XSLT 2.0 では偶数丸めが行われます。

 

数値

書式文字列

結果

1234.5

#,##0.00

1,234.50

123.456

#,##0.00

123.46

1000000

#,##0.00

1,000,000.00

-59

#,##0.00

-59.00

1234

###0.0###

1234.0

1234.5

###0.0###

1234.5

.00025

###0.0###

0.0003

.00035

###0.0###

0.0004

0.25

#00%

25%

0.736

#00%

74%

1

#00%

100%

-42

#00%

-4200%

-3.12

#.00;(#.00)

(3.12)

-3.12

#.00;#.00CR

3.12CR

(C) 2019 Altova GmbH