Ticket #7164: documentation_for_time_conversions.with_alias.r8258.2.diff

activesupport/lib/active_support/core_ext/time/conversions.rb

@@ -19 +19 @@
-          end
-        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.
+        #
+        # This method is also aliased as <tt>to_s</tt>.
+        #
+        # ==== 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"
-        def to_formatted_s(format = :default)
-          if formatter = DATE_FORMATS[format]
-            if formatter.respond_to?(:call)
@@ -31 +47 @@
-          end
-        end
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-        def to_date
-          ::Date.new(year, month, day)
-        end
-
-
+
+
-        def to_time
-          self
-        end
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-        def to_datetime
-          ::DateTime.civil(year, month, day, hour, min, sec, Rational(utc_offset, 86400))
-        end