jp.sf.orangesignal.ta.util
クラス DateFormatUtils

java.lang.Object
  上位を拡張 jp.sf.orangesignal.ta.util.DateFormatUtils

public abstract class DateFormatUtils
extends Object

日付/時刻のフォーマットと解析をロケールを考慮して行うユーティリティを提供します。

このクラスは、SimpleDateFormat の使用を簡素化する為のユーティリティ機能を提供します。

導入されたバージョン:
2.1
作成者:
杉澤 浩二

コンストラクタの概要
DateFormatUtils()
           
 
メソッドの概要
static String format(Date date, String pattern)
          指定された日時をフォーマットして文字列を作成します。
static String format(Date date, String pattern, Locale locale)
          指定された日時をフォーマットして文字列を作成します。
static String format(Date date, String pattern, Locale locale, TimeZone zone)
          指定された日時をフォーマットして文字列を作成します。
static Date parse(String source, String[] patterns)
          指定された複数の日付/時刻書式文字列を順番に使用して、指定された日付/時刻文字列を解析します。
static Date parse(String source, String[] patterns, Locale locale)
          指定された複数の日付/時刻書式文字列を順番に使用して、指定された日付/時刻文字列を解析します。
static Date parse(String source, String[] patterns, Locale locale, TimeZone zone)
          指定された複数の日付/時刻書式文字列を順番に使用して、指定された日付/時刻文字列を解析します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

DateFormatUtils

public DateFormatUtils()
メソッドの詳細

parse

public static Date parse(String source,
                         String[] patterns)
                  throws ParseException

指定された複数の日付/時刻書式文字列を順番に使用して、指定された日付/時刻文字列を解析します。

パラメータ:
source - 解析する日付/時刻文字列
patterns - 日付/時刻書式文字列群
戻り値:
解析された日付/時刻
例外:
IllegalArgumentException - 日付/時刻文字列または日付/時刻書式文字列群に不正な値が指定された場合
ParseException - 指定された日付/時刻文字列が解析できない場合
関連項目:
parse(String, String[], Locale, TimeZone)

parse

public static Date parse(String source,
                         String[] patterns,
                         Locale locale)
                  throws ParseException

指定された複数の日付/時刻書式文字列を順番に使用して、指定された日付/時刻文字列を解析します。

パラメータ:
source - 解析する日付/時刻文字列
patterns - 日付/時刻書式文字列群
locale - 解析で使用する地域情報
戻り値:
解析された日付/時刻
例外:
IllegalArgumentException - 日付/時刻文字列または日付/時刻書式文字列群に不正な値が指定された場合
ParseException - 指定された日付/時刻文字列が解析できない場合
関連項目:
parse(String, String[], Locale, TimeZone)

parse

public static Date parse(String source,
                         String[] patterns,
                         Locale locale,
                         TimeZone zone)
                  throws ParseException

指定された複数の日付/時刻書式文字列を順番に使用して、指定された日付/時刻文字列を解析します。

このメソッドでは Java 仮想マシンの言語や地域などのホスト環境に依存せずに、日付/時刻の解析を行うことが可能です。

 以下は Java 仮想マシンの言語や地域などのホスト環境に依存せずに、日本の日付/時刻形式で表現されているロシアのモスクワ時間を解析する場合の例です。
Date date = DateFormatUtils.parse("2009/07/27 23:38:02.123", new String[]{ "yyyy/MM/dd HH:mm:ss.SSS" }, Locale.JAPAN, TimeZone.getTimeZone("Russia/Moscow"));

パラメータ:
source - 解析する日付/時刻文字列
patterns - 日付/時刻書式文字列群
locale - 解析で使用する地域情報
zone - 解析で使用するタイムゾーン
戻り値:
解析された日付/時刻
例外:
IllegalArgumentException - 日付/時刻文字列または日付/時刻書式文字列群に不正な値が指定された場合
ParseException - 指定された日付/時刻文字列が解析できない場合

format

public static String format(Date date,
                            String pattern)

指定された日時をフォーマットして文字列を作成します。

パラメータ:
date - フォーマットする日時
pattern - 日付/時刻書式文字列
戻り値:
フォーマットされた日時文字列
例外:
IllegalArgumentException - 日時または日付/時刻書式文字列に null が指定された場合。 または日付/時刻書式文字列に指定されたパターンが正しくない場合。 または指定された日時をフォーマットできない場合。
関連項目:
format(Date, String, Locale, TimeZone)

format

public static String format(Date date,
                            String pattern,
                            Locale locale)

指定された日時をフォーマットして文字列を作成します。

パラメータ:
date - フォーマットする日時
pattern - 日付/時刻書式文字列
locale - フォーマットで使用する地域情報
戻り値:
フォーマットされた日時文字列
例外:
IllegalArgumentException - 日時または日付/時刻書式文字列に null が指定された場合。 または日付/時刻書式文字列に指定されたパターンが正しくない場合。 または指定された日時をフォーマットできない場合。
関連項目:
format(Date, String, Locale, TimeZone)

format

public static String format(Date date,
                            String pattern,
                            Locale locale,
                            TimeZone zone)

指定された日時をフォーマットして文字列を作成します。

このメソッドでは Java 仮想マシンの言語や地域などのホスト環境に依存せずに、日付/時刻のフォーマットを行うことが可能です。

 以下は Java 仮想マシンの言語や地域などのホスト環境に依存せずに、日本の数値形式でアメリカのニューヨーク日時文字列へフォーマットする場合の例です。
String str = DateFormatUtils.format(new Date(), "yyyy/MM/dd HH:mm:ss.SSS", Locale.JAPAN, TimeZone.getTimeZone("America/New_York"));

パラメータ:
date - フォーマットする日時
pattern - 日付/時刻書式文字列
locale - フォーマットで使用する地域情報
zone - タイムゾーン
戻り値:
フォーマットされた日時文字列
例外:
IllegalArgumentException - 日時または日付/時刻書式文字列に null が指定された場合。 または日付/時刻書式文字列に指定されたパターンが正しくない場合。 または指定された日時をフォーマットできない場合。


Copyright © 2006-2009 OrangeSignal.com. All Rights Reserved.