Changeset 8279

Timestamp:

12/05/07 06:24:39 (5 months ago)

Author:

nzkoz

Message:

Document Date conversions. Closes #10368 [chuyeow]

Files:

• trunk/activesupport/lib/active_support/core_ext/date/conversions.rb (modified) (2 diffs)

trunk/activesupport/lib/active_support/core_ext/date/conversions.rb

@@ -24 +24 @@
-        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:
+        #   date = Date.new(2007, 11, 10)       # => Sat, 10 Nov 2007
+        #
+        #   date.to_formatted_s(:db)            # => "2007-11-10"
+        #   date.to_s(:db)                      # => "2007-11-10"
+        #
+        #   date.to_formatted_s(:short)         # => "10 Nov"
+        #   date.to_formatted_s(:long)          # => "November 10, 2007"
+        #   date.to_formatted_s(:long_ordinal)  # => "November 10th, 2007"
+        #   date.to_formatted_s(:rfc822)        # => "10 Nov 2007"
-        def to_formatted_s(format = :default)
-          if formatter = DATE_FORMATS[format]
@@ -41 +56 @@
-        end
-
-
+
+
-        def to_date
-          self
-        end if RUBY_VERSION < '1.9'
-
-
-
+
+
+
+
+
+
+
+
+
+
-        def to_time(form = :local)
-          ::Time.send("#{form}_time", year, month, day)
-        end
-
-
+
+
+
+
+
+
+
-        def to_datetime
-          ::DateTime.civil(year, month, day, 0, 0, 0, 0)