Class: ActiveModel::Type::DateTime
Relationships & Source Files | |
Extension / Inclusion / Inheritance Descendants | |
Subclasses:
ActiveRecord::Type::DateTime, ActiveRecord::ConnectionAdapters::PostgreSQL::OID::DateTime, ActiveRecord::ConnectionAdapters::PostgreSQL::OID::Timestamp, ActiveRecord::ConnectionAdapters::PostgreSQL::OID::TimestampWithTimeZone
|
|
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
Value
|
|
Instance Chain:
self,
Value
|
|
Inherits: |
ActiveModel::Type::Value
|
Defined in: | activemodel/lib/active_model/type/date_time.rb |
Overview
Active Model DateTime Type
::ActiveModel::Attribute
type to represent dates and times. It is registered under the :datetime
key.
class Event
include ActiveModel::Attributes
attribute :start, :datetime
end
event = Event.new
event.start = "Wed, 04 Sep 2013 03:00:00 EAT"
event.start.class # => Time
event.start.year # => 2013
event.start.month # => 9
event.start.day # => 4
event.start.hour # => 3
event.start.min # => 0
event.start.sec # => 0
event.start.zone # => "EAT"
String
values are parsed using the ISO 8601 datetime format. Partial time-only formats are also accepted.
event.start = "06:07:08+09:00"
event.start.utc # => 1999-12-31 21:07:08 UTC
The degree of sub-second precision can be customized when declaring an attribute:
class Event
include ActiveModel::Attributes
attribute :start, :datetime, precision: 4
end
Class Method Summary
Value
- Inherited
.new | Initializes a type with three basic configuration settings: precision, limit, and scale. |
Instance Attribute Summary
Value
- Inherited
Instance Method Summary
Value
- Inherited
#==, #as_json, #assert_valid_value, | |
#cast |
|
#changed? | Determines whether a value has changed for dirty checking. |
#changed_in_place? | Determines whether the mutable value has been modified since it was read. |
#deserialize | Converts a value from database input to the appropriate ruby type. |
#eql? | Alias for Value#==. |
#hash, | |
#serializable? | Returns true if this type can convert |
#serialize | Casts a value from the ruby type to a type that the database knows how to understand. |
#type | Returns the unique type name as a |
#cast_value | Convenience method for types which do not need separate type casting behavior for user and database inputs. |
Constructor Details
This class inherits a constructor from ActiveModel::Type::Value
Instance Method Details
#type
[ GitHub ]# File 'activemodel/lib/active_model/type/date_time.rb', line 49
def type :datetime end