Ruby 2.5.0 リファレンスマニュアル > ライブラリ一覧 > dateライブラリ > Dateクラス
クラス・モジュールの継承リスト: Date < Comparable < Object < Kernel < BasicObject
日付だけでなく時刻も扱える Time も利用できます。
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日 (グレゴリオ暦) 正子/零時 (協定世界時) を暦元とした通日 (経過日数) です。
この文書で、天文学的な修正ユリウス日とは、本来の修正ユリウス日と同じものです。また、年代学的な修正ユリウス日とは、地方時における零時を一日の始まりとする流儀です。
この文書で、単に「修正ユリウス日」といった場合、それは本来の修正ユリウス日でなく、「年代学的な修正ユリウス日」を意味しています。
定義 | 説明 | |
---|---|---|
self + n -> Date
|
self から n 日後の日付オブジェクトを返します。 n は数値でなければなりません。 |
|
self - x -> Rational | Date
|
x が日付オブジェクトなら、ふたつの差を Rational で返します。単位は日です。あるいは x が数値ならば、self より x 日前の日付を返します。 |
|
self << n -> Date
|
self より n ヶ月前の日付オブジェクトを返します。 n は数値でなければなりません。 |
|
self <=> other -> -1 | 0 | 1 | nil
|
二つの日付を比較します。同じ日付なら 0 を、self が other よりあとの日付なら 1 を、その逆なら -1 を返します。 |
|
self === other -> bool
|
同じ日なら真を返します。 |
|
self >> n -> Date
|
self から n ヶ月後の日付オブジェクトを返します。 n は数値でなければなりません。 |
|
ajd -> Rational
|
このメソッドは Date#jd と似ていますが、天文学的なユリウス日を返します。時刻を含みます。 |
|
amjd -> Rational
|
このメソッドは Date#mjd と似ていますが、天文学的な修正ユリウス日を返します。時刻を含みます。 |
|
asctime -> String
|
asctime(3) 書式の文字列を返します (ただし、末尾の "\n\0" は除く)。 |
|
cwday -> Integer
|
暦週の日 (曜日) を返します (1-7、月曜は1)。 |
|
cweek -> Integer
|
暦週を返します (1-53)。 |
|
cwyear -> Integer
|
暦週における年を返します。 |
|
mday -> Integer
|
月の日を返します (1-31)。 |
|
downto(min) {|date| ...} -> self
|
このメソッドは、step(min, -1){|date| ...} と等価です。 |
|
england -> Date
|
このメソッドは、new_start(Date::ENGLAND) と等価です。 |
|
friday? -> bool
|
金曜日なら真を返します。 |
|
gregorian -> Date
|
このメソッドは、new_start(Date::GREGORIAN) と等価です。 |
|
gregorian? -> bool
|
グレゴリオ暦なら真を返します。 |
|
httpdate -> String
|
||
iso8601 -> String
|
[[ISO:8601]] 書式の文字列を返します (拡大表記はつかいません)。 |
|
italy -> Date
|
このメソッドは、new_start(Date::ITALY) と等価です。 |
|
jd -> Integer
|
ユリウス日を返します。時刻を含みません。 |
|
jisx0301 -> String
|
[[JIS:X 0301]] 書式の文字列を返します。ただし、明治以前については [[ISO:8601]] 書式になります。なお、明治6年以前についても太陰太陽暦を使用することはありません。 |
|
julian -> Date
|
このメソッドは、new_start(Date::JULIAN) と等価です。 |
|
julian? -> bool
|
ユリウス暦なら真を返します。 |
|
ld -> Integer
|
リリウス日を返します。 |
|
leap? -> bool
|
閏年なら真を返します。 |
|
mjd -> Integer
|
修正ユリウス日を返します。時刻の情報を含みません。 |
|
mon -> Integer
|
月を返します (1-12)。 |
|
monday? -> bool
|
月曜日なら真を返します。 |
|
new_start(start = Date::ITALY) -> Date
|
self を複製して、その改暦日を設定しなおします。引数を省略した場合は、Date::ITALY (1582年10月15日) になります。 |
|
succ -> Date
|
翌日の日付オブジェクトを返します。 |
|
next_day(n = 1) -> Date
|
n 日後を返します。 |
|
next_month(n = 1) -> Date
|
n ヶ月後を返します。 |
|
next_year(n = 1) -> Date
|
n 年後を返します。 |
|
prev_day(n = 1) -> Date
|
n 日前を返します。 |
|
prev_month(n = 1) -> Date
|
n ヶ月前を返します。 |
|
prev_year(n = 1) -> Date
|
n 年前を返します。 |
|
rfc2822 -> String
|
[RFC2822] で定められた書式の文字列を返します。 |
|
saturday? -> bool
|
土曜日なら真を返します。 |
|
start -> Integer
|
改暦日をあらわすユリウス日を返します。 |
|
step(limit, step = 1) {|date| ...} -> self
|
ブロックの評価を繰り返します。ブロックは日付オブジェクトをとります。 limit は日付オブジェクトでなければなりません、また step は非零でなければなりません。 |
|
strftime(format = '%F') -> String
|
与えられた雛型で日付を書式づけます。 |
|
sunday? -> bool
|
日曜日なら真を返します。 |
|
thursday? -> bool
|
木曜日なら真を返します。 |
|
to_date -> Date
|
対応する Date オブジェクトを返します。 |
|
to_datetime -> DateTime
|
対応する DateTime オブジェクトを返します。 |
|
to_s -> String
|
[[ISO:8601]] 書式の文字列を返します (拡大表記 ('%Y-%m-%d') を使います)。 |
|
to_time -> Time
|
対応する Time オブジェクトを返します。 |
|
tuesday? -> bool
|
火曜日なら真を返します。 |
|
upto(max) {|date| ...} -> self
|
このメソッドは、step(max, 1){|date| ...} と等価です。 |
|
wday -> Integer
|
曜日を返します (0-6、日曜日は零)。 |
|
wednesday? -> bool
|
水曜日なら真を返します。 |
|
xmlschema -> String
|
XML Scheme (date) による書式の文字列を返します。 |
|
yday -> Integer
|
年の日を返します (1-366)。 |
|
year -> Integer
|
年を返します。 |
定義 | 説明 | |
---|---|---|
ENGLAND -> Integer
|
英国がグレゴリオ暦をつかい始めた日 (1752年9月14日) をあらわすユリウス日です。この "ENGLAND" の名前は、旧い UNIX の cal(1) の記述に由来します。 |
|
GREGORIAN -> Date::Infinity
|
常にグレゴリオ暦であることを示します。改暦日は無限の過去にあると考えられます。 |
|
ITALY -> Integer
|
伊国がグレゴリオ暦をつかい始めた日 (1582年10月15日) をあらわすユリウス日です。 |
|
JULIAN -> Date::Infinity
|
常にユリウス暦であることを示します。改暦日は無限の未来にあると考えられます。 |
!
!=
__id__
__send__
instance_eval
instance_exec
method_missing
singleton_method_added
singleton_method_removed
singleton_method_undefined
<
<=
==
>
>=
between?
clamp
!~
=~
_dump
class
clone
define_singleton_method
display
enum_for
eql?
equal?
extend
freeze
frozen?
hash
initialize
initialize_copy
inspect
instance_of?
instance_variable_defined?
instance_variable_get
instance_variable_set
instance_variables
is_a?
itself
marshal_dump
marshal_load
method
methods
nil?
object_id
pretty_inspect
pretty_print
pretty_print_cycle
pretty_print_inspect
pretty_print_instance_variables
private_methods
protected_methods
psych_to_yaml
public_method
public_methods
public_send
remove_instance_variable
respond_to?
respond_to_missing?
send
singleton_class
singleton_method
singleton_methods
taint
tainted?
tap
to_a
to_ary
to_hash
to_int
to_io
to_proc
to_regexp
to_str
trust
untaint
untrust
untrusted?
yield_self
.yaml_tag
::ARGF
::ARGV
::DATA
::ENV
::FALSE
::NIL
::RUBY_COPYRIGHT
::RUBY_DESCRIPTION
::RUBY_ENGINE
::RUBY_ENGINE_VERSION
::RUBY_PATCHLEVEL
::RUBY_PLATFORM
::RUBY_RELEASE_DATE
::RUBY_REVISION
::RUBY_VERSION
::SCRIPT_LINES__
::STDERR
::STDIN
::STDOUT
::TOPLEVEL_BINDING
::TRUE
定義 | 説明 | ライブラリ |
---|---|---|
json_create(hash) -> Date
|
JSON のオブジェクトから Ruby のオブジェクトを生成して返します。 |
json/add/date |
to_json(*args) -> String
|
自身を JSON 形式の文字列に変換して返します。 |
json/add/date |