検索結果

Time#year -> Integer (54322.0)

• 2.3.0

• インスタンスメソッド

年を整数で返します。

年を整数で返します。

//emlist[][ruby]{
t = Time.local(2000,1,2,3,4,5) # => 2000-01-02 03:04:05 +0900
p t.year # => 2000
//}

• Time

Date#year -> Integer (54304.0)

• 2.3.0

• インスタンスメソッド

年を返します。

年を返します。

• Date

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

• 2.3.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

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

• 2.3.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

Date#cwyear -> Integer (18301.0)

• 2.3.0

• インスタンスメソッド

暦週における年を返します。

暦週における年を返します。

• Date

絞り込み条件を変える

Time.parse(date, now = Time.now) {|year| year } -> Time (607.0)

• 2.3.0

• 特異メソッド

date を Date._parse によって
パースして Timeオブジェクトに変換します。

ブロック付きで呼ばれた場合、dateの年はブロックによって変換されます。

require 'time'
Time.parse(...) {|y| y < 100 ? (y >= 69 ? y + 1900 : y + 2000) : y}

与えられた時刻に上位の要素がなかったり壊れていた場合、nowの
該当要素が使われます。

require 'time'
time = Time.local(2019, 5, 1)
Time.parse("12:00", time) ...

• ArgumentError
• Time

Time.gm(sec, min, hour, mday, mon, year, wday, yday, isdst, zone) -> Time (334.0)

• 2.3.0

• 特異メソッド

引数で指定した協定世界時の Time オブジェクトを返します。

引数で指定した協定世界時の Time オブジェクトを返します。

引数の順序は Time#to_a と全く同じです。
引数 wday, yday, zone に指定した値は無視されます。
引数に nil を指定した場合の値はその引数がとり得る最小の値です。

@param sec 秒を 0 から 60 までの整数か文字列で指定します。(60はうるう秒)

@param min 分を 0 から 59 までの整数か文字列で指定します。

@param hour 時を 0 から 23 までの整数か文字列で指定します。

@param mday 日を 1 から 31 までの整数か文字列で指定...

• Time

Time.gm(year, mon = 1, day = 1, hour = 0, min = 0, sec = 0, usec = 0) -> Time (334.0)

• 2.3.0

• 特異メソッド

引数で指定した協定世界時の Time オブジェクトを返します。

引数で指定した協定世界時の Time オブジェクトを返します。

第2引数以降に nil を指定した場合の値はその引数がとり得る最小の値です。

@param year 年を整数か文字列で指定します。例えば 1998 年に対して 1998 を指定します。

@param mon 1(1月)から 12(12月)の範囲の整数または文字列で指定します。
英語の月名("Jan", "Feb", ... などの省略名。文字の大小は無視)も指定できます。

@param day 日を 1 から 31 までの整数か文字列で指定します。

@param hour 時を 0 から 2...

• Time

Time.local(sec, min, hour, mday, mon, year, wday, yday, isdst, zone) -> Time (334.0)

• 2.3.0

• 特異メソッド

引数で指定した地方時の Time オブジェクトを返します。

引数で指定した地方時の Time オブジェクトを返します。

引数の順序は Time#to_a と全く同じです。
引数 wday, yday, zone に指定した値は無視されます。
引数に nil を指定した場合の値はその引数がとり得る最小の値です。

@param sec 秒を 0 から 60 までの整数か文字列で指定します。(60はうるう秒)

@param min 分を 0 から 59 までの整数か文字列で指定します。

@param hour 時を 0 から 23 までの整数か文字列で指定します。

@param mday 日を 1 から 31 までの整数か文字列で指定しま...

• Time

Time.local(year, mon = 1, day = 1, hour = 0, min = 0, sec = 0, usec = 0) -> Time (334.0)

• 2.3.0

• 特異メソッド

引数で指定した地方時の Time オブジェクトを返します。

引数で指定した地方時の Time オブジェクトを返します。

第2引数以降に nil を指定した場合の値はその引数がとり得る最小の値です。

@param year 年を整数か文字列で指定します。例えば 1998 年に対して 1998 を指定します。

@param mon 1(1月)から 12(12月)の範囲の整数または文字列で指定します。
英語の月名("Jan", "Feb", ... などの省略名。文字の大小は無視)も指定できます。

@param day 日を 1 から 31 までの整数か文字列で指定します。

@param hour 時を 0 から 23 ...

• Time

絞り込み条件を変える

Time.mktime(sec, min, hour, mday, mon, year, wday, yday, isdst, zone) -> Time (334.0)

• 2.3.0

• 特異メソッド

引数で指定した地方時の Time オブジェクトを返します。

引数で指定した地方時の Time オブジェクトを返します。

引数の順序は Time#to_a と全く同じです。
引数 wday, yday, zone に指定した値は無視されます。
引数に nil を指定した場合の値はその引数がとり得る最小の値です。

@param sec 秒を 0 から 60 までの整数か文字列で指定します。(60はうるう秒)

@param min 分を 0 から 59 までの整数か文字列で指定します。

@param hour 時を 0 から 23 までの整数か文字列で指定します。

@param mday 日を 1 から 31 までの整数か文字列で指定しま...

• Time

Time.mktime(year, mon = 1, day = 1, hour = 0, min = 0, sec = 0, usec = 0) -> Time (334.0)

• 2.3.0

• 特異メソッド

引数で指定した地方時の Time オブジェクトを返します。

引数で指定した地方時の Time オブジェクトを返します。

第2引数以降に nil を指定した場合の値はその引数がとり得る最小の値です。

@param year 年を整数か文字列で指定します。例えば 1998 年に対して 1998 を指定します。

@param mon 1(1月)から 12(12月)の範囲の整数または文字列で指定します。
英語の月名("Jan", "Feb", ... などの省略名。文字の大小は無視)も指定できます。

@param day 日を 1 から 31 までの整数か文字列で指定します。

@param hour 時を 0 から 23 ...

• Time

Time.utc(sec, min, hour, mday, mon, year, wday, yday, isdst, zone) -> Time (334.0)

• 2.3.0

• 特異メソッド

引数で指定した協定世界時の Time オブジェクトを返します。

引数で指定した協定世界時の Time オブジェクトを返します。

引数の順序は Time#to_a と全く同じです。
引数 wday, yday, zone に指定した値は無視されます。
引数に nil を指定した場合の値はその引数がとり得る最小の値です。

@param sec 秒を 0 から 60 までの整数か文字列で指定します。(60はうるう秒)

@param min 分を 0 から 59 までの整数か文字列で指定します。

@param hour 時を 0 から 23 までの整数か文字列で指定します。

@param mday 日を 1 から 31 までの整数か文字列で指定...

• Time

Time.utc(year, mon = 1, day = 1, hour = 0, min = 0, sec = 0, usec = 0) -> Time (334.0)

• 2.3.0

• 特異メソッド

引数で指定した協定世界時の Time オブジェクトを返します。

引数で指定した協定世界時の Time オブジェクトを返します。

第2引数以降に nil を指定した場合の値はその引数がとり得る最小の値です。

@param year 年を整数か文字列で指定します。例えば 1998 年に対して 1998 を指定します。

@param mon 1(1月)から 12(12月)の範囲の整数または文字列で指定します。
英語の月名("Jan", "Feb", ... などの省略名。文字の大小は無視)も指定できます。

@param day 日を 1 から 31 までの整数か文字列で指定します。

@param hour 時を 0 から 2...

• Time

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

• 2.3.0

• 特異メソッド

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

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

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

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

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

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

• Date

絞り込み条件を変える

Date.gregorian_leap?(year) -> bool (325.0)

• 2.3.0

• 特異メソッド

グレゴリオ暦の閏年なら真を返します。

グレゴリオ暦の閏年なら真を返します。

@param year 年

• Date

Date.leap?(year) -> bool (325.0)

• 2.3.0

• 特異メソッド

グレゴリオ暦の閏年なら真を返します。

グレゴリオ暦の閏年なら真を返します。

@param year 年

• Date

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

• 2.3.0

• 特異メソッド

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

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

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

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

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

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

• Date

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

• 2.3.0

• 特異メソッド

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

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

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

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

• Date

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

• 2.3.0

• 特異メソッド

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

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

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

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

• Date

絞り込み条件を変える

DateTime.civil(year = -4712, mon = 1, mday = 1, hour = 0, min = 0, sec = 0, offset = 0, start = Date::ITALY) -> DateTime (325.0)

• 2.3.0

• 特異メソッド

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

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

時差の単位は日です。
1.8.6 以降では、"+0900" のような時差をあらわす文字列もつかえます。

@param year 年
@param mon 月
@param mday 日
@param hour 時
@param min 分
@param sec 秒
@param offset 時差
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日
@raise ArgumentError 正しくない日時

• DateTime

DateTime.new(year = -4712, mon = 1, mday = 1, hour = 0, min = 0, sec = 0, offset = 0, start = Date::ITALY) -> DateTime (325.0)

• 2.3.0

• 特異メソッド

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

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

時差の単位は日です。
1.8.6 以降では、"+0900" のような時差をあらわす文字列もつかえます。

@param year 年
@param mon 月
@param mday 日
@param hour 時
@param min 分
@param sec 秒
@param offset 時差
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日
@raise ArgumentError 正しくない日時

• DateTime

Date.julian_leap?(year) -> bool (322.0)

• 2.3.0

• 特異メソッド

ユリウス暦の閏年なら真を返します。

ユリウス暦の閏年なら真を返します。

西暦4年は真になりますが、
これは歴史的には正しくありません。

@param year 年

• Date

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

• 2.3.0

• 特異メソッド

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

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

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

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

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

• Date

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

• 2.3.0

• 特異メソッド

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

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

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

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

• Date

絞り込み条件を変える

DateTime.ordinal(year = -4712, yday = 1, hour = 0, min = 0, sec = 0, offset = 0, start = Date::ITALY) -> DateTime (322.0)

• 2.3.0

• 特異メソッド

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

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

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

@param year 年
@param yday 年の日
@param hour 時
@param min 分
@param sec 秒
@param offset 時差
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日
@raise ArgumentError 正しくない日時

• DateTime

Time.new(year, mon = nil, day = nil, hour = nil, min = nil, sec = nil, zone = nil) -> Time (322.0)

• 2.3.0

• 特異メソッド

引数で指定した地方時の Time オブジェクトを返します。

引数で指定した地方時の Time オブジェクトを返します。

mon day hour min sec に nil を指定した場合の値は、その引数がとり得る最小の値です。
zone に nil を指定した場合の値は、現在のタイムゾーンに従います。

@param year 年を整数か文字列で指定します。例えば 1998 年に対して 1998 を指定します。

@param mon 1(1月)から 12(12月)の範囲の整数または文字列で指定します。
英語の月名("Jan", "Feb", ... などの省略名。大文字小文字の違いは無視します)も指定できます。

@par...

• Time

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

• 2.3.0

• 特異メソッド

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

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

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

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

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

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

• Date

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

• 2.3.0

• 特異メソッド

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

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

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

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

• Date

DateTime.commercial(cwyear = -4712, cweek = 1, cwday = 1, hour = 0, min = 0, sec = 0, offset = 0, start = Date::ITALY) -> DateTime (301.0)

• 2.3.0

• 特異メソッド

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

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

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

@param cwyear 年
@param cweek 週
@param cwday 週の日 (曜日)
@param hour 時
@param min 分
@param sec 秒
@param offset 時差
@param start グレゴリオ暦をつかい始めた日をあらわすユリウス日
@raise ArgumentError 正しくない日時

• DateTime

絞り込み条件を変える

MatchData#offset(name) -> [Integer, Integer] | [nil, nil] (55.0)

• 2.3.0

• インスタンスメソッド

name という名前付きグループに対応する部分文字列のオフセットの配列 [start, end] を返 します。

name という名前付きグループに対応する部分文字列のオフセットの配列 [start, end] を返
します。

//emlist[例][ruby]{
[ self.begin(name), self.end(name) ]
//}

と同じです。nameの名前付きグループにマッチした部分文字列がなければ
[nil, nil] を返します。

@param name 名前(シンボルか文字列)

@raise IndexError 正規表現中で定義されていない name を指定した場合に発生します。

//emlist[例][ruby]{
/(?<year>\d{4})年(?<month>\...

• MatchData

Psych::ScalarScanner#tokenize(string) -> object (37.0)

• 2.3.0

• インスタンスメソッド

YAML の scalar である文字列を Ruby のオブジェクトに変換した ものを返します。

YAML の scalar である文字列を Ruby のオブジェクトに変換した
ものを返します。

scanner = Psych::ScalarScanner.new
p scanner.tokenize("yes") # => true
p scanner.tokenize("year") # => "year"
p scanner.tokenize("12") # => 12

@param string 変換文字列

• Psych::ScalarScanner

Time#to_a -> Array (37.0)

• 2.3.0

• インスタンスメソッド

時刻を10要素の配列で返します。

時刻を10要素の配列で返します。

その要素は順序も含めて以下の通りです。

* sec: 秒 (整数 0-60) (60はうるう秒)
* min: 分 (整数 0-59)
* hour: 時 (整数 0-23)
* mday: 日 (整数)
* mon: 月 (整数 1-12)
* year: 年 (整数 2000年=2000)
* wday: 曜日 (整数 0-6)
* yday: 年内通算日 (整数 1-366)
* isdst: 夏時間であるかどうか (true/false)
* zone: タイムゾーン (文字列)

...

• Time

Date (19.0)

• 2.3.0

• クラス

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

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

=== 簡単なつかいかた

//emlist[例][ruby]{
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
//}

=== 用語の定義

いくつか用語の定義は、8601、および X...

• DateTime

DateTime (19.0)

• 2.3.0

• クラス

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

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

DateTime は deprecated とされているため、
Timeを使うことを推奨します。

=== 簡単なつかいかた

require 'date'

a = DateTime.new(1993, 2, 24, 12, 30, 45)
b = DateTime.parse('1993-02-24T12:30:45')
b += 10

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

yes...

• Date
• Time

絞り込み条件を変える

DateTime._strptime(str, format = &#39;%FT%T%z&#39;) -> Hash (19.0)

• 2.3.0

• 特異メソッド

与えられた雛型で日時表現を解析し、その情報に基づいてハッシュを生成します。

与えられた雛型で日時表現を解析し、その情報に基づいてハッシュを生成します。

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

例:

require 'date'
DateTime._strptime('2001-02-03T12:13:14Z')
# => {:year=>2001, :mon=>2, :mday=>3, :hour=>12, :min=>13, :sec=>14, :zone=>"Z", :offset=>0}

DateTime.strptime の内部で使用されています。

@see Date._strptime, Date...

• DateTime

Time (19.0)

• 2.3.0

• クラス

時刻を表すクラスです。

時刻を表すクラスです。

Time.now は現在の時刻を返します。
File.mtime などが返すファイルのタイムスタンプは Time
オブジェクトです。

Time オブジェクトは時刻を起算時からの経過秒数で保持しています。
起算時は協定世界時(UTC、もしくはその旧称から GMT とも表記されます) の
1970年1月1日午前0時です。なお、うるう秒を勘定するかどうかはシステムに
よります。

Time オブジェクトが格納可能な時刻の範囲は環境によって異なっていましたが、
Ruby 1.9.2 からは OS の制限の影響を受けません。

また、Time オブジェクトは協定世界時と地方時...

• time

Time#strftime(format) -> String (19.0)

• 2.3.0

• インスタンスメソッド

時刻を format 文字列に従って文字列に変換した結果を返します。

時刻を format 文字列に従って文字列に変換した結果を返します。

@param format フォーマット文字列を指定します。使用できるものは 以下の通りです。

* %A: 曜日の名称(Sunday, Monday ... )
* %a: 曜日の省略名(Sun, Mon ... )
* %B: 月の名称(January, February ... )
* %b: 月の省略名(Jan, Feb ... )
* %C: 世紀 (2009年であれば 20)
* %c: 日付と時刻 (%a %b %e %T %Y)
* %D: 日付 (%m/%d/%y)
* ...

• Time

MatchData#offset(n) -> [Integer, Integer] | [nil, nil] (10.0)

• 2.3.0

• インスタンスメソッド

n 番目の部分文字列のオフセットの配列 [start, end] を返 します。

n 番目の部分文字列のオフセットの配列 [start, end] を返
します。

//emlist[例][ruby]{
[ self.begin(n), self.end(n) ]
//}

と同じです。n番目の部分文字列がマッチしていなければ
[nil, nil] を返します。

@param n 部分文字列を指定する数値

@raise IndexError 範囲外の n を指定した場合に発生します。

@see MatchData#begin, MatchData#end

• MatchData

Time.new -> Time (7.0)

• 2.3.0

• 特異メソッド

現在時刻の Time オブジェクトを生成して返します。 タイムゾーンは地方時となります。

現在時刻の Time オブジェクトを生成して返します。
タイムゾーンは地方時となります。

//emlist[][ruby]{
p Time.now # => 2009-06-24 12:39:54 +0900
//}

• Time

絞り込み条件を変える

Time.now -> Time (7.0)

• 2.3.0

• 特異メソッド

現在時刻の Time オブジェクトを生成して返します。 タイムゾーンは地方時となります。

現在時刻の Time オブジェクトを生成して返します。
タイムゾーンは地方時となります。

//emlist[][ruby]{
p Time.now # => 2009-06-24 12:39:54 +0900
//}

• Time

Time.parse(date, now = Time.now) -> Time (7.0)

• 2.3.0

• 特異メソッド

date を Date._parse によって
パースして Timeオブジェクトに変換します。

ブロック付きで呼ばれた場合、dateの年はブロックによって変換されます。

require 'time'
Time.parse(...) {|y| y < 100 ? (y >= 69 ? y + 1900 : y + 2000) : y}

与えられた時刻に上位の要素がなかったり壊れていた場合、nowの
該当要素が使われます。

require 'time'
time = Time.local(2019, 5, 1)
Time.parse("12:00", time) ...

• ArgumentError
• Time