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

class Date

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

要約

日付だけでなく時刻も扱える 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日 (グレゴリオ暦) 正子/零時 (協定世界時) を暦元とした通日 (経過日数) です。

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

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

特異メソッド

定義	説明
`_parse(str, complete = false) -> Hash`	このメソッドは Date.parse と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`_strptime(str, format = '%F') -> Hash`	このメソッドは Date.strptime と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。
`civil(year = -4712, mon = 1, mday = 1, start = Date::ITALY) -> Date new(year = -4712, mon = 1, mday = 1, start = Date::ITALY) -> Date`	暦日付に相当する日付オブジェクトを生成します。
`commercial(cwyear = 1582, cweek = 41, cwday = 5, start = Date::ITALY) -> Date`	暦週日付に相当する日付オブジェクトを生成します。
`gregorian_leap?(year) -> bool leap?(year) -> bool`	グレゴリオ暦の閏年なら真を返します。
`jd(jd = 0, start = Date::ITALY) -> Date`	ユリウス日に相当する日付オブジェクトを生成します。
`julian_leap?(year) -> bool`	ユリウス暦の閏年なら真を返します。
`ordinal(year = -4712, yday = 1, start = Date::ITALY) -> Date`	年間通算日 (年日付) に相当する日付オブジェクトを生成します。
`parse(str = '-4712-01-01', complete = false, start = Date::ITALY) -> Date`	与えられた日付表現を解析し、その情報に基づいて日付オブジェクトを生成します。
`strptime(str = '-4712-01-01', format = '%F', start = Date::ITALY) -> Date`	与えられた雛型で日付表現を解析し、その情報に基づいて日付オブジェクトを生成します。
`today(start = Date::ITALY) -> Date`	現在の日付に相当する日付オブジェクトを生成します。
`valid_civil?(year, mon, mday, start = Date::GREGORIAN) -> Numeric \| nil valid_date?(year, mon, mday, start = Date::GREGORIAN) -> Numeric \| nil`	正しい暦日付であれば、相当するユリウス日を返します。そうでないなら、偽を返します。
`valid_commercial?(cwyear, cweek, cwday, start = Date::GREGORIAN) -> Numeric \| nil`	正しい暦週日付であれば、相当するユリウス日を返します。そうでないなら、偽を返します。
`valid_jd?(jd, start = Date::GREGORIAN) -> Numeric \| nil`	ひとつ目の引数をそのまま返します。
`valid_ordinal?(year, yday, start = Date::GREGORIAN) -> Numeric \| nil`	正しい年間通算日 (年日付) であれば、相当するユリウス日を返します。そうでないなら、偽を返します。

インスタンスメソッド

定義	説明
`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`	このメソッドは、step(min, -1){\|date\| ...} と等価です。
`england -> Date`	このメソッドは、new_start(Date::ENGLAND) と等価です。
`gregorian -> Date`	このメソッドは、new_start(Date::GREGORIAN) と等価です。
`gregorian? -> bool`	グレゴリオ暦なら真を返します。
`italy -> Date`	このメソッドは、new_start(Date::ITALY) と等価です。
`jd -> Integer`	ユリウス日を返します。時刻を含みません。
`julian -> Date`	このメソッドは、new_start(Date::JULIAN) と等価です。
`julian? -> bool`	ユリウス暦なら真を返します。
`ld -> Integer`	リリウス日を返します。
`leap? -> bool`	閏年なら真を返します。
`mjd -> Integer`	修正ユリウス日を返します。時刻の情報を含みません。
`mon -> Integer month -> Integer`	月を返します (1-12)。
`new_start(start = Date::ITALY) -> Date`	self を複製して、その改暦日を設定しなおします。引数を省略した場合は、Date::ITALY (1582年10月15日) になります。
`succ -> Date next -> Date`	翌日の日付オブジェクトを返します。
`start -> Integer`	改暦日をあらわすユリウス日を返します。
`step(limit, step = 1) {\|date\| ...} -> self`	ブロックの評価を繰り返します。ブロックは日付オブジェクトをとります。 limit は日付オブジェクトでなければなりません、また step は非零でなければなりません。
`strftime(format = '%F') -> String`	与えられた雛型で日付を書式づけます。
`to_s -> String`	[[ISO:8601]] 書式の文字列を返します (拡大表記はつかいません)。
`upto(max) {\|date\| ...} -> self`	このメソッドは、step(max, 1){\|date\| ...} と等価です。
`wday -> Integer`	曜日を返します (0-6、日曜日は零)。
`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 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? 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 untaint