date_values 0.1.4 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ed7149400551e703761bd9ea324f55decb43cfe14e11d36d8e6e22f1fcb21a3
-  data.tar.gz: d809fce0b0215b62891a453b4e7e4278ad7a600ffea25cc045662f4a4ae1425b
+  metadata.gz: 2fcd39df5c13a6c209d893be43a2be980a20219c5e02c5cc1283a67ba84cf07e
+  data.tar.gz: 16ddf29780a17802e64bef957362fe4588fe4e1c9bd67af9a95798d4c65f1379
 SHA512:
-  metadata.gz: 821ca618c27d3b17583c8420697ad11cbb3b9ee34dc44d7ea4d938ffd4500a4795b8aacd6b41df9864c982877d201c0dc616fecbca6342945c671b8b1f410679
-  data.tar.gz: f69de80391b67de78fafca31368c4f54683299c94740eba4047d0dff800ecb0647bcf208039473911fbf0fb60cbbb5595ef3c322d79154b72bc39e47056361a5
+  metadata.gz: b0611c9270e1237268eb2a1d17cca321455bebca402afc5ce4730922171364948498759deba7ba471474657aa2e445b066d7ab26b33e23318f6848bb95363e6b
+  data.tar.gz: 664a70b1c75f04341ba490823ae76073bc7d5618493497d7e64c513e3de8c198ae67b0c8ce84549fca3100608922fc79f8b63592180c529be468e45300082e1f

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## [Unreleased]
 
+## [0.2.1] - 2026-03-21
+
+- Add `TimeOfDay` arithmetic (`+`, `-`), `advance`, `change`, `to_seconds`, `.from_seconds`
+- Add `YearMonth#advance`, `YearMonth#change`, `YearMonth#days`
+- Add `MonthDay#change`
+- Add `#as_json` to all value classes
+- Add `DateValues.config.month_day_order` for locale-dependent `MonthDay.parse`
+
+## [0.2.0] - 2026-03-20
+
+- **Breaking**: Rails integration extracted to [date_values-rails](https://github.com/ursm/date_values-rails). `require 'date_values/rails'` now requires installing `date_values-rails` gem.
+
 ## [0.1.4] - 2026-03-20
 
 - Cast returns `nil` for invalid input instead of raising, following Rails convention

data/README.md

@@ -23,14 +23,19 @@ include DateValues
 ym = YearMonth.new(2026, 3)
 ym.to_s                          # => "2026-03"
 ym.to_date                       # => #<Date: 2026-03-01>
+ym.days                          # => 31
 
 YearMonth.from(Date.today)       # => #<DateValues::YearMonth 2026-03>
 YearMonth.parse('2026-03')       # => #<DateValues::YearMonth 2026-03>
+YearMonth.parse('2026/3')        # also works
 
 ym + 1                           # => #<DateValues::YearMonth 2026-04>
 ym - 1                           # => #<DateValues::YearMonth 2026-02>
 YearMonth.new(2026, 3) - YearMonth.new(2025, 1)  # => 14
 
+ym.advance(years: 1, months: 2)  # => #<DateValues::YearMonth 2027-05>
+ym.change(year: 2025)            # => #<DateValues::YearMonth 2025-03>
+
 # Range support
 (YearMonth.new(2026, 1)..YearMonth.new(2026, 3)).to_a
 # => [#<DateValues::YearMonth 2026-01>, #<DateValues::YearMonth 2026-02>, #<DateValues::YearMonth 2026-03>]
@@ -47,6 +52,9 @@ md.to_date(2026)                 # => #<Date: 2026-03-19>
 
 MonthDay.from(Date.today)        # => #<DateValues::MonthDay --03-20>
 MonthDay.parse('--03-19')        # => #<DateValues::MonthDay --03-19>
+MonthDay.parse('3/19')           # also works (month/day order by default)
+
+md.change(month: 12)             # => #<DateValues::MonthDay --12-19>
 
 # Range membership
 summer = MonthDay.new(6, 1)..MonthDay.new(8, 31)
@@ -64,6 +72,16 @@ TimeOfDay.new(14, 30, 45).to_s  # => "14:30:45"
 TimeOfDay.from(Time.now)         # => #<DateValues::TimeOfDay 14:30>
 TimeOfDay.parse('14:30')         # => #<DateValues::TimeOfDay 14:30>
 
+tod + 3600                       # => #<DateValues::TimeOfDay 15:30>
+tod - 1800                       # => #<DateValues::TimeOfDay 14:00>
+tod.advance(hours: 2, minutes: 15)  # => #<DateValues::TimeOfDay 16:45>
+tod.change(minute: 0)            # => #<DateValues::TimeOfDay 14:00>
+tod.to_seconds                   # => 52200
+TimeOfDay.from_seconds(52200)    # => #<DateValues::TimeOfDay 14:30>
+
+# Wraps at 24h boundaries
+TimeOfDay.new(23, 30) + 3600    # => #<DateValues::TimeOfDay 00:30>
+
 # Range membership
 business_hours = TimeOfDay.new(9, 0)..TimeOfDay.new(17, 0)
 business_hours.cover?(TimeOfDay.new(12, 30))    # => true
@@ -90,97 +108,33 @@ in { hour: (9..17) }
 end
 ```
 
-## Rails Integration
+### JSON
 
-Opt-in ActiveModel type casting for ActiveRecord attributes:
+All classes implement `#as_json`, returning the same string as `#to_s`:
 
 ```ruby
-require 'date_values/rails'
-
-class Shop < ApplicationRecord
-  attribute :billing_month, :year_month   # string column "2026-03"
-  attribute :anniversary,   :month_day    # string column "--03-19"
-  attribute :opens_at,      :time_of_day  # string or time column
-end
+YearMonth.new(2026, 3).as_json   # => "2026-03"
+MonthDay.new(3, 19).as_json      # => "--03-19"
+TimeOfDay.new(14, 30).as_json    # => "14:30"
 ```
 
-Values are automatically serialized in queries:
+## Configuration
 
-```ruby
-Shop.where(billing_month: YearMonth.new(2026, 3))
-# SELECT * FROM shops WHERE billing_month = '2026-03'
-```
-
-### Validation
+### MonthDay parse order
 
-All classes are `Comparable` and value-equal, so standard Rails validators work as-is:
+By default, `MonthDay.parse` interprets ambiguous formats like `"3/19"` as month/day. For day/month (European convention):
 
 ```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:
+DateValues.config.month_day_order = :day_first
 
-```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"]
+MonthDay.parse('19/3')   # => #<DateValues::MonthDay --03-19>
 ```
 
+ISO 8601 format (`--MM-DD`) is always month/day regardless of this setting.
 
-### 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'
-      long: '%-I:%M:%S %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分'
-      long: '%-H時%-M分%-S秒'
-```
+## Rails Integration
 
-```ruby
-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"
-```
+See [date_values-rails](https://github.com/ursm/date_values-rails) for ActiveModel/ActiveRecord type casting, validation, I18n, and ActiveJob support.
 
 ## License
 

data/lib/date_values/configuration.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module DateValues
+  class Configuration
+    attr_accessor :month_day_order
+
+    def initialize
+      @month_day_order = :month_first
+    end
+  end
+
+  def self.config
+    @config ||= Configuration.new
+  end
+
+  def self.configure
+    yield config
+  end
+end

data/lib/date_values/month_day.rb

@@ -18,10 +18,20 @@ module DateValues
     end
 
     def self.parse(str)
-      raise ArgumentError, "invalid MonthDay: #{str}" unless str.match?(/\A--\d{2}-\d{2}\z/)
+      case str
+      when /\A--(\d{1,2})-(\d{1,2})\z/
+        new($1.to_i, $2.to_i)
+      when /\A(\d{1,2})[\/\-](\d{1,2})\z/
+        a, b = $1.to_i, $2.to_i
 
-      month, day = str[2..].split('-').map(&:to_i)
-      new(month, day)
+        if DateValues.config.month_day_order == :day_first
+          new(b, a)
+        else
+          new(a, b)
+        end
+      else
+        raise ArgumentError, "invalid MonthDay: #{str}"
+      end
     end
 
     def <=>(other)
@@ -30,6 +40,10 @@ module DateValues
       [month, day] <=> [other.month, other.day]
     end
 
+    def change(month: self.month, day: self.day)
+      self.class.new(month, day)
+    end
+
     def strftime(format)
       # 2000 is a leap year, so Feb 29 works
       Date.new(2000, month, day).strftime(format)
@@ -39,6 +53,10 @@ module DateValues
       Date.new(year, month, day)
     end
 
+    def as_json(*)
+      to_s
+    end
+
     def to_s
       format('--%02d-%02d', month, day)
     end

data/lib/date_values/time_of_day.rb

@@ -29,10 +29,41 @@ module DateValues
       [hour, minute, second] <=> [other.hour, other.minute, other.second]
     end
 
+    def +(seconds)
+      self.class.from_seconds((to_seconds + seconds) % 86_400)
+    end
+
+    def -(seconds)
+      self + (-seconds)
+    end
+
+    def advance(hours: 0, minutes: 0, seconds: 0)
+      self + (hours * 3600 + minutes * 60 + seconds)
+    end
+
+    def change(hour: self.hour, minute: self.minute, second: self.second)
+      self.class.new(hour, minute, second)
+    end
+
+    def to_seconds
+      hour * 3600 + minute * 60 + second
+    end
+
+    def self.from_seconds(total)
+      total = total % 86_400
+      h, rest = total.divmod(3600)
+      m, s    = rest.divmod(60)
+      new(h, m, s)
+    end
+
     def strftime(format)
       Time.new(2000, 1, 1, hour, minute, second).strftime(format)
     end
 
+    def as_json(*)
+      to_s
+    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.4'
+  VERSION = '0.2.1'
 end

data/lib/date_values/year_month.rb

@@ -17,10 +17,10 @@ module DateValues
     end
 
     def self.parse(str)
-      raise ArgumentError, "invalid YearMonth: #{str}" unless str.match?(/\A\d{4}-\d{2}\z/)
-
-      year, month = str.split('-').map(&:to_i)
-      new(year, month)
+      case str
+      when /\A(\d{4})[\/\-](\d{1,2})\z/ then new($1.to_i, $2.to_i)
+      else raise ArgumentError, "invalid YearMonth: #{str}"
+      end
     end
 
     def <=>(other)
@@ -49,6 +49,18 @@ module DateValues
       self + 1
     end
 
+    def advance(years: 0, months: 0)
+      self + (years * 12 + months)
+    end
+
+    def change(year: self.year, month: self.month)
+      self.class.new(year, month)
+    end
+
+    def days
+      Date.new(year, month, -1).day
+    end
+
     def strftime(format)
       to_date.strftime(format)
     end
@@ -57,6 +69,10 @@ module DateValues
       Date.new(year, month, 1)
     end
 
+    def as_json(*)
+      to_s
+    end
+
     def to_s
       format('%04d-%02d', year, month)
     end

data/lib/date_values.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'date_values/version'
+require_relative 'date_values/configuration'
 require_relative 'date_values/year_month'
 require_relative 'date_values/month_day'
 require_relative 'date_values/time_of_day'

data/sig/date_values.rbs

@@ -1,6 +1,15 @@
 module DateValues
   VERSION: String
 
+  def self.config: () -> Configuration
+  def self.configure: () { (Configuration) -> void } -> void
+
+  class Configuration
+    attr_accessor month_day_order: :month_first | :day_first
+
+    def initialize: () -> void
+  end
+
   class YearMonth
     include Comparable
 
@@ -23,10 +32,18 @@ module DateValues
 
     def succ: () -> YearMonth
 
+    def advance: (?years: Integer, ?months: Integer) -> YearMonth
+
+    def change: (?year: Integer, ?month: Integer) -> YearMonth
+
+    def days: () -> Integer
+
     def strftime: (String format) -> String
 
     def to_date: () -> Date
 
+    def as_json: (*untyped) -> String
+
     def to_s: () -> String
 
     def inspect: () -> String
@@ -47,10 +64,14 @@ module DateValues
     def <=>: (MonthDay other) -> Integer
            | (untyped other) -> nil
 
+    def change: (?month: Integer, ?day: Integer) -> MonthDay
+
     def strftime: (String format) -> String
 
     def to_date: (Integer year) -> Date
 
+    def as_json: (*untyped) -> String
+
     def to_s: () -> String
 
     def inspect: () -> String
@@ -71,13 +92,27 @@ module DateValues
 
     def self.from: (Time time) -> TimeOfDay
 
+    def self.from_seconds: (Integer total) -> TimeOfDay
+
     def self.parse: (String str) -> TimeOfDay
 
     def <=>: (TimeOfDay other) -> Integer
            | (untyped other) -> nil
 
+    def +: (Integer seconds) -> TimeOfDay
+
+    def -: (Integer seconds) -> TimeOfDay
+
+    def advance: (?hours: Integer, ?minutes: Integer, ?seconds: Integer) -> TimeOfDay
+
+    def change: (?hour: Integer, ?minute: Integer, ?second: Integer) -> TimeOfDay
+
+    def to_seconds: () -> Integer
+
     def strftime: (String format) -> String
 
+    def as_json: (*untyped) -> 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.4
+  version: 0.2.1
 platform: ruby
 authors:
 - Keita Urashima
@@ -20,18 +20,12 @@ files:
 - README.md
 - Rakefile
 - lib/date_values.rb
+- lib/date_values/configuration.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
-- lib/date_values/rails/year_month_type.rb
 - lib/date_values/time_of_day.rb
 - lib/date_values/version.rb
 - lib/date_values/year_month.rb
 - sig/date_values.rbs
-- sig/date_values/rails.rbs
 homepage: https://github.com/ursm/date_values
 licenses:
 - MIT

data/lib/date_values/rails/date_value_validator.rb

@@ -1,13 +0,0 @@
-# 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/i18n_backend.rb

@@ -1,29 +0,0 @@
-# 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/month_day_type.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module DateValues
-  module Rails
-    class MonthDayType < ActiveModel::Type::Value
-      def type
-        :month_day
-      end
-
-      def cast(value)
-        case value
-        when MonthDay then value
-        when String   then MonthDay.parse(value)
-        when nil      then nil
-        end
-      rescue ArgumentError
-        nil
-      end
-
-      def serialize(value)
-        value&.to_s
-      end
-
-      def deserialize(value)
-        return nil if value.nil?
-
-        MonthDay.parse(value)
-      end
-    end
-  end
-end

data/lib/date_values/rails/time_of_day_type.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-module DateValues
-  module Rails
-    class TimeOfDayType < ActiveModel::Type::Value
-      def type
-        :time_of_day
-      end
-
-      def cast(value)
-        case value
-        when TimeOfDay then value
-        when Time      then TimeOfDay.new(value.hour, value.min, value.sec)
-        when String    then TimeOfDay.parse(value)
-        when nil       then nil
-        end
-      rescue ArgumentError
-        nil
-      end
-
-      def serialize(value)
-        value&.to_s
-      end
-
-      def deserialize(value)
-        case value
-        when nil       then nil
-        when Time      then TimeOfDay.new(value.hour, value.min, value.sec)
-        when String    then TimeOfDay.parse(value)
-        end
-      end
-    end
-  end
-end

data/lib/date_values/rails/year_month_type.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module DateValues
-  module Rails
-    class YearMonthType < ActiveModel::Type::Value
-      def type
-        :year_month
-      end
-
-      def cast(value)
-        case value
-        when YearMonth then value
-        when String    then YearMonth.parse(value)
-        when nil       then nil
-        end
-      rescue ArgumentError
-        nil
-      end
-
-      def serialize(value)
-        value&.to_s
-      end
-
-      def deserialize(value)
-        return nil if value.nil?
-
-        YearMonth.parse(value)
-      end
-    end
-  end
-end

data/lib/date_values/rails.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require 'date_values'
-require 'active_support'
-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'
-require_relative 'rails/date_value_validator'
-
-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/sig/date_values/rails.rbs

@@ -1,44 +0,0 @@
-module DateValues
-  module Rails
-    class YearMonthType < ActiveModel::Type::Value
-      def type: () -> :year_month
-
-      def cast: (YearMonth value) -> YearMonth
-              | (String value) -> YearMonth
-              | (nil value) -> nil
-
-      def serialize: (YearMonth? value) -> String?
-
-      def deserialize: (String value) -> YearMonth
-                     | (nil value) -> nil
-    end
-
-    class MonthDayType < ActiveModel::Type::Value
-      def type: () -> :month_day
-
-      def cast: (MonthDay value) -> MonthDay
-              | (String value) -> MonthDay
-              | (nil value) -> nil
-
-      def serialize: (MonthDay? value) -> String?
-
-      def deserialize: (String value) -> MonthDay
-                     | (nil value) -> nil
-    end
-
-    class TimeOfDayType < ActiveModel::Type::Value
-      def type: () -> :time_of_day
-
-      def cast: (TimeOfDay value) -> TimeOfDay
-              | (Time value) -> TimeOfDay
-              | (String value) -> TimeOfDay
-              | (nil value) -> nil
-
-      def serialize: (TimeOfDay? value) -> String?
-
-      def deserialize: (Time value) -> TimeOfDay
-                     | (String value) -> TimeOfDay
-                     | (nil value) -> nil
-    end
-  end
-end