Number JavaScript オブジェクト

QML Number オブジェクトは JS Number オブジェクトをロケール対応関数で拡張したものです。

string Number::toLocaleString(locale, format, precision)

Number を、指定されたformat の指定されたlocale で、指定されたprecision に適した文字列に変換します。

有効なフォーマットは次のとおりです：

• 'f' 10進浮動小数点、例えば 248.65
• e' e 文字を使った科学表記法、例：2.4865e+2。
• 'E' E文字を使った科学表記法、例：2.4865E+2
• 'g' eまたはfの短い方を使う。
• 'G' Eまたはfのうち短い方を使う。

精度が指定されていない場合、精度は2となる。

書式が指定されていない場合、'f'が使われる。

locale が指定されなければ、デフォルトのロケールが使われる。

次の例は、ドイツ語ロケール用にフォーマットされた数値を示しています：

import QtQuick 2.0

Text {
    text: "The value is: " +  Number(4742378.423).toLocaleString(Qt.locale("de_DE"))
}

locale の個々のフィールドをカスタマイズして、出力を厳密に制御することができます：

let locale = Qt.locale("de_DE");
let a = Number(1000).toLocaleString(locale)); // a == 1.000,00
locale.numberOptions = Locale.OmitGroupSeparator;
let b = Number(1000).toLocaleString(locale)); // b == 1000,00

toLocaleString()を定数に直接適用することもできます。

123.0.toLocaleString(Qt.locale("de_DE")) // OK
123..toLocaleString(Qt.locale("de_DE"))  // OK
123.toLocaleString(Qt.locale("de_DE"))   // fails

文字列 Number::toLocaleCurrencyString(locale, symbol)

指定したlocale の通貨および規約を使用して、数値を通貨に変換します。symbol を指定した場合は、それが通貨記号として使用されます。

文字列 Number::fromLocaleString(locale, number)

指定したlocale の規約を使用してnumber をパースし、数値を返します。

locale が指定されていない場合は、デフォルトのロケールが使用されます。

たとえば、ドイツ語のロケールを使用します：

var german = Qt.locale("de_DE");
var d;
d = Number.fromLocaleString(german, "1234,56")   // d == 1234.56
d = Number.fromLocaleString(german, "1.234,56") // d == 1234.56
d = Number.fromLocaleString(german, "1234.56")  // throws exception
d = Number.fromLocaleString(german, "1.234")    // d == 1234.0