date_values 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18c625b8766c99ee4e063b2d2b756f68702d7468301cf0e14cb61c29647bc97e
-  data.tar.gz: cc21e80e920a5590109a62894d362b541f5f7362835f7d5113980b20bc28842f
+  metadata.gz: 3ed7149400551e703761bd9ea324f55decb43cfe14e11d36d8e6e22f1fcb21a3
+  data.tar.gz: d809fce0b0215b62891a453b4e7e4278ad7a600ffea25cc045662f4a4ae1425b
 SHA512:
-  metadata.gz: 3ea359a67138a64040d1fc62a9288c3862665f636db9e1651697ec6527390e1e53cb002f87745df2189b8eba8944f104e127b620af032be0e92d5a5d707f77a2
-  data.tar.gz: f5a8b524c53566ee986a3eea6bf28d08e889a428d15b7ae48f04443d46108ee7b882391adc82bc597af10338ef071ec9ecb83dc6812718d67ef332c5065432eb
+  metadata.gz: 821ca618c27d3b17583c8420697ad11cbb3b9ee34dc44d7ea4d938ffd4500a4795b8aacd6b41df9864c982877d201c0dc616fecbca6342945c671b8b1f410679
+  data.tar.gz: f69de80391b67de78fafca31368c4f54683299c94740eba4047d0dff800ecb0647bcf208039473911fbf0fb60cbbb5595ef3c322d79154b72bc39e47056361a5

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.1.4] - 2026-03-20
+
+- Cast returns `nil` for invalid input instead of raising, following Rails convention
+- Add `date_value` validator to distinguish "invalid input" from "no input"
+- `#inspect` now uses `#<ClassName value>` format following Ruby convention
+- Works with Rails standard validators (`comparison`, `inclusion`, `exclusion`)
+
 ## [0.1.3] - 2026-03-20
 
 - Fix ActiveRecord type registration — use `ActiveSupport.on_load(:active_record)` to register types regardless of load order

data/README.md

@@ -24,27 +24,29 @@ ym = YearMonth.new(2026, 3)
 ym.to_s                          # => "2026-03"
 ym.to_date                       # => #<Date: 2026-03-01>
 
-YearMonth.from(Date.today)       # => YearMonth[2026-03]
-YearMonth.parse('2026-03')       # => YearMonth[2026-03]
+YearMonth.from(Date.today)       # => #<DateValues::YearMonth 2026-03>
+YearMonth.parse('2026-03')       # => #<DateValues::YearMonth 2026-03>
 
-ym + 1                           # => YearMonth[2026-04]
-ym - 1                           # => YearMonth[2026-02]
+ym + 1                           # => #<DateValues::YearMonth 2026-04>
+ym - 1                           # => #<DateValues::YearMonth 2026-02>
 YearMonth.new(2026, 3) - YearMonth.new(2025, 1)  # => 14
 
 # Range support
 (YearMonth.new(2026, 1)..YearMonth.new(2026, 3)).to_a
-# => [YearMonth[2026-01], YearMonth[2026-02], YearMonth[2026-03]]
+# => [#<DateValues::YearMonth 2026-01>, #<DateValues::YearMonth 2026-02>, #<DateValues::YearMonth 2026-03>]
 ```
 
 ### MonthDay
 
+String representation uses ISO 8601 `--MM-DD` format (year omitted):
+
 ```ruby
 md = MonthDay.new(3, 19)
 md.to_s                          # => "--03-19"
 md.to_date(2026)                 # => #<Date: 2026-03-19>
 
-MonthDay.from(Date.today)        # => MonthDay[--03-20]
-MonthDay.parse('--03-19')        # => MonthDay[--03-19]
+MonthDay.from(Date.today)        # => #<DateValues::MonthDay --03-20>
+MonthDay.parse('--03-19')        # => #<DateValues::MonthDay --03-19>
 
 # Range membership
 summer = MonthDay.new(6, 1)..MonthDay.new(8, 31)
@@ -59,8 +61,8 @@ tod.to_s                         # => "14:30"
 
 TimeOfDay.new(14, 30, 45).to_s  # => "14:30:45"
 
-TimeOfDay.from(Time.now)         # => TimeOfDay[14:30]
-TimeOfDay.parse('14:30')         # => TimeOfDay[14:30]
+TimeOfDay.from(Time.now)         # => #<DateValues::TimeOfDay 14:30>
+TimeOfDay.parse('14:30')         # => #<DateValues::TimeOfDay 14:30>
 
 # Range membership
 business_hours = TimeOfDay.new(9, 0)..TimeOfDay.new(17, 0)
@@ -109,6 +111,37 @@ Shop.where(billing_month: YearMonth.new(2026, 3))
 # SELECT * FROM shops WHERE billing_month = '2026-03'
 ```
 
+### Validation
+
+All classes are `Comparable` and value-equal, so standard Rails validators work as-is:
+
+```ruby
+class Contract < ApplicationRecord
+  attribute :start_month, :year_month
+  attribute :opens_at,    :time_of_day
+
+  validates :start_month, comparison: {greater_than: -> { YearMonth.from(Date.current) }}
+  validates :opens_at,    comparison: {
+    greater_than_or_equal_to: TimeOfDay.new(9, 0),
+    less_than_or_equal_to:    TimeOfDay.new(17, 0)
+  }
+end
+```
+
+Invalid input (e.g. `"25:00"`) is cast to `nil` rather than raising, following the same convention as Rails' built-in types. The `date_value` validator detects this and gives a meaningful error message:
+
+```ruby
+class Shop < ApplicationRecord
+  attribute :opens_at, :time_of_day
+
+  validates :opens_at, presence: true, date_value: true
+end
+
+Shop.new(opens_at: '25:00').errors[:opens_at]  # => ["is invalid"]
+Shop.new(opens_at: '').errors[:opens_at]       # => ["can't be blank"]
+```
+
+
 ### I18n / `l` Helper
 
 All classes implement `#strftime`, and the Rails integration extends `I18n.l` to support them. Define formats in your locale files:
@@ -125,6 +158,7 @@ en:
   time_of_day:
     formats:
       default: '%-I:%M %p'
+      long: '%-I:%M:%S %p'
 ```
 
 ```yaml
@@ -138,12 +172,14 @@ ja:
       default: '%-m月%-d日'
   time_of_day:
     formats:
-      default: '%-H時%M分'
+      default: '%-H時%-M分'
+      long: '%-H時%-M分%-S秒'
 ```
 
 ```ruby
-I18n.l YearMonth.new(2026, 3), locale: :en  # => "March 2026"
-I18n.l YearMonth.new(2026, 3), locale: :ja  # => "2026年3月"
+I18n.l YearMonth.new(2026, 3), locale: :en   # => "March 2026"
+I18n.l YearMonth.new(2026, 3), locale: :ja   # => "2026年3月"
+I18n.l TimeOfDay.new(14, 30), format: :long  # => "2:30:00 PM"
 ```
 
 ## License

data/lib/date_values/month_day.rb

@@ -44,7 +44,7 @@ module DateValues
     end
 
     def inspect
-      "MonthDay[#{self}]"
+      "#<DateValues::MonthDay #{self}>"
     end
 
     private

data/lib/date_values/rails/date_value_validator.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'active_model/validator'
+
+class DateValueValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    raw = record.read_attribute_before_type_cast(attribute)
+    return if raw.blank?
+    return unless value.nil?
+
+    record.errors.add(attribute, :invalid, **options)
+  end
+end

data/lib/date_values/rails/month_day_type.rb

@@ -12,8 +12,9 @@ module DateValues
         when MonthDay then value
         when String   then MonthDay.parse(value)
         when nil      then nil
-        else raise ArgumentError, "can't cast #{value.class} to MonthDay"
         end
+      rescue ArgumentError
+        nil
       end
 
       def serialize(value)

data/lib/date_values/rails/time_of_day_type.rb

@@ -13,8 +13,9 @@ module DateValues
         when Time      then TimeOfDay.new(value.hour, value.min, value.sec)
         when String    then TimeOfDay.parse(value)
         when nil       then nil
-        else raise ArgumentError, "can't cast #{value.class} to TimeOfDay"
         end
+      rescue ArgumentError
+        nil
       end
 
       def serialize(value)

data/lib/date_values/rails/year_month_type.rb

@@ -12,8 +12,9 @@ module DateValues
         when YearMonth then value
         when String    then YearMonth.parse(value)
         when nil       then nil
-        else raise ArgumentError, "can't cast #{value.class} to YearMonth"
         end
+      rescue ArgumentError
+        nil
       end
 
       def serialize(value)

data/lib/date_values/rails.rb

@@ -7,6 +7,7 @@ require_relative 'rails/year_month_type'
 require_relative 'rails/month_day_type'
 require_relative 'rails/time_of_day_type'
 require_relative 'rails/i18n_backend'
+require_relative 'rails/date_value_validator'
 
 ActiveModel::Type.register(:year_month, DateValues::Rails::YearMonthType)
 ActiveModel::Type.register(:month_day, DateValues::Rails::MonthDayType)

data/lib/date_values/time_of_day.rb

@@ -42,7 +42,7 @@ module DateValues
     end
 
     def inspect
-      "TimeOfDay[#{self}]"
+      "#<DateValues::TimeOfDay #{self}>"
     end
   end
 end

data/lib/date_values/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DateValues
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

data/lib/date_values/year_month.rb

@@ -62,7 +62,7 @@ module DateValues
     end
 
     def inspect
-      "YearMonth[#{self}]"
+      "#<DateValues::YearMonth #{self}>"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: date_values
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Keita Urashima
@@ -22,6 +22,7 @@ files:
 - lib/date_values.rb
 - lib/date_values/month_day.rb
 - lib/date_values/rails.rb
+- lib/date_values/rails/date_value_validator.rb
 - lib/date_values/rails/i18n_backend.rb
 - lib/date_values/rails/month_day_type.rb
 - lib/date_values/rails/time_of_day_type.rb