How to Find Difference Between Dates in Ruby: Simple Comparison

In Ruby, you can find the difference between two dates by subtracting one Date object from another, which returns the difference in days as a Rational number. For time differences including hours, minutes, and seconds, subtract Time objects to get the difference in seconds as a Float.

Quick Comparison

This table shows the key differences between using Date and Time classes in Ruby to find date differences.

Aspect	Date Class	Time Class
Type of objects	Date objects (year, month, day)	Time objects (year, month, day, hour, min, sec)
Difference unit	Days (as Rational number)	Seconds (as Float)
Precision	Day-level precision	Second-level precision
Requires	require 'date' to use Date class	Built-in, no extra require needed
Use case	Calculate days between dates	Calculate exact time intervals
Example output	2 (days)	172800.0 (seconds)

Key Differences

The Date class in Ruby is designed to handle calendar dates without time information. When you subtract one Date object from another, Ruby returns the difference as a Rational number representing the number of days between the two dates. This is useful when you only care about whole or fractional days.

On the other hand, the Time class includes hours, minutes, and seconds. Subtracting two Time objects returns the difference in seconds as a Float. This allows you to measure precise time intervals, including hours and minutes, not just days.

Also, Date requires you to require 'date' before use, while Time is built into Ruby and ready to use. Choose Date for simple day differences and Time for detailed time differences.

Code Comparison

Here is how you find the difference between two dates using the Date class in Ruby.

ruby

require 'date'
date1 = Date.new(2024, 4, 20)
date2 = Date.new(2024, 4, 22)
difference = date2 - date1
puts difference

Output

2

Time Class Equivalent

Here is how you find the difference between two times using the Time class in Ruby.

ruby

time1 = Time.new(2024, 4, 20, 12, 0, 0)
time2 = Time.new(2024, 4, 22, 12, 0, 0)
difference = time2 - time1
puts difference

Output

172800.0

When to Use Which

Choose the Date class when you only need to know how many days separate two dates, such as calculating age in days or days until an event. It is simpler and focuses on calendar dates.

Choose the Time class when you need precise differences including hours, minutes, and seconds, such as measuring elapsed time or scheduling tasks. It provides more detailed time information.

Key Takeaways

Use Date subtraction to get the difference in days as a Rational number.

Use Time subtraction to get the difference in seconds as a Float.

Require 'date' library to use the Date class, but Time is built-in.

Choose Date for day-level differences and Time for precise time intervals.

Subtracting Date objects returns days; subtracting Time objects returns seconds.