日付、数値、および文字列の書式設定

トピックの概要

目的

このトピックは、$.ig.formatter ユーティリティ関数を使用して日付、数値、および文字列を書式設定する方法を紹介します。

このトピックの内容

このトピックは、以下のセクションで構成されます。

• 概要
• 日付の書式設定
• 数値の書式設定
• 文字列の書式設定

概要

infragistics.util ファイルは、Ignite UI for jQuery コントロールで日付、数値、文字列を書式設定するための $.ig.formatter のユーティリティ関数を含みます。たとえば、igGrid の format オプションで使用されます。 関数定義: $.ig.formatter = function (val, type, format, notTemplate, enableUTCDates, displayStyle, labelText, tabIndex)。結果は string 型です。

このトピックは関数の最初の 3 つのパラメーターを説明します。

• val - 書式設定する値。
• type - 値のデータ型。
• format - 書式指定子 (以下のセクションで詳細を説明します)。

関数は $.ig.regional.defaults 変数で構成される領域設定を使用します。

以下のセクションは $.ig.formatter の使用方法を説明します。

日付の書式設定

type パラメーターが "date" の場合、 $.ig.formatter 関数は日付を解析します。val 引数に Date 型が必要です。

JavaScript の場合:

var result = $.ig.formatter(new Date(2016, 05, 01), "date", "yyyy-MM-dd"); // result is "2016-06-01"

サポートされる書式指定子のリスト:

数値の書式設定

type パラメーターが "number" の場合、 $.ig.formatter 関数は数値を解析します。val 引数に Number 型が必要です。

JavaScript の場合:

var result = $.ig.formatter(0.55, "number", "0.0"); // result is "0.6"

サポートされる書式指定子のリスト:

文字列の書式設定

type パラメーターが "string" の場合、 $.ig.formatter 関数は文字列を解析します。 {0} プレースホルダーが format パラメーターで、結果の文字列に value パラメーターの位置を示すために使用できます。

JavaScript の場合:

var result = $.ig.formatter("Black", "string", "Color is {0}");