Time

前 - 上 - 次 - 目次

Time

時刻オブジェクト．Time.nowは現在の時刻を返します．File#statの返すファイルのタイムスタンプはTimeオブジェクトです．

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

スーパークラス:

Object

インクルードしているモジュール:

Comparable

クラスメソッド:

now

現在時刻のTimeオブジェクトを返します．

at(time)

timeで指定した時刻のTimeオブジェクトを返します．timeはTimeオブジェクト，もしく起算時からの経過秒数を表わす整数か浮動小数点数です．

gm(year, month, day, hour, min, sec)

引数で指定した協定世界時のTimeオブジェクトを返します．第2引数以降は省略可能で，省略した場合の値はその引数がとり得る最小の値です．

monthは1(1月)から12(12月)の範囲の整数または英語の月名，または1から12までの数を表わす文字列で指定します．

引数の数がTime#to_aと全く同じ場合(こちらは秒が先頭に来る形式ですが)，その順序を正しく解釈します．

local(year, month, day, hour, min, sec)

mktime(year, month, day, hour, min, sec)

引数で指定したローカルタイムのTimeオブジェクトを返します．引数の扱いはgmと同じです．

times

自身のプロセスとその子プロセスが消費したユーザ/システムCPU 時間の積算を構造体として返します．

utime		# user time
stime		# system time
cutime		# user time of children
cstime		# system time of children

時間の単位は秒で，浮動小数点数で与えられます．詳細は `times(3)'を参照してください．

メソッド:

self + other

selfよりotherだけ後の時刻を返します

self - other

otherがTimeオブジェクトである時，ふたつの時刻の差を実数で返します．otherが数値である時にはselfよりotherだけ前の時刻を返します．

self <=> other

時刻の比較．otherはTimeオブジェクトか数値でなければなりません．数値の場合は起算時からの経過秒数とみなして比較します．

asctime

ctime

時刻を`asctime(3)'の形式の文字列に変換します．

to_s

時刻を`date(1)'のような形式の文字列に変換します．

gmtime

タイムゾーンを協定世界時に設定します．このメソッドを呼び出した後は時刻変換を協定世界時として行ないます．協定世界時を表示するためには以下のようにします．

print Time.now.gmtime, "\n"

gmtimeは自分自身を返します．

localtime

タイムゾーンをローカルタイムに設定します(デフォルト)．

localtime(gmtimeも)の挙動はシステムのlocaltime(3)の挙動に依存します． Timeクラスでは時刻を起算時からの経過秒数として保持していますが，ある特定の時刻までの経過秒は，システムがうるう秒を勘定するかどうかによって異なる場合があります．システムを越えてTime オブジェクトを受け渡す場合には注意する必要があります．

to_i

tv_sec