java.text.Format
org.apache.commons.lang.time.FastDateFormat
|
|||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
java.lang.Object
FastDateFormat は高速に動作するスレッドセーフな SimpleDateFormat です。
このクラスは SimpleDateFormat
を使用したフォーマットを行う大抵の処理をそのまま置き換えることが出来ます。
このクラスは特にマルチスレッドで動作するサーバ環境で有用です。
SimpleDateFormat は全ての JDK のバージョンにおいてスレッドセーフではなく、
Sun はこれをバグまたは要望として対応することもありません。
このクラスはフォーマットの処理にのみ対応しますが、全てのパターンのフォーマットの処理が SimpleDateFormat と互換性を持ちます(タイムゾーンを除いて - 以下を参照)。
Java 1.4 は RFC822 のフォーマットでタイムゾーンを表す 'Z'
という新しいパターンの文字を取り入れました(例えば +0800 や -1100)。
このクラスでは(全ての JDK のバージョンで)この文字を使用することができます。
加えて、 'ZZ' のパターンは ISO8601
のフルフォーマットのタイムゾーンを表します(例えば +08:00 や -11:00)。
これは Java 1.4 との多少の非互換性を招きますが、有用な機能を得ることとなります。
| 入れ子クラスの概要 |
| クラス java.text.Format から継承した入れ子クラス |
Format.Field |
| フィールドの概要 | |
static int |
FULL
FULL ロケールに依存した日付または時間のフォーマットのための定数です。 |
static int |
LONG
LONG ロケールに依存した日付または時間のフォーマットのための定数です。 |
static int |
MEDIUM
MEDIUM ロケールに依存した日付または時間のフォーマットのための定数です。 |
static int |
SHORT
SHORT ロケールに依存した日付または時間のフォーマットのための定数です。 |
| コンストラクタの概要 | |
protected |
FastDateFormat(String pattern,
TimeZone timeZone,
Locale locale)
新たな FastDateFormat を生成します。 |
| メソッドの概要 | |
protected StringBuffer |
applyRules(Calendar calendar,
StringBuffer buf)
指定されたカレンダーにルールを適用してフォーマットを実施します。 |
boolean |
equals(Object obj)
2つのオブジェクトが等しいかどうか比較します。 |
String |
format(Calendar calendar)
Calendar オブジェクトをフォーマットします。
|
StringBuffer |
format(Calendar calendar,
StringBuffer buf)
Calendar オブジェクトをフォーマットし、指定された
StringBuffer に出力します。
|
String |
format(Date date)
Date オブジェクトをフォーマットします。
|
StringBuffer |
format(Date date,
StringBuffer buf)
Date オブジェクトをフォーマットし、指定された
StringBuffer に出力します。
|
StringBuffer |
format(Object obj,
StringBuffer toAppendTo,
FieldPosition pos)
Date オブジェクトまたは Calendar オブジェクトをフォーマットします。
|
static FastDateFormat |
getDateInstance(int style,
TimeZone timeZone,
Locale locale)
指定されたスタイル、タイムゾーン、ロケールを用いて日付のフォーマッターインスタンスを取得します。 |
static FastDateFormat |
getDateTimeInstance(int dateStyle,
int timeStyle,
TimeZone timeZone,
Locale locale)
指定されたスタイル、タイムゾーン、ロケールを用いて日付/時間のフォーマッターインスタンスを取得します。 |
static FastDateFormat |
getInstance()
デフォルトのロケールとデフォルトのパターンを用いてフォーマッターのインスタンスを取得します。 |
static FastDateFormat |
getInstance(String pattern)
デフォルトのロケールと指定されたパターンを用いてフォーマッターのインスタンスを取得します。 |
static FastDateFormat |
getInstance(String pattern,
Locale locale)
指定されたパターンと指定されたロケールを用いてフォーマッターのインスタンスを取得します。 |
static FastDateFormat |
getInstance(String pattern,
TimeZone timeZone)
指定されたパターンと指定されたタイムゾーンを用いてフォーマッターのインスタンスを取得します。 |
static FastDateFormat |
getInstance(String pattern,
TimeZone timeZone,
Locale locale)
指定されたパターン、タイムゾーン、ロケールを用いてフォーマッターのインスタンスを取得します。 |
Locale |
getLocale()
このフォーマッターで使用されるロケールを取得します。 |
int |
getMaxLengthEstimate()
このフォーマッターが生成する文字列の最大長の見積もりを返します。 |
String |
getPattern()
このフォーマッターで使用されるパターンを取得します。 |
static FastDateFormat |
getTimeInstance(int style,
TimeZone timeZone,
Locale locale)
指定されたスタイル、タイムゾーン、ロケールを用いて時間のフォーマッターインスタンスを取得します。 |
TimeZone |
getTimeZone()
このフォーマッターで使用されるタイムゾーンを取得します。 |
boolean |
getTimeZoneOverridesCalendar()
カレンダーのタイムゾーンがフォーマッターに上書きされる場合、 true を返します。
|
int |
hashCode()
適切なハッシュコードです。 |
protected void |
init()
最初に使用される際のインスタンスの初期化を行います。 |
Object |
parseObject(String source,
ParsePosition pos)
パース処理はサポートされません。 |
protected List |
parsePattern()
パターンから生成された Rule のリストを返します。 |
protected String |
parseToken(String pattern,
int[] indexRef)
トークンのパースを行います。 |
protected org.apache.commons.lang.time.FastDateFormat.NumberRule |
selectNumberRule(int field,
int padding)
要求されたパディングに対する適切なルールを返します。 |
String |
toString()
このフォーマッターを説明するデバッグのための文字列 |
| クラス java.text.Format から継承したメソッド |
clone, format, formatToCharacterIterator, parseObject |
| クラス java.lang.Object から継承したメソッド |
finalize, getClass, notify, notifyAll, wait, wait, wait |
| フィールドの詳細 |
public static final int FULL
public static final int LONG
public static final int MEDIUM
public static final int SHORT
| コンストラクタの詳細 |
protected FastDateFormat(String pattern,
TimeZone timeZone,
Locale locale)
新たな FastDateFormat を生成します。
pattern - SimpleDateFormat と互換性のあるパターン
timeZone - 使用されるタイムゾーン、 null が指定された場合、
Date と Calendar に対してデフォルトの値が使用されます
locale - 使用されるロケール、 null が指定された場合、システムのデフォルトが使用されます
IllegalArgumentException - パターンが不正または null の場合
| メソッドの詳細 |
public static FastDateFormat getInstance()
デフォルトのロケールとデフォルトのパターンを用いてフォーマッターのインスタンスを取得します。
public static FastDateFormat getInstance(String pattern)
デフォルトのロケールと指定されたパターンを用いてフォーマッターのインスタンスを取得します。
pattern - SimpleDateFormat と互換性のあるパターン
IllegalArgumentException - パターンが不正な場合
public static FastDateFormat getInstance(String pattern,
TimeZone timeZone)
指定されたパターンと指定されたタイムゾーンを用いてフォーマッターのインスタンスを取得します。
pattern - SimpleDateFormat と互換性のあるパターン
timeZone - フォーマットされた日付のタイムゾーンを上書きする任意のタイムゾーン
IllegalArgumentException - パターンが不正な場合
public static FastDateFormat getInstance(String pattern,
Locale locale)
指定されたパターンと指定されたロケールを用いてフォーマッターのインスタンスを取得します。
pattern - SimpleDateFormat と互換性のあるパターン
locale - システムのロケールを上書きする任意のロケール
IllegalArgumentException - パターンが不正な場合
public static FastDateFormat getInstance(String pattern,
TimeZone timeZone,
Locale locale)
指定されたパターン、タイムゾーン、ロケールを用いてフォーマッターのインスタンスを取得します。
pattern - SimpleDateFormat と互換性のあるパターン
timeZone - フォーマットされた日付のタイムゾーンを上書きする任意のタイムゾーン
locale - システムのロケールを上書きする任意のロケール
パターンが不正または - null な場合
public static FastDateFormat getDateInstance(int style,
TimeZone timeZone,
Locale locale)
指定されたスタイル、タイムゾーン、ロケールを用いて日付のフォーマッターインスタンスを取得します。
style - 日付のスタイル:FULL または LONG または MEDIUM または SHORT
timeZone - フォーマットされた日付のタイムゾーンを上書きする任意のタイムゾーン
locale - システムのロケールを上書きする任意のロケール
IllegalArgumentException - ロケールが定義された日付のパターンを持っていない場合
public static FastDateFormat getTimeInstance(int style,
TimeZone timeZone,
Locale locale)
指定されたスタイル、タイムゾーン、ロケールを用いて時間のフォーマッターインスタンスを取得します。
style - 時間のスタイル:FULL または LONG または MEDIUM または SHORT
timeZone - フォーマットされた日付のタイムゾーンを上書きする任意のタイムゾーン
locale - システムのロケールを上書きする任意のロケール
IllegalArgumentException - ロケールが定義された時間のパターンを持っていない場合
public static FastDateFormat getDateTimeInstance(int dateStyle,
int timeStyle,
TimeZone timeZone,
Locale locale)
指定されたスタイル、タイムゾーン、ロケールを用いて日付/時間のフォーマッターインスタンスを取得します。
dateStyle - 日付のスタイル:FULL または LONG または MEDIUM または SHORT
timeStyle - 時間のスタイル:FULL または LONG または MEDIUM または SHORT
timeZone - フォーマットされた日付のタイムゾーンを上書きする任意のタイムゾーン
locale - システムのロケールを上書きする任意のロケール
IllegalArgumentException - ロケールが定義された日付/時間のパターンを持っていない場合
protected void init()
最初に使用される際のインスタンスの初期化を行います。
protected List parsePattern()
パターンから生成された Rule のリストを返します。
List
IllegalArgumentException - パターンが不正な場合
protected String parseToken(String pattern,
int[] indexRef)
トークンのパースを行います。
pattern - パターン
indexRef - 参照のインデックス
protected org.apache.commons.lang.time.FastDateFormat.NumberRule selectNumberRule(int field,
int padding)
要求されたパディングに対する適切なルールを返します。
field - ルールを取得する対象となるフィールド
padding - 要求されたパディング
public StringBuffer format(Object obj,
StringBuffer toAppendTo,
FieldPosition pos)
Date オブジェクトまたは Calendar オブジェクトをフォーマットします。
obj - フォーマットの対象となるオブジェクト
toAppendTo - 書き込み先となるバッファ
pos - フォーマットする位置 - 無効
public String format(Date date)
Date オブジェクトをフォーマットします。
date - フォーマットの対象となる日付
public String format(Calendar calendar)
Calendar オブジェクトをフォーマットします。
calendar - フォーマットの対象となるカレンダー
public StringBuffer format(Date date,
StringBuffer buf)
Date オブジェクトをフォーマットし、指定された
StringBuffer に出力します。
date - フォーマットの対象となる日付
buf - 書き込み先となるバッファ
public StringBuffer format(Calendar calendar,
StringBuffer buf)
Calendar オブジェクトをフォーマットし、指定された
StringBuffer に出力します。
calendar - フォーマットの対象となるカレンダー
buf - 書き込み先となるバッファ
protected StringBuffer applyRules(Calendar calendar,
StringBuffer buf)
指定されたカレンダーにルールを適用してフォーマットを実施します。
calendar - フォーマットの対象となるカレンダー
buf - 書き込み先となるバッファ
public Object parseObject(String source,
ParsePosition pos)
パース処理はサポートされません。
source - パースの対象となる文字列
pos - パーすする位置
null
public String getPattern()
このフォーマッターで使用されるパターンを取得します。
SimpleDateFormat と互換性のあるパターン
public TimeZone getTimeZone()
このフォーマッターで使用されるタイムゾーンを取得します。
このタイムゾーンは常時 Date のフォーマットに使用されます。
Calendar がフォーマットのために渡された場合、このタイムゾーンは
getTimeZoneOverridesCalendar() の結果に応じて使用されます。
public boolean getTimeZoneOverridesCalendar()
カレンダーのタイムゾーンがフォーマッターに上書きされる場合、
true を返します。
true
public Locale getLocale()
このフォーマッターで使用されるロケールを取得します。
public int getMaxLengthEstimate()
このフォーマッターが生成する文字列の最大長の見積もりを返します。
実際のフォーマットされた文字の長さはほとんどの場合、この長さ以下です。
public boolean equals(Object obj)
2つのオブジェクトが等しいかどうか比較します。
obj - 比較対照となるオブジェクト
true
public int hashCode()
適切なハッシュコードです。
public String toString()
このフォーマッターを説明するデバッグのための文字列
|
|||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||