|
CDC 1.1.2 | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.util.Date
public class Date
クラス Date
は、特定の時点を表すもので、その精度はミリ秒です。
JDK 1.1 より前の Date
クラスには、2 つの追加機能がありました。まず、日付を年、月、日、時、分、秒の値として解釈することができました。さらに、日付文字列のフォーマットを構文解析することができました。しかし、これらの機能の API は国際化の対象にはなりませんでした。JDK 1.1 からは、日付と時間フィールドの間の変換には Calendar
クラスを、日付文字列のフォーマットと構文解析には DateFormat
クラスをそれぞれ使用する必要があります。Date
の対応するメソッドは推奨されません。
Date
クラスは、UTC (Universal Coordinate Time) を反映することを意図していますが、Java 仮想マシンのホスト環境によってはこれを正確に行えない可能性があります。ほとんどすべての最近のオペレーティングシステムは、あらゆる場合において 1 日 = 24 × 60 × 60 = 86400 秒と仮定しています。しかし、UTC においては毎年約 1 回か 2 回「うるう秒」と呼ばれる余分な秒が発生します。うるう秒は常にその日の最後の秒として追加され、それは常に 12 月 31 日かまたは 6 月 30 日です。たとえば、1995 年の最後の分は、うるう秒の追加により長さが 61 秒でした。ほとんどのコンピュータのクロックは、うるう秒の違いを反映できるほど正確ではありません。
コンピュータ標準のいくつかは、GMT (Greenwich Mean Time、グリニッジ標準時) によって定義されています。これは UT (Universal Time) と同等です。GMT はこの標準の「一般的な」名前です。UT は、この標準の「科学的な」名前です。UTC と UT の違いは、UTC が原子時計に基づくのに対して、UT は天文学的な観測に基づくことです。これは実用的な目的からするとほとんど違いはありません。地球の自転は一定ではないので (地球は複雑に遅くなったり速くなったりする)、UT は常に一定に流れるわけではありません。うるう秒は、UTC を UT1 の 0.9 秒以内に維持する必要があって UTC に導入されました。この UT1 は UT のバージョンである訂正が施されています。同様にほかにも時間と日付のシステムがあります。たとえば、衛星ベースの GPS (Global Positioning System、地球位置確認システム) は UTC に同期していますが、うるう秒の調整はされません。詳細情報のソースには U.S. Naval Observatory (米国海軍天文台) があり、特に次の「Directorate of Time」、
http://tycho.usno.navy.mil
および次の「Systems of Time」の定義を参照してください。
http://tycho.usno.navy.mil/systime.html
年、月、日、時間、分、秒の値を受け取るか返すクラス Date のすべてのメソッドにおいて、次の表示が使用されます。
- 1900
によって表される
すべての場合において、この目的でメソッドに与えられた引数は指定された範囲に入る必要はありません。たとえば、日付を 1 月 32 日として指定した場合は、2 月 1 日と解釈されます。
DateFormat
,
Calendar
,
TimeZone
,
直列化された形式コンストラクタの概要 | |
---|---|
Date()
Date オブジェクトを割り当て、初期化します。 |
|
Date(long date)
Date オブジェクトを割り当て、初期化します。 |
メソッドの概要 | |
---|---|
boolean |
after(Date when)
この日付が、指定された日付より後にあるかどうかを判定します。 |
boolean |
before(Date when)
この日付が、指定された日付より前にあるかどうかを判定します。 |
Object |
clone()
このオブジェクトのコピーを返します。 |
int |
compareTo(Date anotherDate)
順序付けのために 2 つの Date を比較します。 |
int |
compareTo(Object o)
この Date と別の Object を比較します。 |
boolean |
equals(Object obj)
2 つの日付が等しいかどうかを比較します。 |
long |
getTime()
Date オブジェクトで表される、1970 年 1 月 1 日 00:00:00 GMT からのミリ秒数を返します。 |
int |
hashCode()
このオブジェクトに対するハッシュコード値を返します。 |
void |
setTime(long time)
Date オブジェクトを、1970 年 1 月 1 日 00:00:00 GMT から time ミリ秒の時点を表すように設定します。 |
String |
toString()
Date オブジェクトを次の形式の String に変換します。 |
クラス java.lang.Object から継承されたメソッド |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
---|
public Date()
System.currentTimeMillis()
public Date(long date)
Date
オブジェクトを割り当て、初期化します。これによって、このオブジェクトは、「エポック」(すなわち、1970 年 1 月 1 日 00:00:00 GMT) である標準時からの指定されたミリ秒数を表します。
date
- 1970 年 1 月 1 日 00:00:00 GMT からのミリ秒数System.currentTimeMillis()
メソッドの詳細 |
---|
public Object clone()
Object
内の clone
Cloneable
public long getTime()
public void setTime(long time)
time
- ミリ秒数public boolean before(Date when)
when
- 日付
true
、そうでない場合は false
public boolean after(Date when)
when
- 日付
true
、そうでない場合は false
public boolean equals(Object obj)
null
ではなく、かつ、このオブジェクトとミリ秒まで同じ時点を表す Date
オブジェクトであれば、true
を返します。
したがって、2 つの Date
オブジェクトは、getTime
メソッドが両方に対して同じ long
を返す場合だけ等しいものとみなされます。
Object
内の equals
obj
- 比較対象のオブジェクト
true
、そうでない場合は false
getTime()
public int compareTo(Date anotherDate)
anotherDate
- 比較対象の Date
0
。この Date が引数 Date より前の場合は 0
より小さい値。この Date が引数 Date より後の場合は 0
より大きい値public int compareTo(Object o)
compareTo(Date)
と同じように動作します。そうでない場合、ClassCastException
がスローされます。これは、Date の比較は Date 同士でしか行えないためです。
Comparable
内の compareTo
o
- 比較対象の Object
0
。引数がこの Date より後の Date の場合は 0
より小さい値。引数がこの Date の前の Date の場合は 0
より大きい値
ClassCastException
- 引数が Date
ではない場合Comparable
public int hashCode()
getTime()
メソッドによって返されるプリミティブ long 値の上位半分と下位半分の排他的論理和です。すなわち、ハッシュコードは次の式の値です。
(int)(this.getTime()^(this.getTime() >>> 32))
Object
内の hashCode
Object.equals(java.lang.Object)
,
Hashtable
public String toString()
Date
オブジェクトを次の形式の String
に変換します。
次にそれぞれの意味を示します。dow mon dd hh:mm:ss zzz yyyy
Object
内の toString
|
CDC 1.1.2 | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |