class Time

Ruby on Rails 7.1.6

Since v7.1.6

Available in: v7.1.6 v7.2.3 v8.0.4 v8.1.2

Active Model Time Type

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

Inherits from

Value

Includes

Methods (defined here)

Private methods

(1) Implementation detail — not part of the public API.

Used by

Subclasses (1)

Type at least 2 characters to search.

↑↓ navigate · open · esc close