format 関数で使用される書式文字列は、 .NETグローバリゼーションライブラリで使用される書式とほぼ同じです。 使用可能な書式について説明するリンクを以下に示します。

• 標準の数値書式指定文字列
• 標準の日時書式指定文字列
• カスタムの日時書式指定文字列

format パラメータには、.NET形式の カスタム日時形式文字列 と次の追加要素が含まれます。

• Q, q カレンダー四半期。
• U 会計四半期（政府）。
• u 会計四半期（民間）。
• EEEE, EEE, EE, E 会計年度（政府）。
• eeee, eee, ee, e 会計年度（民間）。

次に例を示します。

pre> var d = new Date(2015, 9, 1); // 2015年10月1日 console.log(wijmo.Globalize.format(d, '"FY"EEEE"Q"U') + ' (US culture)'); gt; FY2016Q1 (US culture) /pre>

日本の文化で定義されているような複雑な時代に対処するための別の追加機能があります。

• ggg 時代の名前（例： '平成'、 '昭和'、 '大正'、 または '明治').
• gg 時代のイニシャル (例：. '平'、 '昭', '大'、 または '明').
• g 時代の記号 (例： 'H'、 'S'、 'T'、 または 'M').

Example

formatNumber メソッドは、すべての .NET形式の 標準の数値書式指定文字列 を受け入れ、 スケーリング、プレフィックス、サフィックス、およびカスタム通貨記号をサポートします。

数値書式文字列の形式はAxxssccです。

• A は、1つのアルファベット文字で表される書式指定子です。 大文字小文字は区別されません。
• xx は、整数で表されるオプションの精度指定子です。 精度指定子は、結果の桁数に影響します。
• ss は、数値のスケールするためのオプションの文字列です。これを指定する場合は、カンマで構成する必要があります。 数値が指定されたカンマごとに1000で除算されます。
• cc は、通貨値の書式設定を行う際に、通貨シンボルをオーバーライドするために使用されるオプションの文字列です。 これは、現在のデフォルトとは異なる カルチャの通貨値を書式設定する場合に役立ちます （たとえば、英語カルチャを使用するアプリケーションでユーロや円の値を 書式設定する場合）

次の表では、標準の数値書式指定子について説明し、 またデフォルトのカルチャの各書式指定子によって 生成される出力例を表示します。

c 通貨: formatNumber(1234, 'c') => '$1,234.00'
d 10進数（整数）: formatNumber(-1234, 'd6') => '-001234'
e 科学表記（小文字の「e」）: formatNumber(123.456, 'e6') => '1.234560e+2' E 科学表記（大文字の「e」）: formatNumber(123.456, 'E6') => '1.234560E+2' f 固定小数点: formatNumber(1234.5, 'f2') => '1234.50'
F 固定小数点（桁区切り記号付き）: formatNumber(1234.5, 'F2') => '1,234.50'
g 汎用（末尾のゼロなし）: formatNumber(1234.50, 'g2') => '1234.5'
G 汎用（末尾のゼロなし、 桁区切り記号): formatNumber(1234.5, 'G2') => '1,234.5'
n 数値: formatNumber(1234.5, 'n2') => '1,234.50'
P パーセント（千単位の区切り文字なし）: formatNumber(12.34, 'P2') => '1234%' r ラウンド トリップ (g15と同じ): formatNumber(0.1234, 'r') => '0.1234' x 16進数（整数）: formatNumber(1234, 'x6') => '0004d2'

単位変更指定子は、大きな値をチャートに表示する場合に特に便利です。たとえば、 次のマークアップは、人口とGDPをプロットするチャートを作成します。 生のデータでは、 人口は人数そのもの、GDPは100万単位です。 軸の書式設定で指定された単位変更に基づいて、人口は100万単位、GDPは兆単位で表示されます。

import { FlexChart} from '@grapecity/wijmo.chart';
new FlexChart('#theChart', {
    itemsSource: countriesGDP,
    bindingX: 'pop',
    chartType: 'Scatter',
    series: [
        { name: 'GDP', binding: 'gdp' }
    ],
    axisX: {
        title: 'Population (millions)'
        format: 'n0,,'
    },
    axisY: {
        title: 'GDP (US$ trillions)'
        format: 'c0,,'
    }
});

書式文字列には、出力に追加される定数の接頭辞と接尾辞の文字列を含めることもできます。

存在する場合、接頭辞と接尾辞は、フォーマット文字列の先頭と末尾に 二重引用符で囲まれた文字列として指定されます。

import { Globalize } from '@grapecity/wijmo';
console.log(Globalize.formatNumber(value, '"thousands: "c3," k"'));
console.log(Globalize.formatNumber(value, '"millions: "c1,," M"'));

返される値は0（日曜日）~6（土曜日）です。

2桁の年は、カレンダーの twoDigitYearMax プロパティの値に基づいて、完全な年に変換されます。 デフォルトでは、このプロパティは2029に設定されています。 つまり、2桁の30～99の値は19xxになり、0～29の値は20xxになります。 このしきい値は、カレンダーに新しい値を割り当てて変更できます。 次に例を示します。

// カレンダーを取得します
var cal = wijmo.culture.Globalize.calendar;

// デフォルトのしきい値は2029なので、"30"は1930と解析されます
cal.twoDigitYearMax = 2029;
var d1 = wijmo.Globalize.parseDate('30/12', 'yy/MM'); // 2030年12月

// しきい値を2100に変更すると、すべての値が20**と解析されます
cal.twoDigitYearMax = 2100;
var d2 = wijmo.Globalize.parseDate('30/12', 'yy/MM'); // 2030年12月