module Sequel::Plugins::Timestamps

  1. lib/sequel/plugins/timestamps.rb

The timestamps plugin creates hooks that automatically set create and update timestamp fields. Both field names used are configurable, and you can also set whether to overwrite existing create timestamps (false by default), or whether to set the update timestamp when creating (also false by default).


# Timestamp all model instances using +created_at+ and +updated_at+
# (called before loading subclasses)
Sequel::Model.plugin :timestamps

# Timestamp Album instances, with custom column names
Album.plugin :timestamps, :create=>:created_on, :update=>:updated_on

# Timestamp Artist instances, forcing an overwrite of the create
# timestamp, and setting the update timestamp when creating
Album.plugin :timestamps, :force=>true, :update_on_create=>true


Public Class

  1. configure

Public Class methods

configure (model, opts=OPTS)

Configure the plugin by setting the available options. Note that if this method is run more than once, previous settings are ignored, and it will just use the settings given or the default settings. Options:


Whether to skip setting the update timestamp if it has been modified manually (default: false)


The field to hold the create timestamp (default: :created_at)


Whether to overwrite an existing create timestamp (default: false)


The field to hold the update timestamp (default: :updated_at)


Whether to set the update timestamp to the create timestamp when creating (default: false)

[show source]
# File lib/sequel/plugins/timestamps.rb, line 31
def self.configure(model, opts=OPTS)
  model.instance_eval do
    @allow_manual_timestamp_update = opts[:allow_manual_update]||false
    @create_timestamp_field = opts[:create]||:created_at
    @update_timestamp_field = opts[:update]||:updated_at
    @create_timestamp_overwrite = opts[:force]||false
    @set_update_timestamp_on_create = opts[:update_on_create]||false