date_values 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9128f65130329b58d9b750e411178c545086d0b46121ebe8a502fd3bb2774d9f
-  data.tar.gz: 39c349f3f8edb108890f1c3b267a75e3e16ef59f846fc5bebdc5198f38a89f31
+  metadata.gz: 76e212d3b12d520ef70a3072bb307cfec021b1f4a09fae4a03b75df64e8c2dcd
+  data.tar.gz: 7e230882c9b6cd8ea7147195143a0802a6f15c9cfcea6e04578edcd3235494ba
 SHA512:
-  metadata.gz: 30ceca8989f62e0fa958b02858ccefef45cff6d637e77f0fa7f4f3e87c6be562fb5d7c444873ebedb0f0ccf665f2662806ff7a5a0103459e47cce86e7753988e
-  data.tar.gz: d0c2a75cb71ae66715f1cf357602f948910d518d3d9901a57672f7457626e500fe6a91ebd18cb0d56738aeb6c2c66c74797043b92576f154d656fe4c138b9eae
+  metadata.gz: 9bdf4015dd33168d98fb6bdd3885e42ccb7a880862b67f400ca2c5fc394afad08a42b20f7af820548ecb482f178e128e0f6ee81893de90ce39ed9b2d1b9f9f64
+  data.tar.gz: 49b14bf137cd2139ade667faf3ffb6d2b3890830aa63f8f66138ca55ad5ed792570a0186dbcbcfa2f57876c3402bb29875b97087645610753af0f3f5621bfa4d

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [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)`)
+
 ## [0.1.0] - 2026-03-19
 
 - `DateValues::YearMonth` — year-month value object with arithmetic (`+`, `-`), `Range` support, and `Date` conversion

data/README.md

@@ -24,6 +24,7 @@ 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]
 
 ym + 1                           # => YearMonth[2026-04]
@@ -42,6 +43,7 @@ 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.parse('--03-19')        # => MonthDay[--03-19]
 ```
 
@@ -53,9 +55,31 @@ 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]
 ```
 
+### Pattern Matching
+
+Built on `Data.define`, so pattern matching works out of the box:
+
+```ruby
+case YearMonth.new(2026, 3)
+in { year: 2026, month: (1..3) }
+  puts 'Q1 2026'
+end
+
+case MonthDay.new(12, 25)
+in { month: 12, day: 25 }
+  puts 'Christmas'
+end
+
+case TimeOfDay.new(14, 30)
+in { hour: (9..17) }
+  puts 'Business hours'
+end
+```
+
 ## Rails Integration
 
 Opt-in ActiveModel type casting for ActiveRecord attributes:
@@ -70,6 +94,43 @@ class Shop < ApplicationRecord
 end
 ```
 
+### 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

@@ -13,6 +13,10 @@ module DateValues
       super
     end
 
+    def self.from(date)
+      new(date.month, date.day)
+    end
+
     def self.parse(str)
       raise ArgumentError, "invalid MonthDay: #{str}" unless str.match?(/\A--\d{2}-\d{2}\z/)
 
@@ -26,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,10 @@ 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)
+
+I18n::Backend::Base.prepend(DateValues::Rails::I18nBackend)

data/lib/date_values/time_of_day.rb

@@ -12,6 +12,10 @@ module DateValues
       super
     end
 
+    def self.from(time)
+      new(time.hour, time.min, time.sec)
+    end
+
     def self.parse(str)
       parts = str.split(':')
       raise ArgumentError, "invalid TimeOfDay: #{str}" unless [2, 3].include?(parts.size)
@@ -25,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.0"
+  VERSION = '0.1.2'
 end

data/lib/date_values/year_month.rb

@@ -12,6 +12,10 @@ module DateValues
       super
     end
 
+    def self.from(date)
+      new(date.year, date.month)
+    end
+
     def self.parse(str)
       raise ArgumentError, "invalid YearMonth: #{str}" unless str.match?(/\A\d{4}-\d{2}\z/)
 
@@ -45,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

@@ -9,6 +9,8 @@ module DateValues
 
     def initialize: (Integer year, Integer month) -> void
 
+    def self.from: (Date date) -> YearMonth
+
     def self.parse: (String str) -> YearMonth
 
     def <=>: (YearMonth other) -> Integer
@@ -21,6 +23,8 @@ module DateValues
 
     def succ: () -> YearMonth
 
+    def strftime: (String format) -> String
+
     def to_date: () -> Date
 
     def to_s: () -> String
@@ -36,11 +40,15 @@ module DateValues
 
     def initialize: (Integer month, Integer day) -> void
 
+    def self.from: (Date date) -> MonthDay
+
     def self.parse: (String str) -> MonthDay
 
     def <=>: (MonthDay other) -> Integer
            | (untyped other) -> nil
 
+    def strftime: (String format) -> String
+
     def to_date: (Integer year) -> Date
 
     def to_s: () -> String
@@ -61,11 +69,15 @@ module DateValues
 
     def initialize: (Integer hour, Integer minute, ?Integer second) -> void
 
+    def self.from: (Time time) -> TimeOfDay
+
     def self.parse: (String str) -> TimeOfDay
 
     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.0
+  version: 0.1.2
 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