Format オブジェクト

文字列変換オブジェクト。

文字列変換を行うAPIを持つオブジェクトです。

使用例:
ファンクション・コンテナ

var objFormat = new Object();

objFormat.testS = Format.get("文字列の変換を「%4s」行います。","intra-mart");
objFormat.testN = Format.get("数値データを4進数に変換「%4n」します。",20);
objFormat.testD = Format.get("数値データを10進数に変換「%7.3d」します。",1234567.89123);
objFormat.testX = Format.get("数値データを16進数に変換「%3x」します。",55);
objFormat.testB = Format.get("数値データを2進数に変換「%4b」します。",12);
objFormat.testM = Format.get("数値データを3桁カンマ区切り数字列に変換「%m」します。",333444555666);
objFormat.testT = Format.get("今日の日付を日付文字列(フォーマット固定)に変換「%t」します。",new Date());
objFormat.test = Format.get("%文字を表示「%%」します。");

2001年2月13日というデータを表示する場合、月のデータは0 - 11で表現される(1月=0)ため、(月-1)したデータを new Date 関数の第2引数に指定する。

objFormat.testDate = Format.fromDate("yyyy/MM/dd", new Date(2001,1, 13));

Debug.browse(objFormat);

バージョン:1.0
導入されたバージョン:2.0

メソッドの概要
static String fromDate(String format ,Date date)
フォーマット指定に沿った形に日付を文字列に変換します。
static String fromNumber(String format ,Number value)
フォーマット指定に沿った形に数値を文字列に変換します。
static String get(String format ,Object arg [,... ...])
引数値をformatにあわせて文字列に変換します。
static Date toDate(String format ,String src)
フォーマット指定に沿った日付文字列データをDate型オブジェクトへ変換します。
static String toMoney(Number value)
3桁ずつのカンマ区切り数字列を生成します。

メソッドの詳細
fromDate

static String fromDate(String format ,Date date)

フォーマット指定に沿った形に日付を文字列に変換します。

フォーマット指定文字
記号 意味
y
M
d
h 午前/午後の時 (1 - 12)
H 一日における時 (0 - 23)
k 一日における時 (1 - 24)
m
s
S ミリ秒
a 午前/午後
E 曜日
' テキスト用エスケープ
'' 単一引用符
パラメータ
format String フォーマット指定文字列
date Date 日付データ
返却値
String 変換後の文字列

fromNumber

static String fromNumber(String format ,Number value)

フォーマット指定に沿った形に数値を文字列に変換します。

フォーマット指定文字
0 - 数字
# - 数字。ゼロだと表示されない
. - 数値桁区切り文字の位置
, - グループ区切り文字位置
パラメータ
format String フォーマット指定文字列
value Number 数値データ
返却値
String 変換後の文字列

get

static String get(String format ,Object arg [,... ...])

引数値をformatにあわせて文字列に変換します。

フォーマット指定文字
%s → 文字列の変換 (%3s で後方3バイトのみ変換、指定文字列が3バイトより短い場合、前方に空白を追加)
%n → 数値変換 (%4n で4進数に変換)
%d → 10進数変換 (%8.3d で整数8桁&小数&桁変換)
%x → 16進数変換 (%4x で4桁 "0" マスク変換)
%b → 2進数変換 (%8b で8桁 "0" マスク変換)
%m → 数値まはた数字の3桁カンマ区切り数字列への変換
%t → DATE変数変換
%% → "%" 文字へ変換
パラメータ
format String フォーマット指定文字列
arg Object データ
... ... 複数指定する場合は、カンマの後に続けて指定します。(データは16個までです)
返却値
String 変換後の文字列

toDate

static Date toDate(String format ,String src)

フォーマット指定に沿った日付文字列データをDate型オブジェクトへ変換します。
変換に失敗した場合は、nullを返却します。
パラメータ
format String フォーマット指定文字列
src String 日付文字列データ
返却値
Date 変換後のDate型オブジェクト

toMoney

static String toMoney(Number value)

3桁ずつのカンマ区切り数字列を生成します。

少数部分の値は2桁までの表示となります。
パラメータ
value Number 数値データ
返却値
String 変換された文字列