Ruby 1.9.2 リファレンスマニュアル > ライブラリ一覧 > dateライブラリ > Dateクラス

class Date

クラスの継承リスト: Date < Comparable < Object < Kernel < BasicObject

要約

日付だけでなく時刻も扱える Date のサブクラス DateTime も利用できます。

簡単なつかいかた

require 'date'

a = Date.new(1993, 2, 24)
b = Date.parse('1993-02-24')
b += 10

b - a            #=> 10
b.year           #=> 1993
b.strftime('%a') #=> "Sat"

yesterday = Date.today - 1

用語の定義

いくつか用語の定義は、[[ISO:8601]]、および [[JIS:X 0301]] に基づきます。

暦日付

暦日付は、暦年、暦月、および暦月の中の序数によって指定される特定の日の日付です。

つまり、ごく当たり前の年月日による日付です。

年間通算日 (年日付)

年間通算日 (年日付) は、暦年、および暦年の中の序数によって指定される特定の日の日付です。

暦週日付

暦週日付は、暦週と暦年中の序数による日付です。

暦週は、暦年中の序数によって指定される特定の7日の期間であり、月曜から始まります。その年の第1暦週は、最初の木曜日を含む週とします。これは、 1月4日を含む週と同じです。

ユリウス日

ユリウス日は紀元前4713年1月1日 (ユリウス暦) 正午 (グリニッジ平均時) を暦元とした通日 (経過日数) です。

この文書で、天文学的なユリウス日とは、本来のユリウス日と同じものです。また、年代学的なユリウス日とは、地方時における零時を一日の始まりとする流儀です。

この文書で、単に「ユリウス日」といった場合、それは本来のユリウス日でなく、「年代学的なユリウス日」を意味しています。

修正ユリウス日

修正ユリウス日は西暦1858年11月17日 (グレゴリオ暦) 正子/零時 (協定世界時) を暦元とした通日 (経過日数) です。

この文書で、天文学的な修正ユリウス日とは、本来の修正ユリウス日と同じものです。また、年代学的な修正ユリウス日とは、地方時における零時を一日の始まりとする流儀です。

この文書で、単に「修正ユリウス日」といった場合、それは本来の修正ユリウス日でなく、「年代学的な修正ユリウス日」を意味しています。

特異メソッド

定義	説明
`_httpdate(str) -> Hash`	このメソッドは Date.httpdate と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`_iso8601(str) -> Hash`	このメソッドは Date.iso8601 と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`_jisx0301(str) -> Hash`	このメソッドは Date.jisx0301 と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`_parse(str, complete = true) -> Hash`	このメソッドは Date.parse と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`_rfc2822(str) -> Hash _rfc822(str) -> Hash`	このメソッドは Date.rfc2822 と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`_rfc3339(str) -> Hash`	このメソッドは Date.rfc3339 と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`_strptime(str, format = '%F') -> Hash`	このメソッドは Date.strptime と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`_xmlschema(str) -> Hash`	このメソッドは Date.xmlschema と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`civil(year = -4712, mon = 1, mday = 1, start = Date::ITALY) -> Date new(year = -4712, mon = 1, mday = 1, start = Date::ITALY) -> Date`	暦日付に相当する日付オブジェクトを生成します。
`commercial(cwyear = -4712, cweek = 1, cwday = 1, start = Date::ITALY) -> Date`	暦週日付に相当する日付オブジェクトを生成します。
`gregorian_leap?(year) -> bool leap?(year) -> bool`	グレゴリオ暦の閏年なら真を返します。
`httpdate(str = 'Mon, 01 Jan -4712 00:00:00 GMT', start = Date::ITALY) -> Date`	[RFC2616] で定められた書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。
`iso8601(str = '-4712-01-01', start = Date::ITALY) -> Date`	いくつかの代表的な [[ISO:8601]] 書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。
`jd(jd = 0, start = Date::ITALY) -> Date`	ユリウス日に相当する日付オブジェクトを生成します。
`jisx0301(str = '-4712-01-01', start = Date::ITALY) -> Date`	いくつかの代表的な [[JIS:X 0301]] 書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。
`julian_leap?(year) -> bool`	ユリウス暦の閏年なら真を返します。
`ordinal(year = -4712, yday = 1, start = Date::ITALY) -> Date`	年間通算日 (年日付) に相当する日付オブジェクトを生成します。
`parse(str = '-4712-01-01', complete = true, start = Date::ITALY) -> Date`	与えられた日付表現を解析し、その情報に基づいて日付オブジェクトを生成します。
`rfc2822(str = 'Mon, 1 Jan -4712 00:00:00 +0000', start = Date::ITALY) -> Date rfc822(str = 'Mon, 1 Jan -4712 00:00:00 +0000', start = Date::ITALY) -> Date`	[RFC2822] で定められた書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。
`rfc3339(str = '-4712-01-01T00:00:00+00:00', start = Date::ITALY) -> Date`	[RFC3339] 書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。
`strptime(str = '-4712-01-01', format = '%F', start = Date::ITALY) -> Date`	与えられた雛型で日付表現を解析し、その情報に基づいて日付オブジェクトを生成します。
`today(start = Date::ITALY) -> Date`	現在の日付に相当する日付オブジェクトを生成します。
`valid_civil?(year, mon, mday, start = Date::GREGORIAN) -> bool valid_date?(year, mon, mday, start = Date::GREGORIAN) -> bool`	正しい暦日付であれば真、そうでないなら偽を返します。
`valid_commercial?(cwyear, cweek, cwday, start = Date::GREGORIAN) -> bool`	正しい暦週日付であれば真、そうでないなら偽を返します。
`valid_jd?(jd, start = Date::GREGORIAN) -> bool`	真を返します。
`valid_ordinal?(year, yday, start = Date::GREGORIAN) -> bool`	正しい年間通算日 (年日付) であれば真、そうでないなら偽を返します。
`xmlschema(str = '-4712-01-01', start = Date::ITALY) -> Date`	XML Schema による書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。

インスタンスメソッド

定義	説明
`self + n -> Date`	self から n 日後の日付オブジェクトを返します。 n は数値でなければなりません。
`self - x -> Rational \| Date`	x が日付オブジェクトなら、ふたつの差を返します。あるいは x が数値ならば、self より x 日前の日付を返します。
`self << n -> Date`	self より n ヶ月前の日付オブジェクトを返します。 n は数値でなければなりません。
`self <=> other -> Integer`	ふたつを比較し、-1、零、あるいは 1 を返します。 other は日付オブジェクトか、天文学的なユリウス日をあらわす数値でなければなりません。
`self === other -> bool`	同じ日なら真を返します。
`self >> n -> Date`	self から n ヶ月後の日付オブジェクトを返します。 n は数値でなければなりません。
`ajd -> Rational`	このメソッドは Date#jd と似ていますが、天文学的なユリウス日を返します。時刻を含みます。
`amjd -> Rational`	このメソッドは Date#mjd と似ていますが、天文学的な修正ユリウス日を返します。時刻を含みます。
`asctime -> String ctime -> String`	asctime(3) 書式の文字列を返します (ただし、末尾の "\n\0" は除く)。
`cwday -> Integer`	暦週の日 (曜日) を返します (1-7、月曜は1)。
`cweek -> Integer`	暦週を返します (1-53)。
`cwyear -> Integer`	暦週における年を返します。
`mday -> Integer day -> Integer`	月の日を返します (1-31)。
`downto(min) {\|date\| ...} -> self downto(min) -> Enumerator`	このメソッドは、step(min, -1){\|date\| ...} と等価です。
`england -> Date`	このメソッドは、new_start(Date::ENGLAND) と等価です。
`friday? -> bool`	金曜日なら真を返します。
`gregorian -> Date`	このメソッドは、new_start(Date::GREGORIAN) と等価です。
`gregorian? -> bool`	グレゴリオ暦なら真を返します。
`httpdate -> String`	[RFC2616] ([RFC1123]) で定められた書式の文字列を返します。
`iso8601 -> String rfc3339 -> String`	[[ISO:8601]] 書式の文字列を返します (拡大表記はつかいません)。
`italy -> Date`	このメソッドは、new_start(Date::ITALY) と等価です。
`jd -> Integer`	ユリウス日を返します。時刻を含みません。
`jisx0301 -> String`	[[JIS:X 0301]] 書式の文字列を返します。ただし、明治以前については [[ISO:8601]] 書式になります。なお、明治6年以前についても太陰太陽暦を使用することはありません。
`julian -> Date`	このメソッドは、new_start(Date::JULIAN) と等価です。
`julian? -> bool`	ユリウス暦なら真を返します。
`ld -> Integer`	リリウス日を返します。
`leap? -> bool`	閏年なら真を返します。
`mjd -> Integer`	修正ユリウス日を返します。時刻の情報を含みません。
`mon -> Integer month -> Integer`	月を返します (1-12)。
`monday? -> bool`	月曜日なら真を返します。
`new_start(start = Date::ITALY) -> Date`	self を複製して、その改暦日を設定しなおします。引数を省略した場合は、Date::ITALY (1582年10月15日) になります。
`succ -> Date next -> Date`	翌日の日付オブジェクトを返します。
`next_day(n = 1) -> Date`	n 日後を返します。
`next_month(n = 1) -> Date`	n ヶ月後を返します。
`next_year(n = 1) -> Date`	n 年後を返します。
`prev_day(n = 1) -> Date`	n 日前を返します。
`prev_month(n = 1) -> Date`	n ヶ月前を返します。
`prev_year(n = 1) -> Date`	n 年前を返します。
`rfc2822 -> String rfc822 -> String`	[RFC2822] で定められた書式の文字列を返します。
`saturday? -> bool`	土曜日なら真を返します。
`start -> Integer`	改暦日をあらわすユリウス日を返します。
`step(limit, step = 1) {\|date\| ...} -> self step(limit, step = 1) -> Enumerator`	ブロックの評価を繰り返します。ブロックは日付オブジェクトをとります。 limit は日付オブジェクトでなければなりません、また step は非零でなければなりません。
`strftime(format = '%F') -> String`	与えられた雛型で日付を書式づけます。
`sunday? -> bool`	日曜日なら真を返します。
`thursday? -> bool`	木曜日なら真を返します。
`to_date -> Date`	対応する Date オブジェクトを返します。
`to_datetime -> DateTime`	対応する DateTime オブジェクトを返します。
`to_s -> String`	[[ISO:8601]] 書式の文字列を返します (拡大表記はつかいません)。
`to_time -> Time`	対応する Time オブジェクトを返します。
`tuesday? -> bool`	火曜日なら真を返します。
`upto(max) {\|date\| ...} -> self upto(max) -> Enumerator`	このメソッドは、step(max, 1){\|date\| ...} と等価です。
`wday -> Integer`	曜日を返します (0-6、日曜日は零)。
`wednesday? -> bool`	水曜日なら真を返します。
`xmlschema -> String`	XML Scheme (date) による書式の文字列を返します。
`yday -> Integer`	年の日を返します (1-366)。
`year -> Integer`	年を返します。

定数

定義	説明
`ENGLAND`	英国がグレゴリオ暦をつかい始めた日 (1752年9月14日) をあらわすユリウス日です。この "ENGLAND" の名前は、旧い UNIX の cal(1) の記述に由来します。
`GREGORIAN`	常にグレゴリオ暦であることを示します。改暦日は無限の過去にあると考えられます。
`ITALY`	伊国がグレゴリオ暦をつかい始めた日 (1582年10月15日) をあらわすユリウス日です。
`JULIAN`	常にユリウス暦であることを示します。改暦日は無限の未来にあると考えられます。

継承したメソッド

! != < <= == > >= between? =~ __id__ __send__ _dump class clone dclone display enum_for eql? equal? extend freeze frozen? hash initialize initialize_copy inspect instance_eval instance_exec instance_of? instance_variable_defined? instance_variable_get instance_variable_set instance_variables is_a? marshal_dump marshal_load method method_missing methods must_be must_be_close_to must_be_empty must_be_instance_of must_be_kind_of must_be_nil must_be_same_as must_be_within_epsilon must_equal must_include must_match must_raise must_respond_to must_send must_throw nil? pretty_inspect pretty_print pretty_print_cycle pretty_print_inspect pretty_print_instance_variables private_methods protected_methods public_methods remove_instance_variable respond_to? respond_to_missing? singleton_class singleton_method_added singleton_method_removed singleton_method_undefined singleton_methods taint tainted? tap to_a to_ary to_hash to_int to_io to_proc to_regexp to_str to_yaml to_yaml_properties to_yaml_style trust untaint untrust untrusted? wont_be wont_be_close_to wont_be_empty wont_be_instance_of wont_be_kind_of wont_be_nil wont_be_same_as wont_be_within_epsilon wont_equal wont_include wont_match wont_respond_to

追加されるメソッド

定義	説明	ライブラリ
`json_create(hash) -> Date`	JSON のオブジェクトから Ruby のオブジェクトを生成して返します。	json/add/core
`to_json(*args) -> String`	自身を JSON 形式の文字列に変換して返します。	json/add/core