Module: InactiveSupport::CoreExtensions::Time::Conversions

Included in:
Time
Defined in:
lib/inactive_support/core_ext/time/conversions.rb

Overview

Getting times in different convenient string representations and other objects

Constant Summary collapse

DATE_FORMATS = 
{
  :db           => "%Y-%m-%d %H:%M:%S",
  :time         => "%H:%M",
  :short        => "%d %b %H:%M",
  :long         => "%B %d, %Y %H:%M",
  :long_ordinal => lambda { |time| time.strftime("%B #{time.day.ordinalize}, %Y %H:%M") },
  :rfc822       => "%a, %d %b %Y %H:%M:%S %z"
}

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object 



15
16
17
18
19
20
21
22
 
# 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

Instance Method Details

#to_date ⇒ Object

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



66
67
68
 
# File 'lib/inactive_support/core_ext/time/conversions.rb', line 66

def to_date
  ::Date.new(year, month, day)
end

#to_datetime ⇒ Object

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



90
91
92
 
# 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) ⇒ Object

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"



40
41
42
43
44
45
46
47
48
49
50
 
# 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 ⇒ Object

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



72
73
74
 
# File 'lib/inactive_support/core_ext/time/conversions.rb', line 72

def to_time
  self
end