クエリ:date > バージョン:3.2 | るりまサーチ (Ruby 3.2)

暦日付に相当する日付オブジェクトを生成します。

このクラスでは、紀元前の年を天文学の流儀で勘定します。
1年の前は零年、零年の前は-1年、のようにします。
月、および月の日は負、
または正の数でなければなりません (負のときは最後からの序数)。
零であってはなりません。

最後の引数は、グレゴリオ暦をつかい始めた日をあらわすユリウス日です。
省略した場合は、Date::ITALY (1582年10月15日) になります。

Date.jd も参照してください。

@param year 年
@param mon 月
@param mday 日
@param start グレゴリオ暦をつかい始...

Date.new(year = -4712, mon = 1, mday = 1, start = Date::ITALY) -> Date (51721.0)

特異メソッド

暦日付に相当する日付オブジェクトを生成します。

Date#new_start(start = Date::ITALY) -> Date (51673.0)

インスタンスメソッド

self を複製して、その改暦日を設定しなおします。引数を省略した場合は、Date::ITALY (1582年10月15日) になります。

self を複製して、その改暦日を設定しなおします。
引数を省略した場合は、Date::ITALY (1582年10月15日) になります。

Date.new も参照してください。

@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

絞り込み条件を変える

Date.commercial(cwyear = -4712, cweek = 1, cwday = 1, start = Date::ITALY) -> Date (51661.0)

特異メソッド

暦週日付に相当する日付オブジェクトを生成します。

暦週日付に相当する日付オブジェクトを生成します。

週、および週の日 (曜日) は負、
または正の数でなければなりません(負のときは最後からの序数)。
零であってはなりません。

このメソッドに改暦前の日付を与えることはできません。

Date.jd、および Date.new も参照してください。

@param cwyear 年
@param cweek 週
@param cwday 週の日 (曜日)
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日
@raise Date::Error 正しくない日付になる組み合わせである場合に発生します。

Date.ordinal(year = -4712, yday = 1, start = Date::ITALY) -> Date (51661.0)

特異メソッド

年間通算日 (年日付) に相当する日付オブジェクトを生成します。

年間通算日 (年日付) に相当する日付オブジェクトを生成します。

年の日は負、
または正の数でなければなりません (負のときは最後からの序数)。
零であってはなりません。

Date.jd、および Date.new も参照してください。

@param year 年
@param yday 年の日
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日
@raise Date::Error 正しくない日付になる組み合わせである場合に発生します。

Date.strptime(str = '-4712-01-01', format = '%F', start = Date::ITALY) -> Date (51661.0)

特異メソッド

与えられた雛型で日付表現を解析し、その情報に基づいて日付オブジェクトを生成します。

与えられた雛型で日付表現を解析し、
その情報に基づいて日付オブジェクトを生成します。

Date._strptime も参照してください。
また strptime(3)、および Date#strftime も参照してください。

@param str 日付をあらわす文字列
@param format 書式
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日
@raise Date::Error 正しくない日付になる組み合わせである場合に発生します。

Date.today(start = Date::ITALY) -> Date (51661.0)

特異メソッド

現在の日付に相当する日付オブジェクトを生成します。

現在の日付に相当する日付オブジェクトを生成します。

@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

//emlist[例][ruby]{
require 'date'
Date.today # => #<Date: 2017-09-20 ...>
//}

Date.parse(str = '-4712-01-01', complete = true, start = Date::ITALY) -> Date (51643.0)

特異メソッド

与えられた日付表現を解析し、その情報に基づいて日付オブジェクトを生成します。

与えられた日付表現を解析し、
その情報に基づいて日付オブジェクトを生成します。

年が "00" から "99" の範囲であれば、
年の下2桁表現であるとみなしこれを補います。
この振舞いを抑止したい場合は、ヒントとして、complete に false を与えます。

Date._parse も参照してください。

@param str 日付をあらわす文字列
@param complete 年を補完するか
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日
@raise Date::Error 正しくない日付になる組み合わせである場合に発生します。

絞り込み条件を変える

Date.rfc2822(str = 'Mon, 1 Jan -4712 00:00:00 +0000', start = Date::ITALY) -> Date (51631.0)

特異メソッド

2822 で定められた書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。

2822 で定められた書式の日付を解析し、
その情報に基づいて日付オブジェクトを生成します。

Date._rfc2822 も参照してください。

@param str 日付をあらわす文字列
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

Date.rfc822(str = 'Mon, 1 Jan -4712 00:00:00 +0000', start = Date::ITALY) -> Date (51631.0)

特異メソッド

2822 で定められた書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。

Date#<<(n) -> Date (51628.0)

インスタンスメソッド

self より n ヶ月前の日付オブジェクトを返します。 n は数値でなければなりません。

self より n ヶ月前の日付オブジェクトを返します。
n は数値でなければなりません。

//emlist[][ruby]{
require 'date'
Date.new(2001,2,3) << 1 #=> #<Date: 2001-01-03 ...>
Date.new(2001,2,3) << -2 #=> #<Date: 2001-04-03 ...>
//}

対応する月に同じ日が存在しない時は、代わりにその月の末日が使われます。

//emlist[][ruby]{
require 'date'
Date.new(2001,3,28) << 1 #=> #<...

Date#>>(n) -> Date (51628.0)

インスタンスメソッド

self から n ヶ月後の日付オブジェクトを返します。 n は数値でなければなりません。

self から n ヶ月後の日付オブジェクトを返します。
n は数値でなければなりません。

//emlist[][ruby]{
require 'date'
Date.new(2001,2,3) >> 1 #=> #<Date: 2001-03-03 ...>
Date.new(2001,2,3) >> -2 #=> #<Date: 2000-12-03 ...>
//}

対応する月に同じ日が存在しない時は、代わりにその月の末日が使われます。

//emlist[][ruby]{
require 'date'
Date.new(2001,1,28) >> 1 #=> #...

Date.iso8601(str = '-4712-01-01', start = Date::ITALY) -> Date (51625.0)

特異メソッド

いくつかの代表的な 8601 書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。

いくつかの代表的な 8601 書式の日付を解析し、
その情報に基づいて日付オブジェクトを生成します。

@param str 日付をあらわす文字列

Date._iso8601 も参照してください。

@param str 日付をあらわす文字列
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

絞り込み条件を変える

Date.jd(jd = 0, start = Date::ITALY) -> Date (51625.0)

特異メソッド

ユリウス日に相当する日付オブジェクトを生成します。

ユリウス日に相当する日付オブジェクトを生成します。

このクラスのいくつかの重要なメソッドで、
負のユリウス日は保証されません。

Date.new も参照してください。

@param jd ユリウス日
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

Date.jisx0301(str = '-4712-01-01', start = Date::ITALY) -> Date (51625.0)

特異メソッド

いくつかの代表的な X 0301 書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。

いくつかの代表的な X 0301 書式の日付を解析し、
その情報に基づいて日付オブジェクトを生成します。

Date._jisx0301 も参照してください。

@param str 日付をあらわす文字列
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

Date.rfc3339(str = '-4712-01-01T00:00:00+00:00', start = Date::ITALY) -> Date (51625.0)

特異メソッド

3339 書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。

3339 書式の日付を解析し、
その情報に基づいて日付オブジェクトを生成します。

Date._rfc3339 も参照してください。

@param str 日付をあらわす文字列
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

Date.xmlschema(str = '-4712-01-01', start = Date::ITALY) -> Date (51625.0)

特異メソッド

XML Schema による書式の日付を解析し、その情報に基づいて日付オブジェクトを生成します。

XML Schema による書式の日付を解析し、
その情報に基づいて日付オブジェクトを生成します。

Date._xmlschema も参照してください。

@param str 日付をあらわす文字列
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

Date#next_year(n = 1) -> Date (51448.0)

インスタンスメソッド

n 年後を返します。

n 年後を返します。

self >> (n * 12) に相当します。

//emlist[例][ruby]{
require 'date'
Date.new(2001,2,3).next_year #=> #<Date: 2002-02-03 ...>
Date.new(2008,2,29).next_year #=> #<Date: 2009-02-28 ...>
Date.new(2008,2,29).next_year(4) #=> #<Date: 2012-02-29 ...>
//}

Date#>> も参照してください。

@param n 年数

絞り込み条件を変える

Date#prev_year(n = 1) -> Date (51448.0)

インスタンスメソッド

n 年前を返します。

n 年前を返します。

self << (n * 12) に相当します。

//emlist[例][ruby]{
require 'date'
Date.new(2001,2,3).prev_year #=> #<Date: 2000-02-03 ...>
Date.new(2008,2,29).prev_year #=> #<Date: 2007-02-28 ...>
Date.new(2008,2,29).prev_year(4) #=> #<Date: 2004-02-29 ...>
//}

Date#<< も参照してください。

@param n 年数

Date#downto(min) {|date| ...} -> self (51388.0)

インスタンスメソッド

このメソッドは、step(min, -1){|date| ...} と等価です。

このメソッドは、step(min, -1){|date| ...} と等価です。

@param min 日付オブジェクト

@see Date#step, Date#upto

Date#england -> Date (51388.0)

インスタンスメソッド

このメソッドは、new_start(Date::ENGLAND) と等価です。

このメソッドは、new_start(Date::ENGLAND) と等価です。

Date#new_start、および Date::ENGLAND を参照してください。

Date#gregorian -> Date (51388.0)

インスタンスメソッド

このメソッドは、new_start(Date::GREGORIAN) と等価です。

このメソッドは、new_start(Date::GREGORIAN) と等価です。

Date#new_start、および Date::GREGORIAN を参照してください。

Date#italy -> Date (51388.0)

インスタンスメソッド

このメソッドは、new_start(Date::ITALY) と等価です。

このメソッドは、new_start(Date::ITALY) と等価です。

Date#new_start、および Date::ITALY を参照してください。

絞り込み条件を変える

Date#julian -> Date (51388.0)

インスタンスメソッド

このメソッドは、new_start(Date::JULIAN) と等価です。

このメソッドは、new_start(Date::JULIAN) と等価です。

Date#new_start、および Date::JULIAN を参照してください。

Date#upto(max) {|date| ...} -> self (51388.0)

インスタンスメソッド

このメソッドは、step(max, 1){|date| ...} と等価です。

このメソッドは、step(max, 1){|date| ...} と等価です。

@param max 日付オブジェクト

@see Date#step, Date#downto

Date.valid_civil?(year, mon, mday, start = Date::GREGORIAN) -> bool (51346.0)

特異メソッド

正しい暦日付であれば真、そうでないなら偽を返します。

Date#step(limit, step = 1) {|date| ...} -> self (51340.0)

インスタンスメソッド

ブロックの評価を繰り返します。ブロックは日付オブジェクトをとります。 limit は日付オブジェクトでなければなりません、また step は非零でなければなりません。

ブロックの評価を繰り返します。ブロックは日付オブジェクトをとります。
limit は日付オブジェクトでなければなりません、
また step は非零でなければなりません。

@param limit 日付オブジェクト
@param step 歩幅

@see Date#downto, Date#upto

Date.valid_commercial?(cwyear, cweek, cwday, start = Date::GREGORIAN) -> bool (51340.0)

特異メソッド

正しい暦週日付であれば真、そうでないなら偽を返します。

正しい暦週日付であれば真、そうでないなら偽を返します。

Date.jd、および Date.commercial も参照してください。

@param cwyear 年
@param cweek 週
@param cwday 週の日 (曜日)
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

絞り込み条件を変える

Date.valid_ordinal?(year, yday, start = Date::GREGORIAN) -> bool (51340.0)

特異メソッド

正しい年間通算日 (年日付) であれば真、そうでないなら偽を返します。

正しい年間通算日 (年日付) であれば真、そうでないなら偽を返します。

Date.jd、および Date.ordinal も参照してください。

@param year 年
@param yday 年の日
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

Date#next_day(n = 1) -> Date (51322.0)

インスタンスメソッド

n 日後を返します。

n 日後を返します。

Date#succ も参照してください。

@param n 日数

Date#next_month(n = 1) -> Date (51322.0)

インスタンスメソッド

n ヶ月後を返します。

n ヶ月後を返します。

Date#>> も参照してください。

@param n 月数

Date#prev_month(n = 1) -> Date (51322.0)

インスタンスメソッド

n ヶ月前を返します。

n ヶ月前を返します。

Date#<< も参照してください。

@param n 月数

Date.valid_jd?(jd, start = Date::GREGORIAN) -> bool (51322.0)

特異メソッド

真を返します。

真を返します。

対称性のため用意されていますが、実際的に意味はありません。

Date.jd も参照してください。

@param jd ユリウス日
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日

絞り込み条件を変える

Date#next -> Date (51307.0)

インスタンスメソッド

翌日の日付オブジェクトを返します。

Date#succ -> Date (51307.0)

インスタンスメソッド

翌日の日付オブジェクトを返します。

Date#+(n) -> Date (51304.0)

インスタンスメソッド

self から n 日後の日付オブジェクトを返します。 n は数値でなければなりません。

self から n 日後の日付オブジェクトを返します。
n は数値でなければなりません。

@param n 日数
@raise TypeError n が数値でない場合に発生します。

Date#-(x) -> Rational | Date (51304.0)

インスタンスメソッド

x が日付オブジェクトなら、ふたつの差を Rational で返します。単位は日です。あるいは x が数値ならば、self より x 日前の日付を返します。

x が日付オブジェクトなら、ふたつの差を Rational で返します。単位は日です。
あるいは
x が数値ならば、self より x 日前の日付を返します。

@param x 日数、あるいは日付オブジェクト
@raise TypeError x が数値でも日付オブジェクトでもない場合に発生します。

Date#prev_day(n = 1) -> Date (51304.0)

インスタンスメソッド

n 日前を返します。

n 日前を返します。

@param n 日数

絞り込み条件を変える

Date::GREGORIAN -> Date::Infinity (51304.0)

定数

常にグレゴリオ暦であることを示します。改暦日は無限の過去にあると考えられます。

常にグレゴリオ暦であることを示します。
改暦日は無限の過去にあると考えられます。

Date::JULIAN -> Date::Infinity (51304.0)

定数

常にユリウス暦であることを示します。改暦日は無限の未来にあると考えられます。

常にユリウス暦であることを示します。
改暦日は無限の未来にあると考えられます。

Date#<=>(other) -> -1 | 0 | 1 | nil (51163.0)

インスタンスメソッド

二つの日付を比較します。同じ日付なら 0 を、self が other よりあとの日付なら 1 を、その逆なら -1 を返します。

二つの日付を比較します。
同じ日付なら 0 を、self が other よりあとの日付なら 1 を、
その逆なら -1 を返します。

other は日付オブジェクトか、
天文学的なユリウス日をあらわす数値を指定します。
そうでない場合、比較ができないので nil を返します。

//emlist[][ruby]{
require "date"

p Date.new(2001, 2, 3) <=> Date.new(2001, 2, 4) # => -1
p Date.new(2001, 2, 3) <=> Date.new(2001, 2, 3) # => 0
p Date.new(20...

Date#downto(min) -> Enumerator (51088.0)

インスタンスメソッド

このメソッドは、step(min, -1){|date| ...} と等価です。

このメソッドは、step(min, -1){|date| ...} と等価です。

@param min 日付オブジェクト

@see Date#step, Date#upto

Date#upto(max) -> Enumerator (51088.0)

インスタンスメソッド

このメソッドは、step(max, 1){|date| ...} と等価です。

このメソッドは、step(max, 1){|date| ...} と等価です。

@param max 日付オブジェクト

@see Date#step, Date#downto

絞り込み条件を変える

Date._iso8601(str) -> Hash (51067.0)

特異メソッド

このメソッドは Date.iso8601 と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。

このメソッドは Date.iso8601 と似ていますが、日付オブジェクトを生成せずに、
見いだした要素をハッシュで返します。

Date.iso8601 も参照してください。

@param str 日付をあらわす文字列

Date._jisx0301(str) -> Hash (51067.0)

特異メソッド

このメソッドは Date.jisx0301 と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。

このメソッドは Date.jisx0301 と似ていますが、日付オブジェクトを生成せずに、
見いだした要素をハッシュで返します。

Date.jisx0301 も参照してください。

@param str 日付をあらわす文字列

Date._parse(str, complete = true) -> Hash (51067.0)

特異メソッド

このメソッドは Date.parse と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。

このメソッドは Date.parse と似ていますが、日付オブジェクトを生成せずに、
見いだした要素をハッシュで返します。

Date.parse も参照してください。

@param str 日付をあらわす文字列
@param complete 年を補完するか

Date._rfc2822(str) -> Hash (51067.0)

特異メソッド

このメソッドは Date.rfc2822 と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。

このメソッドは Date.rfc2822 と似ていますが、日付オブジェクトを生成せずに、
見いだした要素をハッシュで返します。

Date.rfc2822 も参照してください。

@param str 日付をあらわす文字列

Date._rfc3339(str) -> Hash (51067.0)

特異メソッド

このメソッドは Date.rfc3339 と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。

このメソッドは Date.rfc3339 と似ていますが、日付オブジェクトを生成せずに、
見いだした要素をハッシュで返します。

Date.rfc3339 も参照してください。

@param str 日付をあらわす文字列

絞り込み条件を変える

Date._rfc822(str) -> Hash (51067.0)

特異メソッド

このメソッドは Date.rfc2822 と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。

Date._strptime(str, format = '%F') -> Hash (51067.0)

特異メソッド

このメソッドは Date.strptime と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。

このメソッドは Date.strptime と似ていますが、日付オブジェクトを生成せずに、
見いだした要素をハッシュで返します。

@param str 日付をあらわす文字列
@param format 書式文字列

書式文字列に使用できるものは以下の通りです。

* %A: 曜日の名称(Sunday, Monday ... )
* %a: 曜日の省略名(Sun, Mon ... )
* %B: 月の名称(January, February ... )
* %b: 月の省略名(Jan, Feb ... )
* %C: 世紀 (2009年であれば 20)
* %c: 日付...

Date._xmlschema(str) -> Hash (51067.0)

特異メソッド

このメソッドは Date.xmlschema と似ていますが、日付オブジェクトを生成せずに、見いだした要素をハッシュで返します。

このメソッドは Date.xmlschema と似ていますが、日付オブジェクトを生成せずに、
見いだした要素をハッシュで返します。

Date.xmlschema も参照してください。

@param str 日付をあらわす文字列

Date#ajd -> Rational (51049.0)

インスタンスメソッド

このメソッドは Date#jd と似ていますが、天文学的なユリウス日を返します。時刻を含みます。

このメソッドは Date#jd と似ていますが、天文学的なユリウス日を返します。
時刻を含みます。

Date#amjd -> Rational (51049.0)

インスタンスメソッド

このメソッドは Date#mjd と似ていますが、天文学的な修正ユリウス日を返します。時刻を含みます。

このメソッドは Date#mjd と似ていますが、天文学的な修正ユリウス日を返します。
時刻を含みます。

絞り込み条件を変える

Date#xmlschema -> String (51049.0)

インスタンスメソッド

XML Scheme (date) による書式の文字列を返します。

Date#step(limit, step = 1) -> Enumerator (51040.0)

インスタンスメソッド

Date#jd -> Integer (51019.0)

インスタンスメソッド

ユリウス日を返します。時刻を含みません。

ユリウス日を返します。
時刻を含みません。

Date#ajd も参照してください。

Date#mjd -> Integer (51019.0)

インスタンスメソッド

修正ユリウス日を返します。時刻の情報を含みません。

修正ユリウス日を返します。
時刻の情報を含みません。

Date#amjd も参照してください。

Date#start -> Integer (51019.0)

インスタンスメソッド

改暦日をあらわすユリウス日を返します。

改暦日をあらわすユリウス日を返します。

Date.new も参照してください。

絞り込み条件を変える

Date#strftime(format = '%F') -> String (51019.0)

インスタンスメソッド

与えられた雛型で日付を書式づけます。

与えられた雛型で日付を書式づけます。

つぎの変換仕様をあつかいます:

%A, %a, %B, %b, %C, %c, %D, %d, %e, %F, %G, %g, %H, %h, %I, %j, %k, %L, %l,
%M, %m, %N, %n, %P, %p, %Q, %R, %r, %S, %s, %T, %t, %U, %u, %V, %v, %W, %w, %X,
%x, %Y, %y, %Z, %z, %:z, %::z, %:::z, %%, %+

GNU 版にあるような幅指定などもできます。

strftime(3)、および Date.strptime も参照してくだ...

Date::ENGLAND -> Integer (51019.0)

定数

英国がグレゴリオ暦をつかい始めた日 (1752年9月14日) をあらわすユリウス日です。この "ENGLAND" の名前は、旧い UNIX の cal(1) の記述に由来します。

英国がグレゴリオ暦をつかい始めた日 (1752年9月14日) をあらわすユリウス日です。
この "ENGLAND" の名前は、旧い UNIX の cal(1) の記述に由来します。

@see https://www.bell-labs.com/usr/dmr/www/pdfs/man61.pdf

ちなみに、本実装で英国の改暦日を尊重する姿勢がみられるのは前実装からの影響です。
前実装が英国の改暦日を尊重していたのは、おそらく cal(1) の影響です。
もっとも本実装で一番に尊重されているのは、伊国の改暦日であり、多くの場合、
改暦日の既定値は Date::ITALY です。

Date#===(other) -> bool (51001.0)