るりまサーチ (Ruby 3.4)

最速Rubyリファレンスマニュアル検索!
59件ヒット [1-59件を表示] (0.097秒)
トップページ > クエリ:c[x] > クラス:Time[x] > バージョン:3.4[x]

別のキーワード

  1. _builtin to_c
  2. etc sc_2_c_dev
  3. etc sc_2_c_bind
  4. tracer display_c_call
  5. tracer display_c_call=

ライブラリ

キーワード

検索結果

Time.rfc2822(date) -> Time (18406.0)

2822で定義されているdate-timeとしてdateをパースして Timeオブジェクトに変換します。 この形式は822で定義されて1123で更新された形式と 同じです。

...2822で定義されているdate-timeとしてdateをパースして
Time
オブジェクトに変換します。
この形式は822で定義されて1123で更新された形式と
同じです。

dateが2822に準拠していない、または
Time
クラスが指定された日時を表現でき...
...date-time として文字列を指定します。

@raise ArgumentError dateが2822に準拠していない、または
Time
クラスが指定された日時を表現できないときに
発生します。

使用例
require 'time'

rfc2822_time = 'Sun...
..., 31 Aug 2008 12:08:19 +0900'
t = Time.rfc2822(rfc2822_time)
p t.kind_of?(Time) #=> true
non_rfc2822_time = 'Sun 31 Aug 2008 12:08:19 +0900'

begin
p Time.rfc2822(non_rfc2822_time)
rescue ArgumentError => err
puts "format err: #{err}"
end...

Time.rfc822(date) -> Time (18406.0)

2822で定義されているdate-timeとしてdateをパースして Timeオブジェクトに変換します。 この形式は822で定義されて1123で更新された形式と 同じです。

...2822で定義されているdate-timeとしてdateをパースして
Time
オブジェクトに変換します。
この形式は822で定義されて1123で更新された形式と
同じです。

dateが2822に準拠していない、または
Time
クラスが指定された日時を表現でき...
...date-time として文字列を指定します。

@raise ArgumentError dateが2822に準拠していない、または
Time
クラスが指定された日時を表現できないときに
発生します。

使用例
require 'time'

rfc2822_time = 'Sun...
..., 31 Aug 2008 12:08:19 +0900'
t = Time.rfc2822(rfc2822_time)
p t.kind_of?(Time) #=> true
non_rfc2822_time = 'Sun 31 Aug 2008 12:08:19 +0900'

begin
p Time.rfc2822(non_rfc2822_time)
rescue ArgumentError => err
puts "format err: #{err}"
end...

Time#ceil(ndigits=0) -> Time (18352.0)

十進小数点数で指定した桁数の精度で切り上げをし、 その Time オブジェクトを返します。 (デフォルトは0、つまり小数点の所で切り上げます)。

...上げをし、
その Time オブジェクトを返します。
(デフォルトは0、つまり小数点の所で切り上げます)。

ndigits には 0 以上の整数を渡します。

@param ndigits 十進での精度(桁数)

//emlist[][ruby]{
require 'time'

t = Time.utc(2010,3,30, 5,43,25....
...0Z"

t = Time.utc(1999,12,31, 23,59,59)
(t + 0.4).ceil.iso8601(3) # => "2000-01-01T00:00:00.000Z"
(t + 0.9).ceil.iso8601(3) # => "2000-01-01T00:00:00.000Z"
(t + 1.4).ceil.iso8601(3) # => "2000-01-01T00:00:01.000Z"
(t + 1.9).ceil.iso8601(3) # => "2000-01-01T00:00:01.000Z"

t = Time.utc(19...
...99,12,31, 23,59,59)
(t + 0.123456789).ceil(4).iso8601(6) # => "1999-12-31T23:59:59.123500Z"
//}

@see Time#floor, Time#round...

Time#deconstruct_keys(array_of_names_or_nil) -> Hash (18352.0)

パターンマッチに使用する名前と値の Hash を返します。

...チに使用する名前の配列を指定します。nil の場合は全てをパターンマッチに使用します。

//emlist[例][ruby]{
t = Time.utc(2022, 10, 5, 21, 25, 30)

if t in wday: 3, day: ..7 # deconstruct_keys が使われます
puts "first Wednesday of the month"
end
#=> "first...
...ng day in month #{month}"
end
#=> "working day in month 10" が出力される

# クラスのチェックと組み合わせて利用することもできます
if t in Time(wday: 3, day: ..7)
puts "first Wednesday of the month"
end
//}

@see d:spec/pattern_matching#matching_non_primitive_objects...

Time#subsec -> Integer | Rational (18322.0)

時刻を表す分数を返します。

...時刻を表す分数を返します。

Rational を返す場合があります。

//emlist[][ruby]{
t = Time.local(2000,1,2,3,4,5,6)
p "%10.9f" % t.to_f # => "946749845.000005960"
p t.subsec #=> (3/500000)
//}

to_f の値と subsec の値の下のほうの桁の値は異なる場...

絞り込み条件を変える

Time#asctime -> String (18304.0)

時刻を asctime(3) の形式の文字列に変換します。た だし、末尾の改行文字 "\n" は含まれません。

...を asctime(3) の形式の文字列に変換します。た
だし、末尾の改行文字 "\n" は含まれません。

戻り値の文字エンコーディングは Encoding::US_ASCII です。

//emlist[][ruby]{
p Time.local(2000).asctime # => "Sat Jan 1 00:00:00 2000"
p Time.local(...
...2000).asctime.encoding # => #<Encoding:US-ASCII>
p Time.local(2000).ctime # => "Sat Jan 1 00:00:00 2000"
//}...

Time#ctime -> String (18304.0)

時刻を asctime(3) の形式の文字列に変換します。た だし、末尾の改行文字 "\n" は含まれません。

...を asctime(3) の形式の文字列に変換します。た
だし、末尾の改行文字 "\n" は含まれません。

戻り値の文字エンコーディングは Encoding::US_ASCII です。

//emlist[][ruby]{
p Time.local(2000).asctime # => "Sat Jan 1 00:00:00 2000"
p Time.local(...
...2000).asctime.encoding # => #<Encoding:US-ASCII>
p Time.local(2000).ctime # => "Sat Jan 1 00:00:00 2000"
//}...

Time#getlocal -> Time (18304.0)

タイムゾーンを地方時に設定した Time オブジェクトを新しく生成 して返します。

...タイムゾーンを地方時に設定した Time オブジェクトを新しく生成
して返します。

@param utc_offset タイムゾーンを地方時に設定する代わりに協定世界時との
時差を、秒を単位とする整数か、"+HH:MM" "-HH:MM" 形式...
...の文字列で指定します。

//emlist[][ruby]{
p t = Time.utc(2000,1,1,20,15,1) # => 2000-01-01 20:15:01 UTC
p t.utc? # => true
p l = t.getlocal # => 2000-01-02 05:15:01 +0900
p l.utc? # => false
p t == l...

Time#getlocal(utc_offset) -> Time (18304.0)

タイムゾーンを地方時に設定した Time オブジェクトを新しく生成 して返します。

...タイムゾーンを地方時に設定した Time オブジェクトを新しく生成
して返します。

@param utc_offset タイムゾーンを地方時に設定する代わりに協定世界時との
時差を、秒を単位とする整数か、"+HH:MM" "-HH:MM" 形式...
...の文字列で指定します。

//emlist[][ruby]{
p t = Time.utc(2000,1,1,20,15,1) # => 2000-01-01 20:15:01 UTC
p t.utc? # => true
p l = t.getlocal # => 2000-01-02 05:15:01 +0900
p l.utc? # => false
p t == l...

Time#inspect -> String (18304.0)

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

...刻を文字列に変換した結果を返します。

Time
#to_s とは異なりナノ秒まで含めて返します。

//emlist[][ruby]{
t = Time.now
t.inspect #=> "2012-11-10 18:16:12.261257655 +0100"
t.strftime "%Y-%m-%d %H:%M:%S.%N %z" #=> "2012-11-10 18:16:12.2612...
...57655 +0100"

t.utc.inspect #=> "2012-11-10 17:16:12.261257655 UTC"
t.strftime "%Y-%m-%d %H:%M:%S.%N UTC" #=> "2012-11-10 17:16:12.261257655 UTC"
//}

戻り値の文字エンコーディングは Encoding::US_ASCII です。...

絞り込み条件を変える

Time#localtime -> self (18304.0)

タイムゾーンを地方時に設定します。

...とする整数か、"+HH:MM" "-HH:MM" 形式
の文字列で指定します。

Time
#localtime, Time#gmtime の挙動はシステムの
localtime(3) の挙動に依存します。Time クラ
スでは時刻を起算時からの経過秒数として保持していますが、ある...
...。システムを越えて Time オブジェクトを受け
渡す場合には注意する必要があります。

//emlist[][ruby]{
p t = Time.utc(2000, "jan", 1, 20, 15, 1) # => 2000-01-01 20:15:01 UTC
p t.utc? # => true
p t.localtime...
...# => 2000-01-02 05:15:01 +0900
p t.utc? # => false

p t.localtime("+09:00") # => 2000-01-02 05:15:01 +0900
p t.utc? # => false
//}...

Time#localtime(utc_offset) -> self (18304.0)

タイムゾーンを地方時に設定します。

...とする整数か、"+HH:MM" "-HH:MM" 形式
の文字列で指定します。

Time
#localtime, Time#gmtime の挙動はシステムの
localtime(3) の挙動に依存します。Time クラ
スでは時刻を起算時からの経過秒数として保持していますが、ある...
...。システムを越えて Time オブジェクトを受け
渡す場合には注意する必要があります。

//emlist[][ruby]{
p t = Time.utc(2000, "jan", 1, 20, 15, 1) # => 2000-01-01 20:15:01 UTC
p t.utc? # => true
p t.localtime...
...# => 2000-01-02 05:15:01 +0900
p t.utc? # => false

p t.localtime("+09:00") # => 2000-01-02 05:15:01 +0900
p t.utc? # => false
//}...

Time#nsec -> Integer (18304.0)

時刻のナノ秒の部分を整数で返します。

...部分を整数で返します。

//emlist[][ruby]{
t = Time.local(2000,1,2,3,4,5,6)
p "%10.9f" % t.to_f # => "946749845.000005960"
p t.nsec # => 6000
//}

IEEE 754 浮動小数点数で表現できる精度が違うため、Time#to_fの最小
の桁とnsecの最小の桁は異なり...

Time#rfc2822 -> String (18304.0)

2822 で定義されている date-time として表現される形式の文字列を 返します。

...されている date-time として表現される形式の文字列を
返します。

@return 以下の形式の文字列を返します。
//emlist{
day-of-week, DD month-name CCYY hh:mm:ss zone
//}
ただし zone は [+-]hhmm です。
self が UTC time の場合、zone は +0...
...000 になります。

使用例
require 'time'

iso8601_time = '2008-08-31T12:34:56+09:00'
t = Time.iso8601(iso8601_time)
p t.rfc2822 #=> "Sun, 31 Aug 2008 03:34:56 -0000"...

Time#rfc822 -> String (18304.0)

2822 で定義されている date-time として表現される形式の文字列を 返します。

...されている date-time として表現される形式の文字列を
返します。

@return 以下の形式の文字列を返します。
//emlist{
day-of-week, DD month-name CCYY hh:mm:ss zone
//}
ただし zone は [+-]hhmm です。
self が UTC time の場合、zone は +0...
...000 になります。

使用例
require 'time'

iso8601_time = '2008-08-31T12:34:56+09:00'
t = Time.iso8601(iso8601_time)
p t.rfc2822 #=> "Sun, 31 Aug 2008 03:34:56 -0000"...

絞り込み条件を変える

Time#sec -> Integer (18304.0)

秒を整数で返します。

...秒を整数で返します。

//emlist[][ruby]{
p Time.mktime(2000, 1, 1).sec # => 0
//}

通常は0から59を返しますが、うるう秒の場合は60を返します。

//emlist[][ruby]{
ENV['TZ'] = 'right/UTC'
p Time.mktime(2005, 12, 31, 23, 59, 60).sec # => 60
//}...

Time#tv_nsec -> Integer (18304.0)

時刻のナノ秒の部分を整数で返します。

...部分を整数で返します。

//emlist[][ruby]{
t = Time.local(2000,1,2,3,4,5,6)
p "%10.9f" % t.to_f # => "946749845.000005960"
p t.nsec # => 6000
//}

IEEE 754 浮動小数点数で表現できる精度が違うため、Time#to_fの最小
の桁とnsecの最小の桁は異なり...

Time#tv_usec -> Integer (18304.0)

時刻のマイクロ秒の部分を整数で返します。

...時刻のマイクロ秒の部分を整数で返します。

//emlist[][ruby]{
t = Time.local(2000,1,2,3,4,5,6)
p "%10.6f" % t.to_f #=> "946749845.000006"
p t.usec #=> 6
//}...

Time#usec -> Integer (18304.0)

時刻のマイクロ秒の部分を整数で返します。

...時刻のマイクロ秒の部分を整数で返します。

//emlist[][ruby]{
t = Time.local(2000,1,2,3,4,5,6)
p "%10.6f" % t.to_f #=> "946749845.000006"
p t.usec #=> 6
//}...

Time.json_create(hash) -> Time (18304.0)

JSON のオブジェクトから Ruby のオブジェクトを生成して返します。

JSON のオブジェクトから Ruby のオブジェクトを生成して返します。

@param hash 適切なキーを持つハッシュを指定します。

絞り込み条件を変える

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

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

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

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

@param...
...定します。

@param wday 無視されます。

@param yday 無視されます。

@param isdst 指定した日時が夏時間(Daylight Saving Time)なら true を指定します。
そうでないなら、false を指定します。

@param zone 無視されます。

@raise Argume...

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

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

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

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

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

@p...
...字列で指定します。(60はうるう秒)

@param usec マイクロ秒を整数か文字列で指定します。

@raise ArgumentError 与えられた引数の範囲が valid でない場合に発生します。

//emlist[][ruby]{
p Time.local(2000, 1, 1) # => 2000-01-01 00:00:00 +0900
//}...

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

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

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

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

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

@p...
...字列で指定します。(60はうるう秒)

@param usec マイクロ秒を整数か文字列で指定します。

@raise ArgumentError 与えられた引数の範囲が valid でない場合に発生します。

//emlist[][ruby]{
p Time.local(2000, 1, 1) # => 2000-01-01 00:00:00 +0900
//}...

Time.xmlschema(date) -> Time (9424.0)

XML Schema で定義されている dateTime として date をパースして Time オブジェクトに変換します。

...いる dateTime として
date をパースして Time オブジェクトに変換します。

date がISO 8601で定義されている形式に準拠していない、
または Time クラスが指定された日時を表現できないときに
ArgumentError が発生します。

Time
オブジ...
...ェクトを ISO8601 形式の文字列にフォーマットする
インスタンスメソッド Time#iso8601, Time#xmlschema もあります。

@param date XML Schema で定義されている dateTime として
パースされる文字列を指定します。

@raise ArgumentError dat...
...または Time クラスが指定された日時を表現できないとき
に発生します。
使用例
require 'time'

iso8601_time = '2008-08-31T12:34:56+09:00'
t = Time.iso8601(iso8601_time)
p t #=> 2008-08-31 12:34:56 +0900
p t.kind_of?(Time) #=> true...

Time#getutc -> Time (9304.0)

タイムゾーンを協定世界時に設定した Time オブジェクトを新しく 生成して返します。

...タイムゾーンを協定世界時に設定した Time オブジェクトを新しく
生成して返します。

//emlist[][ruby]{
p t = Time.local(2000,1,1,20,15,1) #=> 2000-01-01 20:15:01 +0900
p t.gmt? #=> false
p y = t.getgm #=> 2000-01-0...

絞り込み条件を変える

Time#tv_sec -> Integer (9304.0)

起算時からの経過秒数を整数で返します。

...起算時からの経過秒数を整数で返します。

//emlist[][ruby]{
t = Time.local(2000,1,2,3,4,5,6)
p t # => 2000-01-02 03:04:05 +0900
p "%10.6f" % t.to_f # => "946749845.000006"
p t.to_i # => 946749845
p t.tv_sec # => 946749845
//}...

Time#utc -> self (9304.0)

タイムゾーンを協定世界時に設定します。

...のメソッドを呼び出した後は時刻変換を協定世界時として行ないます。

Time
#localtime, Time#gmtime の挙動はシステムの
localtime(3) の挙動に依存します。Time クラ
スでは時刻を起算時からの経過秒数として保持していますが、ある...
...ます。システムを越えて Time オブジェクトを受け
渡す場合には注意する必要があります。

//emlist[][ruby]{
p t = Time.local(2000,1,1,20,15,1) # => 2000-01-01 20:15:01 +0900
p t.gmt? # => false
p t.gmtime # => 2...

Time#utc? -> bool (9304.0)

self のタイムゾーンが協定世界時に設定されていれば真を返します。

...self のタイムゾーンが協定世界時に設定されていれば真を返します。

//emlist[][ruby]{
p t = Time.local(2017,9,19,15,0,0) # => 2017-09-19 15:00:00 +0900
p t.utc? # => false
p utc_t = t.getutc # => 2017-09-19 06:00:00 UTC
p utc...

Time#utc_offset -> Integer (9304.0)

協定世界時との時差を秒を単位とする数値として返します。

...時の場合][ruby]{
p Time.now.zone # => "JST"
p Time.now.utc_offset # => 32400
//}

タイムゾーンが協定世界時に設定されている場合は 0 を返します。

//emlist[協定世界時の場合][ruby]{
p Time.now.getgm.zone # => "UTC"
p Time.now.getgm.utc_offset # =...

Time#xmlschema(fractional_seconds = 0) -> String (9304.0)

XML Schema で定義されている dateTime として 表現される形式の文字列を返します。

...ML Schema で定義されている dateTime として
表現される形式の文字列を返します。

XML Schema で定義されている dateTime として
表現される形式の文字列をパースするためのクラスメソッド
Time
.iso8601, Time.xmlschema もあります。

@param...
...ただし TZD は Z または [+-]hh:mm です。

使用例
require 'time'

iso8601_time = '2008-08-31T12:34:56+09:00'
t = Time.iso8601(iso8601_time)
p t.xmlschema #=> "2008-08-31T03:34:56Z"
p t.xmlschema(9) #=> "2008-08-31T03:34:56.000000000Z"

@see Time.iso8601, Time.xmlschema...

絞り込み条件を変える

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

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

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

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

@param...
...定します。

@param wday 無視されます。

@param yday 無視されます。

@param isdst 指定した日時が夏時間(Daylight Saving Time)なら true を指定します。
そうでないなら、false を指定します。

@param zone 無視されます。

@raise Argume...

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

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

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

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

@...
...定します。

@param wday 無視されます。

@param yday 無視されます。

@param isdst 指定した日時が夏時間(Daylight Saving Time)なら true を指定します。
そうでないなら、false を指定します。

@param zone 無視されます。

@raise Argume...

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

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

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

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

@param year 年を整数か文字列で指定します。例えば 1998 年に対して 1998 を指定します...
...か文字列で指定します。(60はうるう秒)

@param usec マイクロ秒を整数か文字列で指定します。

@raise ArgumentError 与えられた引数の範囲が valid でない場合に発生します。

//emlist[][ruby]{
p Time.gm(2000, 1, 1) # => 2000-01-01 00:00:00 UTC
//}...

Time.at(seconds, xseconds, unit) -> Time (703.0)

unit に応じて seconds + xseconds ミリ秒などの時刻を表す Time オブジェクトを返します。

...unit に応じて seconds + xseconds ミリ秒などの時刻を表す Time オブジェクトを返します。

@param seconds 起算時からの経過秒数を表わす値をInteger、 Float、 Rational、または他のNumericで指定します。
@param xseconds unit に対応するミリ秒...
...ゾーンを指定します。

//emlist[][ruby]{
Time
.at(946684800, 123.456789, :millisecond).nsec # => 123456789
Time
.at(946684800, 123456.789, :usec).nsec # => 123456789
Time
.at(946684800, 123456.789, :microsecond).nsec # => 123456789
Time
.at(946684800, 123456789, :nsec).nsec #...

Time.at(seconds, xseconds, unit, in:) -> Time (703.0)

unit に応じて seconds + xseconds ミリ秒などの時刻を表す Time オブジェクトを返します。

...unit に応じて seconds + xseconds ミリ秒などの時刻を表す Time オブジェクトを返します。

@param seconds 起算時からの経過秒数を表わす値をInteger、 Float、 Rational、または他のNumericで指定します。
@param xseconds unit に対応するミリ秒...
...ゾーンを指定します。

//emlist[][ruby]{
Time
.at(946684800, 123.456789, :millisecond).nsec # => 123456789
Time
.at(946684800, 123456.789, :usec).nsec # => 123456789
Time
.at(946684800, 123456.789, :microsecond).nsec # => 123456789
Time
.at(946684800, 123456789, :nsec).nsec #...

絞り込み条件を変える

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

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

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

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

@param year 年を整数か文字列で指定します。例えば 1998 年に対して 1998 を指定します...
...か文字列で指定します。(60はうるう秒)

@param usec マイクロ秒を整数か文字列で指定します。

@raise ArgumentError 与えられた引数の範囲が valid でない場合に発生します。

//emlist[][ruby]{
p Time.gm(2000, 1, 1) # => 2000-01-01 00:00:00 UTC
//}...

Time.at(time, usec) -> Time (463.0)

time + (usec/1000000) の時刻を表す Time オブジェクトを返します。 浮動小数点の精度では不十分な場合に使用します。

...
time
+ (usec/1000000) の時刻を表す Time オブジェクトを返します。
浮動小数点の精度では不十分な場合に使用します。

キーワード引数 in でタイムゾーンを指定できます。タイムゾーンの指定がない場合、
生成された Time オブ...
...ジェクトのタイムゾーンは地方時となります。

@param time 起算時からの経過秒数を表わす値をInteger、 Float、 Rational、または他のNumericで指定します。

@param usec マイクロ秒をInteger、 Float、 Rational、または他のNumericで指定しま...
...す。

@param in "+HH:MM" や "-HH:MM" のような形式の文字列か
"UTC" かミリタリータイムゾーンの文字列または
数値でタイムゾーンを指定します。

//emlist[][ruby]{
Time
.at(946684800, 123456.789).nsec # => 123456789
//}...

Time.at(time, usec, in:) -> Time (463.0)

time + (usec/1000000) の時刻を表す Time オブジェクトを返します。 浮動小数点の精度では不十分な場合に使用します。

...
time
+ (usec/1000000) の時刻を表す Time オブジェクトを返します。
浮動小数点の精度では不十分な場合に使用します。

キーワード引数 in でタイムゾーンを指定できます。タイムゾーンの指定がない場合、
生成された Time オブ...
...ジェクトのタイムゾーンは地方時となります。

@param time 起算時からの経過秒数を表わす値をInteger、 Float、 Rational、または他のNumericで指定します。

@param usec マイクロ秒をInteger、 Float、 Rational、または他のNumericで指定しま...
...す。

@param in "+HH:MM" や "-HH:MM" のような形式の文字列か
"UTC" かミリタリータイムゾーンの文字列または
数値でタイムゾーンを指定します。

//emlist[][ruby]{
Time
.at(946684800, 123456.789).nsec # => 123456789
//}...

Time#-(sec) -> Time (307.0)

自身より sec 秒だけ前の時刻を返します。

...自身より sec 秒だけ前の時刻を返します。

@param sec 実数を秒を単位として指定します。

//emlist[][ruby]{
p t = Time.local(2000) # => 2000-01-01 00:00:00 +0900
p t2 = t + 2592000 # => 2000-01-31 00:00:00 +0900
p t2 - 2592000 # => 2000-01-01 00:00:00 +09...

Time#iso8601(fractional_seconds = 0) -> String (304.0)

XML Schema で定義されている dateTime として 表現される形式の文字列を返します。

...ML Schema で定義されている dateTime として
表現される形式の文字列を返します。

XML Schema で定義されている dateTime として
表現される形式の文字列をパースするためのクラスメソッド
Time
.iso8601, Time.xmlschema もあります。

@param...
...ただし TZD は Z または [+-]hh:mm です。

使用例
require 'time'

iso8601_time = '2008-08-31T12:34:56+09:00'
t = Time.iso8601(iso8601_time)
p t.xmlschema #=> "2008-08-31T03:34:56Z"
p t.xmlschema(9) #=> "2008-08-31T03:34:56.000000000Z"

@see Time.iso8601, Time.xmlschema...

絞り込み条件を変える

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

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

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

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

@...
...定します。

@param wday 無視されます。

@param yday 無視されます。

@param isdst 指定した日時が夏時間(Daylight Saving Time)なら true を指定します。
そうでないなら、false を指定します。

@param zone 無視されます。

@raise Argume...

Time.new(year, mon = nil, day = nil, hour = nil, min = nil, sec = nil, in: nil) -> Time (304.0)

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

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

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

@param year...
...列で指定します。

@raise ArgumentError 与えられた引数が無効である場合に発生します。
@raise ArgumentError zone と in を同時に指定した場合に発生します。

//emlist[][ruby]{
p Time.new(2008, 6, 21, 13, 30, 0, "+09:00") # => 2008-06-21 13:30:00 +0900
//}...

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

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

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

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

@param year...
...列で指定します。

@raise ArgumentError 与えられた引数が無効である場合に発生します。
@raise ArgumentError zone と in を同時に指定した場合に発生します。

//emlist[][ruby]{
p Time.new(2008, 6, 21, 13, 30, 0, "+09:00") # => 2008-06-21 13:30:00 +0900
//}...

Time.iso8601(date) -> Time (124.0)

XML Schema で定義されている dateTime として date をパースして Time オブジェクトに変換します。

...いる dateTime として
date をパースして Time オブジェクトに変換します。

date がISO 8601で定義されている形式に準拠していない、
または Time クラスが指定された日時を表現できないときに
ArgumentError が発生します。

Time
オブジ...
...ェクトを ISO8601 形式の文字列にフォーマットする
インスタンスメソッド Time#iso8601, Time#xmlschema もあります。

@param date XML Schema で定義されている dateTime として
パースされる文字列を指定します。

@raise ArgumentError dat...
...または Time クラスが指定された日時を表現できないとき
に発生します。
使用例
require 'time'

iso8601_time = '2008-08-31T12:34:56+09:00'
t = Time.iso8601(iso8601_time)
p t #=> 2008-08-31 12:34:56 +0900
p t.kind_of?(Time) #=> true...

Time.httpdate(date) -> Time (106.0)

2616で定義されているHTTP-dateとしてdateをパースして Timeオブジェクトに変換します。

...2616で定義されているHTTP-dateとしてdateをパースして
Time
オブジェクトに変換します。

dateが2616に準拠していない、または
Time
クラスが指定された日時を表現できないときにArgumentErrorが
発生します。

@param date 2616で定義され...
...たは Timeクラスが指定された日時を表現できないときに発生します。

require 'time'
rfc2616_time = 'Sun, 31 Aug 2008 12:34:56 GMT'

t = Time.httpdate(rfc2616_time)
p t.kind_of?(Time) #=> true

non_rfc2616_time = 'San, 31 Aug 2008 12:34:56 GMT'
begin
Time
.http...
...date(non_rfc2616_time)
rescue ArgumentError => err
puts err #=> not RFC 2616 compliant date: "San, 31 Aug 2008 12:34:56 GMT"
end...

絞り込み条件を変える

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

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

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

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

与えられ...
...当要素が使われます。

require 'time'
time
= Time.local(2019, 5, 1)
Time
.parse("12:00", time) #=> 2019-05-01 12:00:00 +0900

下位の要素がなかったり壊れていた場合、最小値(1か0)が使われます。

@param date Time オブジェクトに変換可能な文字列...
...を指定します。
@param now 現在時刻をTime オブジェクトで指定します。
デフォルトはTime.nowとなります。

@raise ArgumentError dateに空文字列を与えた場合、発生します。
なお、1.9.2より前は例外は発生せず...

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

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

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

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

与えられ...
...当要素が使われます。

require 'time'
time
= Time.local(2019, 5, 1)
Time
.parse("12:00", time) #=> 2019-05-01 12:00:00 +0900

下位の要素がなかったり壊れていた場合、最小値(1か0)が使われます。

@param date Time オブジェクトに変換可能な文字列...
...を指定します。
@param now 現在時刻をTime オブジェクトで指定します。
デフォルトはTime.nowとなります。

@raise ArgumentError dateに空文字列を与えた場合、発生します。
なお、1.9.2より前は例外は発生せず...

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

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

...または午後(am,pm)
* %p: 午前または午後(AM,PM)
* %Q: 1970-01-01 00:00:00 UTC からの経過ミリ秒 (Time#strftime は対応していませんが、Date#strftime で使えます)
* %R: 24時間制の時刻。%H:%M と同等。
* %r: 12時間制の時刻。%I:%M:%S %p と同等...
...セット (例 +09:00:00)
* %%: %自身
* %+: date(1)の形式 (%a %b %e %H:%M:%S %Z %Y) (Time#strftime は対応していませんが、Date#strftime で使えます)

このメソッドは strftime(3) や glibcの仕様を参考に作成されており、以下のオプションが利用でき...
...uby]{
p t = Time.new(2001,2,3,4,5,6,"+09:00") # => 2001-02-03 04:05:06 +0900
p t.strftime("Printed on %m/%d/%Y") # => "Printed on 02/03/2001"
p t.strftime("Printed on %m/%-d/%_6Y") # => "Printed on 02/3/ 2001"
p t.strftime("at %I:%M%p") # => "at 04:05AM"
p t.strftime("at %I:%M...

Time.at(time) -> Time (58.0)

time で指定した時刻の Time オブジェクトを返します。

...
time
で指定した時刻の Time オブジェクトを返します。

キーワード引数 in でタイムゾーンを指定できます。タイムゾーンの指定がなく
引数が数値の場合、生成された Time オブジェクトのタイムゾーンは地方時となります。...
...@param time Time オブジェクト、もしくは起算時からの経過秒数を表わす数値で指定します。
@param in "+HH:MM" や "-HH:MM" のような形式の文字列か
"UTC" かミリタリータイムゾーンの文字列または
数値でタイムゾーンを...
...y]{
Time
.at(0) # => 1970-01-01 09:00:00 +0900
Time
.at(Time.at(0)) # => 1970-01-01 09:00:00 +0900
Time
.at(Time.at(0).getutc) # => 1970-01-01 00:00:00 UTC
Time
.at(946702800) # => 2000-01-01 14:00:00 +0900
Time
.a...

Time.at(time, in:) -> Time (58.0)

time で指定した時刻の Time オブジェクトを返します。

...
time
で指定した時刻の Time オブジェクトを返します。

キーワード引数 in でタイムゾーンを指定できます。タイムゾーンの指定がなく
引数が数値の場合、生成された Time オブジェクトのタイムゾーンは地方時となります。...
...@param time Time オブジェクト、もしくは起算時からの経過秒数を表わす数値で指定します。
@param in "+HH:MM" や "-HH:MM" のような形式の文字列か
"UTC" かミリタリータイムゾーンの文字列または
数値でタイムゾーンを...
...y]{
Time
.at(0) # => 1970-01-01 09:00:00 +0900
Time
.at(Time.at(0)) # => 1970-01-01 09:00:00 +0900
Time
.at(Time.at(0).getutc) # => 1970-01-01 00:00:00 UTC
Time
.at(946702800) # => 2000-01-01 14:00:00 +0900
Time
.a...

絞り込み条件を変える

Time#-(time) -> Float (52.0)

自身と time との時刻の差を Float で返します。単位は秒です。

...自身と time との時刻の差を Float で返します。単位は秒です。

@param time 自身との差を算出したい Time オブジェクトを指定します。

//emlist[][ruby]{
p t = Time.local(2000) # => 2000-01-01 00:00:00 +0900
p t2 = t + 2592000 # => 2000-01-31 00:00:00 +...

Time#floor(ndigits=0) -> Time (52.0)

十進小数点数で指定した桁数の精度で切り捨てをし、 その Time オブジェクトを返します。 (デフォルトは0、つまり小数点の所で切り捨てます)。

...捨てをし、
その Time オブジェクトを返します。
(デフォルトは0、つまり小数点の所で切り捨てます)。

ndigits には 0 以上の整数を渡します。

@param ndigits 十進での精度(桁数)

//emlist[][ruby]{
require 'time'

t = Time.utc(2010,3,30, 5,43,25....
..."

t = Time.utc(1999,12,31, 23,59,59)
(t + 0.4).floor.iso8601(3) # => "1999-12-31T23:59:59.000Z"
(t + 0.9).floor.iso8601(3) # => "1999-12-31T23:59:59.000Z"
(t + 1.4).floor.iso8601(3) # => "2000-01-01T00:00:00.000Z"
(t + 1.9).floor.iso8601(3) # => "2000-01-01T00:00:00.000Z"

t = Time.utc(...
...1999,12,31, 23,59,59)
(t + 0.123456789).floor(4).iso8601(6) # => "1999-12-31T23:59:59.123400Z"
//}

@see Time#ceil, Time#round...

Time#round(ndigits=0) -> Time (52.0)

十進小数点数で指定した桁数の精度で丸めをし、 その Time オブジェクトを返します。 (デフォルトは0、つまり小数点の所で丸めます)。

...で丸めをし、
その Time オブジェクトを返します。
(デフォルトは0、つまり小数点の所で丸めます)。

ndigits には 0 以上の整数を渡します。

@param ndigits 十進での精度(桁数)

//emlist[][ruby]{
require 'time'

t = Time.utc(1999,12,31, 23,59,59)...
...000-01-01T00:00:00.000Z"
p((t + 1.49).round.iso8601(3)) # => "2000-01-01T00:00:00.000Z"
p((t + 1.5).round.iso8601(3)) # => "2000-01-01T00:00:01.000Z"

t = Time.utc(1999,12,31, 23,59,59)
p (t + 0.123456789).round(4).iso8601(6) # => "1999-12-31T23:59:59.123500Z"
//}

@see Time#ceil, Time#floor...

Time#to_date -> Date (52.0)

対応する Date オブジェクトを返します。

対応する Date オブジェクトを返します。

Time#to_datetime -> DateTime (52.0)

対応する DateTime オブジェクトを返します。

...対応する DateTime オブジェクトを返します。...

絞り込み条件を変える

Time#to_time -> Time (52.0)

対応する Time オブジェクトを返します。

...対応する Time オブジェクトを返します。...

Time.strptime(date, format, now=self.now) -> Time (52.0)

文字列を Date._strptime を用いて Time オブジェクト に変換します。

...time を用いて Time オブジェクト
に変換します。

require 'time'
Time
.strptime('2001-02-03T04:05:06+09:00', '%Y-%m-%dT%H:%M:%S%z')
#=> 2001-02-03 06:05:06 +0900

ブロックを渡すと年の部分をブロックによって変換できます。
require 'time'
Time
.strptime...
...end
}
#=> 1991-05-18 04:13:00 +0900

Time
.strptime('01/5/18 4:13:00', '%Y/%m/%d %T'){|y|
if y > 100 then y
elsif y >= 69 then y + 1900
else y + 2000
end
}
#=> 2001-05-18 04:13:00 +0900

詳しくは DateTime.strptime, Date.strptime を見てください。

@param date...

Time.strptime(date, format, now=self.now) {|y| ... } -> Time (52.0)

文字列を Date._strptime を用いて Time オブジェクト に変換します。

...time を用いて Time オブジェクト
に変換します。

require 'time'
Time
.strptime('2001-02-03T04:05:06+09:00', '%Y-%m-%dT%H:%M:%S%z')
#=> 2001-02-03 06:05:06 +0900

ブロックを渡すと年の部分をブロックによって変換できます。
require 'time'
Time
.strptime...
...end
}
#=> 1991-05-18 04:13:00 +0900

Time
.strptime('01/5/18 4:13:00', '%Y/%m/%d %T'){|y|
if y > 100 then y
elsif y >= 69 then y + 1900
else y + 2000
end
}
#=> 2001-05-18 04:13:00 +0900

詳しくは DateTime.strptime, Date.strptime を見てください。

@param date...

Time#to_a -> Array (40.0)

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

...内通算日 (整数 1-366)
* isdst: 夏時間であるかどうか (true/false)
* zone: タイムゾーン (文字列)

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

要素の順序は C...