期間を表すRangeオブジェクトが便利

Rubyで日付・日時を扱うときはDateTimeなどのクラスを使いますよね。これらのインスタンスは不等号で大小を比較できるようになっています。

あるDateTimeインスタンスが指定した期間に含まれるか、というようなことを調べたいときはRubyのRangeクラスが使えます。というか、Rangeクラスにしておくと便利です。

 1s = DateTime.new(2014, 1, 1)
 2e = DateTime.now
 3
 4range = s..e
 5range.class # => Range
 6
 7date = DateTime.new(2014, 1, 10)
 8range.cover?(date) # => true
 9
10range.include?(date) # => TypeError
11
12range.cover?(DateTime.new(2013, 12, 30)) # => false

range.include?(date)とすると例外が発生するようです。日付のRangeに対してinclude?は使えません。そのかわりにcover?が使えます。用途としてはこちらで問題なし。

include?とcover?の違い

include?

引数となった値がRange内の要素と一致する場合にtrueとなります。

1range = "a".."c"
2
3range.include?("b") # => true
4range.include?("bb") # => false
5
6range.to_a # => ["a", "b", "c"] 

cover?

引数がRangeの両端の値の範囲ないにあればtrueとなります。

1range = "a".."c"
2
3range.cover?("b") # => true
4range.cover?("bb") # => true

range.cover?("bb")がtrueになるというのが特徴的です。

"bb"はrangeに含まれる要素（range.to_aに含まれる要素）ではありませんのでinclude?ではfalseが返りますが、cover?では"bb"を"a"、"c"と比較して"a" <= "bb" <= "c"になるかどうかを調べるのでtrueとなるわけです。