require "time"

def p(value)
  puts value
end

# We'll start by getting the current time.
now = Time.utc
p now

# You can build a Time struct by providing the
# year, month, day, etc. Times are always associated
# with a Location, i.e. time zone.
then = Time.utc(2009, 11, 17, 20, 34, 58, nanosecond: 651387237)
p then

# You can extract the various components of the time
# value as expected.
p then.year
p then.month
p then.day
p then.hour
p then.minute
p then.second
p then.nanosecond
p then.location

# The Monday-Sunday day of week is also available.
p then.day_of_week

# These methods compare two times, testing if the
# first occurs before, after, or at the same time
# as the second, respectively.
p then < now
p then > now
p then == now

# The - operator returns a Time::Span representing
# the interval between two times.
diff = now - then
p diff

# We can compute the length of the duration in
# various units.
p diff.total_hours
p diff.total_minutes
p diff.total_seconds
p diff.total_nanoseconds

# You can use + to advance a time by a given
# duration, or with a - to move backwards by a
# duration.
p then + diff
p then - diff