module InactiveSupport::CoreExtensions::Time::Conversions

Getting times in different convenient string representations and other objects

Constants

DATE_FORMATS

Public Class Methods

included(base) click to toggle source
# File lib/inactive_support/core_ext/time/conversions.rb, line 15
def self.included(base)
  base.class_eval do
    unless instance_methods.include? "to_default_s"
      alias_method :to_default_s, :to_s
      alias_method :to_s, :to_formatted_s
    end
  end
end

Public Instance Methods

to_date() click to toggle source

Convert a Time object to a Date, dropping hour, minute, and second precision.

Examples

my_time = Time.now
# => Mon Nov 12 22:59:51 -0500 2007

my_time.to_date
#=> Mon, 12 Nov 2007

your_time = Time.parse("1/13/2009 1:13:03 P.M.")
# => Tue Jan 13 13:13:03 -0500 2009

your_time.to_date
# => Tue, 13 Jan 2009
# File lib/inactive_support/core_ext/time/conversions.rb, line 66
def to_date
  ::Date.new(year, month, day)
end
to_datetime() click to toggle source

Converts a Time instance to a Ruby DateTime instance, preserving UTC offset.

Examples

my_time = Time.now
# => Mon Nov 12 23:04:21 -0500 2007

my_time.to_datetime
# => Mon, 12 Nov 2007 23:04:21 -0500

your_time = Time.parse("1/13/2009 1:13:03 P.M.")
# => Tue Jan 13 13:13:03 -0500 2009

your_time.to_datetime
# => Tue, 13 Jan 2009 13:13:03 -0500
# File lib/inactive_support/core_ext/time/conversions.rb, line 90
def to_datetime
  ::DateTime.civil(year, month, day, hour, min, sec, Rational(utc_offset, 86400))
end
to_formatted_s(format = :default) click to toggle source

Convert to a formatted string - see DATE_FORMATS for predefined formats. You can also add your own formats to the DATE_FORMATS constant and use them with this method.

This method is also aliased as to_s.

Examples:

time = Time.now                     # => Thu Jan 18 06:10:17 CST 2007

time.to_formatted_s(:time)          # => "06:10:17"
time.to_s(:time)                    # => "06:10:17"

time.to_formatted_s(:db)            # => "2007-01-18 06:10:17"
time.to_formatted_s(:short)         # => "18 Jan 06:10"
time.to_formatted_s(:long)          # => "January 18, 2007 06:10"
time.to_formatted_s(:long_ordinal)  # => "January 18th, 2007 06:10"
time.to_formatted_s(:rfc822)        # => "Thu, 18 Jan 2007 06:10:17 -0600"
# File lib/inactive_support/core_ext/time/conversions.rb, line 40
def to_formatted_s(format = :default)
  if formatter = DATE_FORMATS[format]
    if formatter.respond_to?(:call)
      formatter.call(self).to_s
    else
      strftime(formatter)
    end
  else
    to_default_s
  end
end
to_time() click to toggle source

A method to keep Time, Date and DateTime instances interchangeable on conversions. In this case, it simply returns self.

# File lib/inactive_support/core_ext/time/conversions.rb, line 72
def to_time
  self
end