Ticket #7164: docs_for_time_conversions.diff

core_ext/time/conversions.rb

@@ -19 +19 @@
-          klass.send(:alias_method, :to_s, :to_formatted_s)
-        end
-        
+        # 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.
+        #
+        # examples: 
+        #
+        #   time = Time.now                  # => Thu Jan 18 06:10:17 CST 2007
+        #   time.to_formatted_s(:time)       # => "Thu Jan 18 06:10:17 CST 2007"
+        #   time.to_formatted_s(:db)         # => "2007-01-18 06:10:17"
+        #   time.to_formatted_s(:short)      # => "18 Jan 06:10"</tt>
+        #   time.to_formatted_s(:long)       # => "January 18, 2007 06:10"
+        #   time.to_formatted_s(:rfc822)     # => "Thu, 18 Jan 2007 06:10:17 -0600"
-        def to_formatted_s(format = :default)
-          DATE_FORMATS[format] ? strftime(DATE_FORMATS[format]).strip : to_default_s          
-        end
-
+        # Convert a Time object to a Date - this drops hour, minute, and second precision.
-        def to_date
-          ::Date.new(year, month, day)
-        end