Class: ActiveModel::Type::Time
Relationships & Source Files | |
Extension / Inclusion / Inheritance Descendants | |
Subclasses:
|
|
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/time.rb |
Overview
Active Model Time Type
::ActiveModel::Attribute
type for time of day representation. It is registered under the :time
key.
class Event
include ActiveModel::Attributes
attribute :start, :time
end
String
values are parsed using the ISO 8601 datetime format, but are normalized to have a date of 2000-01-01 and be in the UTC time zone.
event = Event.new
event.start = "2004-10-25T01:23:45-06:00"
event.start.class # => Time
event.start # => 2000-01-01 07:23:45 UTC
Partial time-only formats are also accepted.
event.start = "00:01:02+03:00"
event.start # => 1999-12-31 21:01:02 UTC
The degree of sub-second precision can be customized when declaring an attribute:
class Event
include ActiveModel::Attributes
attribute :start, :time, 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/time.rb', line 45
def type :time end
#user_input_in_time_zone(value)
[ GitHub ]# File 'activemodel/lib/active_model/type/time.rb', line 49
def user_input_in_time_zone(value) return unless value.present? case value when ::String value = "2000-01-01 #{value}" time_hash = begin ::Date._parse(value) rescue ArgumentError end return if time_hash.nil? || time_hash[:hour].nil? when ::Time value = value.change(year: 2000, day: 1, month: 1) end super(value) end