クラスDate
- すべての実装されたインタフェース:
Serializable,Cloneable,Comparable<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に同期していますが、うるう秒の調整はされません。 興味深いソースは、米国海軍天文台(USNO)です:
https://www.usno.navy.mil/USNO
"時間のシステ "に関する資料は:
https://www.usno.navy.mil/USNO/time/master-clock/systems-of-time
UT、UT1、UTCなど、さまざまな時間システ の説明があります。
年、月、日、時間、分、秒の値を受け取るか返すクラスDateのすべてのメソッドにおいて、次の表示が使用されます。
- 年yは整数y
- 1900によって表されます。 - 月は0 - 11の整数で表されます。0は1月、1は2月、そして11は12月を意味します。
- 日(月の何日目)は通常どおり1 - 31の整数で表されます。
- 時間は0 - 23の整数で表されます。 このため、深夜零時から午前1時までの時間は時刻0であり、正午から午後1時までの時間は時刻12を意味します。
- 分は通常どおり0 - 59の整数で表されます。
- 秒は0 - 61の整数で表されます。値60および61は、うるう秒のために け、そして実際にうるう秒を正確に追跡するJavaの実装 けで発生します。 現在使われているうるう秒の算出法では、2回のうるう秒が同じ分に発生することはきわめてまれですが、この仕様はISO Cによる日付および時刻の規約に従います。
すべての 合において、この目的でメソッドに与えられた引数は指定された範囲に入る必要はありません。たとえば、日付を1月32日として指定した 合は、2月1日と解釈されます。
- 導入されたバージョン:
- 1.0
- 関連 目:
-
コンストラクタのサマリー
コンストラクタコンストラクタ説明Date()Dateオブジェクトを割り当て、初期化します。これによって、このオブジェクトは、割り当てられたときの時刻を、もっとも近いミリ秒単位で表します。Date(int year, int month, int date) 非推奨。Date(int year, int month, int date, int hrs, int min) 非推奨。JDKバージョン1.1で、Calendar.set(year + 1900, month, date, hrs, min)またはGregorianCalendar(year + 1900, month, date, hrs, min)に置き換えられています。Date(int year, int month, int date, int hrs, int min, int sec) 非推奨。JDKバージョン1.1で、Calendar.set(year + 1900, month, date, hrs, min, sec)またはGregorianCalendar(year + 1900, month, date, hrs, min, sec)に置き換えられています。Date(long date) Dateオブジェクトを割り当て、初期化します。これによって、このオブジェクトは、「元期」(すなわち1970年1月1日00:00:00 GMT)である標準時からの指定されたミリ秒数を表します。非推奨。JDK version 1.1以降は、DateFormat.parse(String s)に置き換えられています。 -
メソッドのサマリー
修飾子と型メソッド説明booleanこの日付が、指定された日付より後にあるかどうかを判定します。booleanこの日付が、指定された日付より前にあるかどうかを判定します。clone()このオブジェクトのコピーを返します。int序付けのために2つのDateを比較します。boolean2つの日付が等しいかどうかを比較します。static DateInstantオブジェクトからDateのインスタンスを取得します。intgetDate()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.DAY_OF_MONTH)に置き換えられています。intgetDay()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.DAY_OF_WEEK)に置き換えられています。intgetHours()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.HOUR_OF_DAY)に置き換えられています。int非推奨。JDKバージョン1.1で、Calendar.get(Calendar.MINUTE)に置き換えられています。intgetMonth()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.MONTH)に置き換えられています。int非推奨。JDKバージョン1.1で、Calendar.get(Calendar.SECOND)に置き換えられています。longgetTime()このDateオブジェクトで表される、1970年1月1日00:00:00 GMTからのミリ秒数を返します。int非推奨。JDKバージョン1.1で、-(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000)に置き換えられています。intgetYear()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.YEAR) - 1900に置き換えられています。inthashCode()このオブジェクトに対するハッシュ・コード値を返します。static long非推奨。JDK version 1.1以降は、DateFormat.parse(String s)に置き換えられています。voidsetDate(int date) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.DAY_OF_MONTH, int date)に置き換えられています。voidsetHours(int hours) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.HOUR_OF_DAY, int hours)に置き換えられています。voidsetMinutes(int minutes) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.MINUTE, int minutes)に置き換えられています。voidsetMonth(int month) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.MONTH, int month)に置き換えられています。voidsetSeconds(int seconds) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.SECOND, int seconds)に置き換えられています。voidsetTime(long time) このDateオブジェクトを、1970年1月1日00:00:00 GMTからtimeミリ秒の時点を表すように設定します。voidsetYear(int year) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.YEAR, year + 1900)に置き換えられています。非推奨。JDKバージョン1.1で、GMTTimeZoneを使用してDateFormat.format(Date date)に置き換えられています。このDateオブジェクトをInstantに変換します。非推奨。JDKバージョン1.1で、DateFormat.format(Date date)に置き換えられています。toString()Dateオブジェクトを次の形式のStringに変換します。static longUTC(int year, int month, int date, int hrs, int min, int sec) 非推奨。JDKバージョン1.1で、UTCTimeZone、Calendar.getTime().getTime()を使用して、Calendar.set(year + 1900, month, date, hrs, min, sec)またはGregorianCalendar(year + 1900, month, date, hrs, min, sec)に置き換えられました。
-
コンストラクタの詳細
-
Date
public Date()Dateオブジェクトを割り当て、初期化します。これによって、このオブジェクトは、割り当てられたときの時刻を、もっとも近いミリ秒単位で表します。- 関連 目:
-
Date
public Date(long date) Dateオブジェクトを割り当て、初期化します。これによって、このオブジェクトは、「元期」(すなわち1970年1月1日00:00:00 GMT)である標準時からの指定されたミリ秒数を表します。- パラメータ:
date- 1970年1月1日00:00:00 GMTからのミリ秒数。- 関連 目:
-
Date
@Deprecated public Date(int year, int month, int date) 非推奨。JDKバージョン1.1で、Calendar.set(year + 1900, month, date)またはGregorianCalendar(year + 1900, month, date)に置き換えられています。Dateオブジェクトを割り当て、初期化します。これによって、このオブジェクトは、ローカル時間の深夜零時を表します。これは、year、month、date引数で指定された日の始めです。- パラメータ:
year- 年から1900を引いたもの。month- 0 - 11の月。date- 1 - 31の月の日。- 関連 目:
-
Date
@Deprecated public Date(int year, int month, int date, int hrs, int min) 非推奨。JDKバージョン1.1で、Calendar.set(year + 1900, month, date, hrs, min)またはGregorianCalendar(year + 1900, month, date, hrs, min)に置き換えられています。Dateオブジェクトを割り当て、それを初期化します。これによって、オブジェクトはyear、month、date、hrs、およびmin引数で指定された分の開始時点のインスタントをローカル・タイ ゾーンで表します。- パラメータ:
year- 年から1900を引いたもの。month- 0 - 11の月。date- 1 - 31の月の日。hrs- 0 - 23の時。min- 0 - 59の分。- 関連 目:
-
Date
@Deprecated public Date(int year, int month, int date, int hrs, int min, int sec) 非推奨。JDKバージョン1.1で、Calendar.set(year + 1900, month, date, hrs, min, sec)またはGregorianCalendar(year + 1900, month, date, hrs, min, sec)に置き換えられています。Dateオブジェクトを割り当て、それを初期化します。これによって、オブジェクトはyear、month、date、hrs、min、およびsec引数で指定された秒の開始時点のインスタントをローカル・タイ ゾーンで表します。- パラメータ:
year- 年から1900を引いたもの。month- 0 - 11の月。date- 1 - 31の月の日。hrs- 0 - 23の時。min- 0 - 59の分。sec- 0 - 59の秒。- 関連 目:
-
Date
@Deprecated public Date(String s) 非推奨。JDK version 1.1以降は、DateFormat.parse(String s)に置き換えられています。Dateオブジェクトを割り当て、初期化します。これによって、このオブジェクトは、文字列sに指定された日付と時刻に初期化されます。これは、parse(java.lang.String)メソッドで解釈されるのと同じように解釈されます。- パラメータ:
s- 日付の文字列表現。- スロー:
IllegalArgumentException-sを日時表現として解釈できない 合。- 関連 目:
-
-
メソッドの詳細
-
clone
-
UTC
@Deprecated public static long UTC(int year, int month, int date, int hrs, int min, int sec) 非推奨。JDKバージョン1.1で、UTCTimeZone、Calendar.getTime().getTime()を使用して、Calendar.set(year + 1900, month, date, hrs, min, sec)またはGregorianCalendar(year + 1900, month, date, hrs, min, sec)に置き換えられました。引数に基づいて日付と時刻を判定します。 引数は、年、月、月の日、日の時間、時間内の分、および分内の秒として解釈されます。これは、引数がローカル・タイ ゾーンではなくUTCに対して相対的に解釈される点を除き、6つの引数を持つDateコンストラクタの 合とまったく同じです。 返された時間は、元期(1970年1月1日00:00:00 GMT)からのミリ秒で測定された時間間隔として表されます。- パラメータ:
year- 年から1900を引いたもの。month- 0 - 11の月。date- 1 - 31の月の日。hrs- 0 - 23の時。min- 0 - 59の分。sec- 0 - 59の秒。- 戻り値:
- 引数で指定された日付と時刻の1970年1月1日00:00:00 GMTからのミリ秒数。
- 関連 目:
-
parse
@Deprecated public static long parse(String s) 非推奨。JDK version 1.1以降は、DateFormat.parse(String s)に置き換えられています。文字列sを日付と時間の表現として解釈しようとします。 この試みが成功すると、示された時間は、ミリ秒数で測定された元期(1970年1月1日00:00:00 GMT)からの時間間隔として返され表されます。 試行が失敗すると、IllegalArgumentExceptionがスローされます。多くの構文が可能です。IETF標準日付構文Sat, 12 Aug 1995 13:30:00 GMTが認識されます。 さらに、米国大陸のタイ ゾーン省略形も認識されますが、一般的な使用では、タイ ゾーン・オフセット「Sat, 12 Aug 1995 13:30:00 GMT+0430」(グリニッジ子午線の西、4時間30分)を使用するようにしてく さい。 タイ ゾーンを指定しないと、ローカル・タイ ゾーンが使用されます。 GMTとUTCは同等とみなされます。
文字列
sは左から右に処理され、目的のデータが検索されます。 ASCIIカッコ文字(および)内にあるsのマテリアルは無視されます。 カッコは入れ子にできます。 それ以外の 合、s内で許可される文字は、次のASCII文字のみです:
および空白文字。abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789,+-:/
10進数の連続は10進数として処理されます。
- 数値の前に
+または-が付けられ、年がすでに認識されている 合、その数値はタイ ゾーン・オフセットです。 数値が24より小さい 合、それは時間で測定されるオフセットです。 そうでない 合は、数値は区読文字のない24時間形式で表された分のオフセットです。 先行する-は、西方向オフセットを意味します。 タイ ゾーン・オフセットは、常にUTC (グリニッジ)を基準とします。 したがって、たとえば、文字列内で-5が発生すると、"グリニッジから5時間西"を意味し、+0430は"グリニッジから4時間30分東"を意味します。 文字列にGMT、UTまたはUTCを冗長で指定できます(例:GMT-5またはutc+0430)。 - 以下の条件の1つがtrueの 合、数値は年とみなされます。
- 数値は70以上で、そのあとに空白、カンマ、スラッシュ、または終了文字列が続く
- 数値は70未満で、月と月の日付の両方が認識されている
SimpleDateFormatで使用される100より少ない年の解釈とは少し異なります。 - 数値の後にコロンが続く 合、その数値は時間とみなされます。た し、時間がすでに認識されている 合は、数値は分とみなされます。
- 数値の後にスラッシュが続く 合、1か月がすでに認識されていないかぎり、(
0から11の範囲の数値を生成するには、1ずつ減らします)月とみなされます。その 合は、その月の日付とみなされます。 - 数値の後に空白、カンマ、ハイフン、または終了文字列が続く 合、そして時間がすでに認識されていて、分がま 認識されていない 合、その数値は分とみなされます。分がすでに認識されていて、秒がま 認識されてない 合、数値は秒とみなされます。それ以外の 合、数値は日とみなされます。
文字の連続は単語とみなされ、以下のように処理されます。
- 大文字と小文字を無視して
AMに一致する単語は、(た し、時間が認識されていないか、1より小さいか、12より大きい 合、解析は失敗)を無視します。 - 大文字と小文字を無視して
PMに一致する単語は、12を時間(た し、時間が認識されていないか、1より小さいか、12より大きい 合、解析は失敗)に追 します。 SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY、またはSATURDAYのいずれかのプレフィクスに一致するワードは、大文字と小文字を無視して無視されます。 たとえば、sat, Friday, TUEおよびThursは無視されます。- それ以外の 合は、
JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER、またはDECEMBERのいずれかのプレフィクスに一致し、大文字小文字を無視して、ここで指定した 序でそれらを考慮するワードは、月の指定として認識され、数値 (0から11)に変換されます。 たとえば、aug, Sept, aprilおよびNOVは月として認識されます。Maも同様で、MAYではなくMARCHとして認識されるMaです。 GMT, UTまたはUTCに一致する単語は、大文字と小文字を無視してUTCを参照するものとして扱われます。EST, CST, MST、またはPSTに一致する単語は、大文字と小文字を無視して、それぞれグリニッジの5時間、6時間、7時間、または8時間西の北米のタイ ゾーンを参照すると認識されます。 夏時間中に、EDT, CDT, MDT、またはPDTと一致する語は、大文字と小文字を無視して、それぞれ同じタイ ゾーンを参照すると認識されます。
文字列sの全体が走査されると、それは2つの方法のどちらかで時間に変換されます。 タイ ゾーンまたはタイ ゾーン・オフセットが認識されている 合、年、月、日、時、分、および秒はUTCで解釈され、タイ ゾーン・オフセットが適用されます。 そうでない 合、年、月、日、時、分、および秒はローカル・タイ ゾーンで解釈されます。
- パラメータ:
s- 日付として解析される文字列。- 戻り値:
- 文字列引数で表された1970年1月1日00:00:00 GMTからのミリ秒数。
- スロー:
IllegalArgumentException-sを日時表現として解釈できない 合。- 関連 目:
- 数値の前に
-
getYear
@Deprecated public int getYear()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.YEAR) - 1900に置き換えられています。Dateオブジェクトで表されるインスタントを含むかまたはそのインスタントで始まる年から1900を引いた結果の値を、ローカル・タイ ゾーンで解釈して返します。- 戻り値:
- 1900を引いた、この日付が表す年
- 関連 目:
-
setYear
@Deprecated public void setYear(int year) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.YEAR, year + 1900)に置き換えられています。このDateオブジェクトの年を指定した値に1900を えた値に設定します。 このDateオブジェクトは、指定された年のある時点を、以前と同じように月、日、時、分、および秒を使用してローカル・タイ ゾーンで表すように変更されます。 たとえば日付が2月29日 った 合、年はうるう年ではないと設定され、新しい日付は3月1日として処理されます。- パラメータ:
year- 年の値。- 関連 目:
-
getMonth
@Deprecated public int getMonth()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.MONTH)に置き換えられています。このDateオブジェクトで表されるインスタント・イン・タイ を含む月または開始する月を表す数値を返します。 返される値は0と11の間であり、値0は1月を表します。- 戻り値:
- この日付が表す月
- 関連 目:
-
setMonth
@Deprecated public void setMonth(int month) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.MONTH, int month)に置き換えられています。この日付の月を、指定された値に設定します。 このDateオブジェクトは、ローカル・タイ ゾーンで解釈される年、日付、時間、分および秒を前と同じにして、指定した月内の時点を表すように変更されます。 たとえば日付が10月31日の 合、そして月が6月に設定されている 合、新しい日付は7月1日として処理されます。6月は30日しかないからです。- パラメータ:
month- 0 - 11の月の値。- 関連 目:
-
getDate
@Deprecated public int getDate()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.DAY_OF_MONTH)に置き換えられています。このDateオブジェクトで表される月の日を返します。 返される値は、ローカル・タイ ・ゾーンで解釈される、このDateオブジェクトによって表されるインスタント・イン・タイ を含む、または開始する月の日を表す1と31の間です。- 戻り値:
- この日付で表される月の日
- 関連 目:
-
setDate
@Deprecated public void setDate(int date) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.DAY_OF_MONTH, int date)に置き換えられています。このDateオブジェクトの日付を指定された値に設定します。 このDateオブジェクトは、ローカル・タイ ・ゾーンで解釈される年、月、時間、分および秒を前と同じにして、月の指定日内の時点を表すように変更されます。 たとえば日付が4月30日の 合に、日付が31に設定されると、4月は30日しかないので、それは5月1日として処理されます。- パラメータ:
date- 1 - 31の月の日の値。- 関連 目:
-
getDay
@Deprecated public int getDay()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.DAY_OF_WEEK)に置き換えられています。この日付で表される週の日を返します。 戻り値(0=日曜日、1=月曜日、2=火曜日、3=水曜日、4=木曜日、5=金曜日、6=土曜日)は、ローカル・タイ ・ゾーンで解釈される、このDateオブジェクトによって表されるインスタント・イン・タイ を含む曜日または開始する曜日を表します。- 戻り値:
- この日付で表される曜日
- 関連 目:
-
getHours
@Deprecated public int getHours()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.HOUR_OF_DAY)に置き換えられています。このDateオブジェクトで表される時間を返します。 戻り値は、ローカル・タイ ・ゾーンで解釈される、このDateオブジェクトによって表されるインスタント・イン・タイ を含む、またはそれで始まる1日の時間を表す数値(0から23)です。- 戻り値:
- この日付が表す時
- 関連 目:
-
setHours
@Deprecated public void setHours(int hours) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.HOUR_OF_DAY, int hours)に置き換えられています。このDateオブジェクトの時間を指定された値に設定します。 このDateオブジェクトは、ローカル・タイ ゾーンで解釈される年、月、日付、分および秒を前と同じにして、1日の指定した時間内の時点を表すように変更されます。- パラメータ:
hours- 時間の値。- 関連 目:
-
getMinutes
@Deprecated public int getMinutes()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.MINUTE)に置き換えられています。この日付で表される時を過ぎた分数を、ローカル・タイ ゾーンで返します。 返される値は、0-59です。- 戻り値:
- この日付で表される時を過ぎた分数
- 関連 目:
-
setMinutes
@Deprecated public void setMinutes(int minutes) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.MINUTE, int minutes)に置き換えられています。このDateオブジェクトの分を指定された値に設定します。 このDateオブジェクトは、ローカル・タイ ・ゾーンで解釈される年、月、日付、時間および秒を前と同じにして、指定された時間内の時点を表すように変更されます。- パラメータ:
minutes- 分の値。- 関連 目:
-
getSeconds
@Deprecated public int getSeconds()非推奨。JDKバージョン1.1で、Calendar.get(Calendar.SECOND)に置き換えられています。この日付で表される、分を過ぎた秒数を返します。 返される値は、0-61です。 値60および61は、うるう年を考慮するJava仮想マシン けで発生します。- 戻り値:
- この日付で表される、分を過ぎた秒数
- 関連 目:
-
setSeconds
@Deprecated public void setSeconds(int seconds) 非推奨。JDKバージョン1.1で、Calendar.set(Calendar.SECOND, int seconds)に置き換えられています。このDateの秒を指定された値に設定します。 このDateオブジェクトは、ローカル・タイ ・ゾーンで解釈される年、月、日付、時間および分を前と同じにして、指定した分内の時点を表すように変更されます。- パラメータ:
seconds- 秒の値。- 関連 目:
-
getTime
public long getTime()このDateオブジェクトで表される、1970年1月1日00:00:00 GMTからのミリ秒数を返します。- 戻り値:
- この日付で表される、1970年1月1日00:00:00 GMTからのミリ秒数。
-
setTime
public void setTime(long time) このDateオブジェクトを、1970年1月1日00:00:00 GMTからtimeミリ秒の時点を表すように設定します。- パラメータ:
time- ミリ秒数。
-
before
public boolean before(Date when) この日付が、指定された日付より前にあるかどうかを判定します。- パラメータ:
when- 日付。- 戻り値:
trueは、このDateオブジェクトによって表される時間のインスタントがwhenによって表されるインスタントよりも厳密に早い 合にのみ、falseです。- スロー:
NullPointerException-whenがnullの 合。
-
after
public boolean after(Date when) この日付が、指定された日付より後にあるかどうかを判定します。- パラメータ:
when- 日付。- 戻り値:
trueは、このDateオブジェクトによって表されるインスタントが、whenによって表されるインスタントよりも厳密に遅くなっている 合にのみ、false。それ以外の 合はfalse。- スロー:
NullPointerException-whenがnullの 合。
-
equals
-
compareTo
public int compareTo(Date anotherDate) 序付けのために2つのDateを比較します。- 定義:
compareTo、インタフェースComparable<Date>- パラメータ:
anotherDate- 比較対象のDate。- 戻り値:
- 引数DateがこのDateと等しい 合は値
0。このDateが引数Dateより前の 合は0より小さい値。このDateが引数Dateより後の 合は0より大きい値。 - スロー:
NullPointerException-anotherDateがnullの 合。- 導入されたバージョン:
- 1.2
-
hashCode
-
toString
public String toString()Dateオブジェクトを次の形式のStringに変換します。
説明:dow mon dd hh:mm:ss zzz yyyy
dowは、週の曜日 (Sun, Mon, Tue, Wed, Thu, Fri, Sat)です。monは、月 (Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec)です。ddは、10進数2桁の月の日付 (01から31)です。hhは、10進数2桁の日の時間 (00から23)です。mmは、10進数2桁の時間の分 (00から59)です。ssは、10進数2桁の分(00から61)内の秒です。zzzは、タイ ・ゾーン(夏時間を反 )です。 標準タイ ・ゾーンの略語には、メソッドparseで認識されるものが含まれます。 タイ ・ゾーン情 が使用できない 合、zzzは空です - つまり、文字はまったく構成されていません。yyyyは、小数点以下4桁の年です。
-
toLocaleString
@Deprecated public String toLocaleString()非推奨。JDKバージョン1.1で、DateFormat.format(Date date)に置き換えられています。実装に依存する形式で、このDateオブジェクトの文字列表現を作成します。 これは、Javaアプリケーションがどこで稼働するにしても、そのユーザーにとってこの形式がなじみのあるもの からです。 この目的は、ISO Cのstrftime()機能によってサポートされる「%c」フォーマットの 合と同様です。- 戻り値:
- ロケール規則を使ったこの日付の文字列表現。
- 関連 目:
-
toGMTString
@Deprecated public String toGMTString()非推奨。JDKバージョン1.1で、GMTTimeZoneを使用してDateFormat.format(Date date)に置き換えられています。フォー のこのDateオブジェクトの文字列表現を作成します:
説明:d mon yyyy hh:mm:ss GMT
- dは、10進数1桁または2桁の月の日付 (
1から31)です。 - monは、月 (
Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec)です。 - yyyyは、10進数4桁の年です。
- hhは、10進数2桁の日の時間 (
00から23)です。 - mmは、10進数2桁の時間の分 (
00から59)です。 - ssは、10進数2桁の分の秒 (
00から61)です。 - GMT 、グリニッジ標準時を示すASCII文字"
GMT"です。
結果はローカル・タイ ゾーンに依存しません。
- 戻り値:
- インターネットのGMT規則を使った、この日付の文字列表現。
- 関連 目:
- dは、10進数1桁または2桁の月の日付 (
-
getTimezoneOffset
@Deprecated public int getTimezoneOffset()非推奨。JDKバージョン1.1で、-(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000)に置き換えられています。Dateオブジェクトで表される時間に適切な、UTCを基準にしたローカル・タイ ゾーンのオフセットを分で返します。たとえば、Massachusettsでの、グリニッジの西5時間ゾーン:
1996年2月14日のため、標準時(東部標準時)が使用されています。オフセットは、UTCから5時間です。new Date(96, 1, 14).getTimezoneOffset() returns 300
1996年6月1日のため、夏時間(東部夏時間)が使用されています。オフセットは、UTCから4時間 けです。new Date(96, 5, 1).getTimezoneOffset() returns 240
このメソッドは計算したかのように同じ結果を生成します。
(this.getTime() - UTC(this.getYear(), this.getMonth(), this.getDate(), this.getHours(), this.getMinutes(), this.getSeconds())) / (60 * 1000)- 戻り値:
- 現在のタイ ゾーンに対する分で表されたタイ ゾーン・オフセット。
- 関連 目:
-
from
InstantオブジェクトからDateのインスタンスを取得します。Instantはナノ秒の精度を使用するのに対し、Dateはミリ秒の精度を使用します。 この変換では、ナノ秒単位の金額が100万単位の整数除算の対象であるかのように、余分な精度情 が切り捨てられます。Instantには、Dateより い未来または過去にある時系列上の時点を 納できます。 このシナリオでは、このメソッドは例外をスローします。- パラメータ:
instant- 変換するインスタント- 戻り値:
- 指定されたインスタントと同じ時系列上のインスタントを表す
Date - スロー:
NullPointerException-instantがnullの 合。IllegalArgumentException- そのインスタントがDateとして表すには大きすぎる 合- 導入されたバージョン:
- 1.8
-
toInstant
public Instant toInstant()このDateオブジェクトをInstantに変換します。この変換では、時系列上でこの
Dateと同じ時点を表すInstantを作成します。- 戻り値:
- この
Dateオブジェクトと同じ時系列上の時点を表すインスタント - 導入されたバージョン:
- 1.8
-
Calendar.set(year + 1900, month, date)またはGregorianCalendar(year + 1900, month, date)に置き換えられています。