1 files changed, 14 insertions, 0 deletions
diff --git a/activesupport/lib/active_support/core_ext/date/calculations.rb b/activesupport/lib/active_support/core_ext/date/calculations.rb
index b104e5271a..c522256aea 100644
--- a/activesupport/lib/active_support/core_ext/date/calculations.rb
+++ b/activesupport/lib/active_support/core_ext/date/calculations.rb
@@ -38,6 +38,20 @@ module ActiveSupport #:nodoc:
             d = d + options.delete(:days) if options[:days]
             d
           end
+
+          # Returns a new Date where one or more of the elements have been changed according to the +options+ parameter.
+          #
+          # Examples:
+          #
+          #   Date.new(2007, 5, 12).change(:day => 1)                  # => Date.new(2007, 5, 12)
+          #   Date.new(2007, 5, 12).change(:year => 2005, :month => 1) # => Date.new(2005, 1, 12)
+          def change(options)
+            ::Date.new(
+              options[:year]  || self.year,
+              options[:month] || self.month,
+              options[:day]   || options[:mday] || self.day # mday is deprecated
+            )
+          end
         end
       end
     end