date_values 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ddef0176920084031675a2e93da2007646c642f23d0238ff4c54848f4ae0691
-  data.tar.gz: ecfbf84c37563d8b7ec9c592a625313aa95e7c0de0bb13d69b05ca8c96349389
+  metadata.gz: 18c625b8766c99ee4e063b2d2b756f68702d7468301cf0e14cb61c29647bc97e
+  data.tar.gz: cc21e80e920a5590109a62894d362b541f5f7362835f7d5113980b20bc28842f
 SHA512:
-  metadata.gz: e1f49621fe9037b5a5dddaea83c267bdcf7493dbf15b87a6ddb6e93b131843799836aa0608cb9f83b8759453265cd1ec747cbf01e3c6f518b7cf9517c3e832bd
-  data.tar.gz: 25ce52fd8bfd18544c62704562704eeba340cf44cfbb57d408c38d3d19b3771034026803a80f1d2660894541cca4d8c213a6bd462bbf62db2184ed4bde6106be
+  metadata.gz: 3ea359a67138a64040d1fc62a9288c3862665f636db9e1651697ec6527390e1e53cb002f87745df2189b8eba8944f104e127b620af032be0e92d5a5d707f77a2
+  data.tar.gz: f5a8b524c53566ee986a3eea6bf28d08e889a428d15b7ae48f04443d46108ee7b882391adc82bc597af10338ef071ec9ecb83dc6812718d67ef332c5065432eb

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [0.1.3] - 2026-03-20
+
+- Fix ActiveRecord type registration — use `ActiveSupport.on_load(:active_record)` to register types regardless of load order
+- Values now work directly in ActiveRecord queries (`Shop.where(billing_month: YearMonth.new(2026, 3))`)
+
+## [0.1.2] - 2026-03-19
+
+- Add `#strftime` to `YearMonth`, `MonthDay`, and `TimeOfDay`
+- Add I18n backend extension for Rails `l` helper — looks up `year_month.formats`, `month_day.formats`, and `time_of_day.formats` in locale files
+
 ## [0.1.1] - 2026-03-19
 
 - Add `.from` class methods for converting from `Date` / `Time` (`YearMonth.from(date)`, `MonthDay.from(date)`, `TimeOfDay.from(time)`)

data/README.md

@@ -43,8 +43,12 @@ md = MonthDay.new(3, 19)
 md.to_s                          # => "--03-19"
 md.to_date(2026)                 # => #<Date: 2026-03-19>
 
-MonthDay.from(Date.today)        # => MonthDay[--03-19]
+MonthDay.from(Date.today)        # => MonthDay[--03-20]
 MonthDay.parse('--03-19')        # => MonthDay[--03-19]
+
+# Range membership
+summer = MonthDay.new(6, 1)..MonthDay.new(8, 31)
+summer.cover?(MonthDay.new(7, 15))    # => true
 ```
 
 ### TimeOfDay
@@ -57,6 +61,10 @@ TimeOfDay.new(14, 30, 45).to_s  # => "14:30:45"
 
 TimeOfDay.from(Time.now)         # => TimeOfDay[14:30]
 TimeOfDay.parse('14:30')         # => TimeOfDay[14:30]
+
+# Range membership
+business_hours = TimeOfDay.new(9, 0)..TimeOfDay.new(17, 0)
+business_hours.cover?(TimeOfDay.new(12, 30))    # => true
 ```
 
 ### Pattern Matching
@@ -94,6 +102,50 @@ class Shop < ApplicationRecord
 end
 ```
 
+Values are automatically serialized in queries:
+
+```ruby
+Shop.where(billing_month: YearMonth.new(2026, 3))
+# SELECT * FROM shops WHERE billing_month = '2026-03'
+```
+
+### I18n / `l` Helper
+
+All classes implement `#strftime`, and the Rails integration extends `I18n.l` to support them. Define formats in your locale files:
+
+```yaml
+# config/locales/en.yml
+en:
+  year_month:
+    formats:
+      default: '%B %Y'
+  month_day:
+    formats:
+      default: '%B %-d'
+  time_of_day:
+    formats:
+      default: '%-I:%M %p'
+```
+
+```yaml
+# config/locales/ja.yml
+ja:
+  year_month:
+    formats:
+      default: '%Y年%-m月'
+  month_day:
+    formats:
+      default: '%-m月%-d日'
+  time_of_day:
+    formats:
+      default: '%-H時%M分'
+```
+
+```ruby
+I18n.l YearMonth.new(2026, 3), locale: :en  # => "March 2026"
+I18n.l YearMonth.new(2026, 3), locale: :ja  # => "2026年3月"
+```
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/date_values/month_day.rb

@@ -30,6 +30,11 @@ module DateValues
       [month, day] <=> [other.month, other.day]
     end
 
+    def strftime(format)
+      # 2000 is a leap year, so Feb 29 works
+      Date.new(2000, month, day).strftime(format)
+    end
+
     def to_date(year)
       Date.new(year, month, day)
     end

data/lib/date_values/rails/i18n_backend.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module DateValues
+  module Rails
+    module I18nBackend
+      TYPES = {
+        DateValues::YearMonth  => :year_month,
+        DateValues::MonthDay   => :month_day,
+        DateValues::TimeOfDay  => :time_of_day
+      }.freeze
+
+      def localize(locale, object, format = :default, options = EMPTY_HASH)
+        type = TYPES[object.class]
+        return super unless type
+
+        format_key = format.is_a?(Symbol) ? format : nil
+
+        if format_key
+          entry = I18n.t("#{type}.formats.#{format_key}", locale: locale, default: nil)
+          raise I18n::MissingTranslationData.new(locale, "#{type}.formats.#{format_key}") unless entry
+
+          format = entry
+        end
+
+        object.strftime(format)
+      end
+    end
+  end
+end

data/lib/date_values/rails.rb

@@ -6,7 +6,16 @@ require 'active_model/type'
 require_relative 'rails/year_month_type'
 require_relative 'rails/month_day_type'
 require_relative 'rails/time_of_day_type'
+require_relative 'rails/i18n_backend'
 
 ActiveModel::Type.register(:year_month, DateValues::Rails::YearMonthType)
 ActiveModel::Type.register(:month_day, DateValues::Rails::MonthDayType)
 ActiveModel::Type.register(:time_of_day, DateValues::Rails::TimeOfDayType)
+
+ActiveSupport.on_load(:active_record) do
+  ActiveRecord::Type.register(:year_month, DateValues::Rails::YearMonthType)
+  ActiveRecord::Type.register(:month_day, DateValues::Rails::MonthDayType)
+  ActiveRecord::Type.register(:time_of_day, DateValues::Rails::TimeOfDayType)
+end
+
+I18n::Backend::Base.prepend(DateValues::Rails::I18nBackend)

data/lib/date_values/time_of_day.rb

@@ -29,6 +29,10 @@ module DateValues
       [hour, minute, second] <=> [other.hour, other.minute, other.second]
     end
 
+    def strftime(format)
+      Time.new(2000, 1, 1, hour, minute, second).strftime(format)
+    end
+
     def to_s
       if second.zero?
         format('%02d:%02d', hour, minute)

data/lib/date_values/version.rb

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

data/lib/date_values/year_month.rb

@@ -49,6 +49,10 @@ module DateValues
       self + 1
     end
 
+    def strftime(format)
+      to_date.strftime(format)
+    end
+
     def to_date
       Date.new(year, month, 1)
     end

data/sig/date_values.rbs

@@ -23,6 +23,8 @@ module DateValues
 
     def succ: () -> YearMonth
 
+    def strftime: (String format) -> String
+
     def to_date: () -> Date
 
     def to_s: () -> String
@@ -45,6 +47,8 @@ module DateValues
     def <=>: (MonthDay other) -> Integer
            | (untyped other) -> nil
 
+    def strftime: (String format) -> String
+
     def to_date: (Integer year) -> Date
 
     def to_s: () -> String
@@ -72,6 +76,8 @@ module DateValues
     def <=>: (TimeOfDay other) -> Integer
            | (untyped other) -> nil
 
+    def strftime: (String format) -> String
+
     def to_s: () -> String
 
     def inspect: () -> String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: date_values
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 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/i18n_backend.rb
 - lib/date_values/rails/month_day_type.rb
 - lib/date_values/rails/time_of_day_type.rb
 - lib/date_values/rails/year_month_type.rb