Module: ActiveRecord::Timestamp

Defined in:
lib/active_record/timestamp.rb

Overview

Active Record automatically timestamps create and update operations if the table has fields named created_at/created_on or updated_at/updated_on.

Timestamping can be turned off by setting

<tt>ActiveRecord::Base.record_timestamps = false</tt>

Timestamps are in the local timezone by default but you can use UTC by setting

<tt>ActiveRecord::Base.default_timezone = :utc</tt>

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object

:nodoc:



11
12
13
14
15
16
17
 
# File 'lib/active_record/timestamp.rb', line 11

def self.included(base) #:nodoc:
  base.alias_method_chain :create, :timestamps
  base.alias_method_chain :update, :timestamps

  base.class_inheritable_accessor :record_timestamps, :instance_writer => false
  base.record_timestamps = true
end

Instance Method Details

#touch(attribute = nil) ⇒ Object

Saves the record with the updated_at/on attributes set to the current time. If the save fails because of validation errors, an ActiveRecord::RecordInvalid exception is raised. If an attribute name is passed, that attribute is used for the touch instead of the updated_at/on attributes.

Examples:

product.touch               # updates updated_at
product.touch(:designed_at) # updates the designed_at attribute



27
28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/active_record/timestamp.rb', line 27

def touch(attribute = nil)
  current_time = current_time_from_proper_timezone

  if attribute
    write_attribute(attribute, current_time)
  else
    write_attribute('updated_at', current_time) if respond_to?(:updated_at)
    write_attribute('updated_on', current_time) if respond_to?(:updated_on)
  end

  save!
end