date_values 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f294856b7f5149ded52770b4d43d003b5cac6e8ee533f81ec003ac04caf9988b
-  data.tar.gz: 8c1f6046926d15cda1a01e55f89e2975b92e6cf515bbc21cb0b6892d816bf93b
+  metadata.gz: 10dc98d9c1080745a0aebb8880f9bbafd34d1d5c9103736683b35633f6cd8d2c
+  data.tar.gz: aa7288bf8c473376b30f0e46fadfd1b78c79c34173deae88055d3ce5f7e47ec5
 SHA512:
-  metadata.gz: 05e23c3cd91ddda9dcdf5ae63e81dd89c7a6bfd5150dab2893231ebe63c12bc64023cae0667c296e4e88db2dd5869ebdab39245370291cb29cbb9b2d906ad3e3
-  data.tar.gz: 28e82e5dc12f33c6e8af8b546338636ef2f6cda3273a2957bf7f86dcb4bb4a6074a4e2376c1c0ed0600f19e98b2783661710c8882b066eb05d3d9c1aa359aea8
+  metadata.gz: 34876d1314f36317f6fd2392e5489327e00f56df5b62cfcce0f27432469026957dfbf328459dbb1c84a9e1511e5c989f9ca556988ecefcf5f05d60df65ad2e56
+  data.tar.gz: '09fe11dd318422c430a941be38194bdeff80ff550a9fbce78076cad789d70076c698a2e409d03c79ea85aa61a3c4d2f2b03c00b28192facb6ec90e78b5dac222'

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## [Unreleased]
 
+## [0.2.2] - 2026-03-21
+
+- `TimeOfDay#-` accepts `TimeOfDay` to return difference in seconds
+
+## [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.

data/README.md

@@ -21,17 +21,21 @@ include DateValues
 
 ```ruby
 ym = YearMonth.new(2026, 3)
-ym.to_s                          # => "2026-03"
-ym.to_date                       # => #<Date: 2026-03-01>
+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
+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>
+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>]
@@ -43,12 +47,14 @@ 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>
+md.to_s                  # => "--03-19"
+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)
 
-MonthDay.from(Date.today)        # => #<DateValues::MonthDay --03-20>
-MonthDay.parse('--03-19')        # => #<DateValues::MonthDay --03-19>
-MonthDay.parse('3/19')           # also works
+md.change(month: 12)     # => #<DateValues::MonthDay --12-19>
 
 # Range membership
 summer = MonthDay.new(6, 1)..MonthDay.new(8, 31)
@@ -59,12 +65,23 @@ summer.cover?(MonthDay.new(7, 15))    # => true
 
 ```ruby
 tod = TimeOfDay.new(14, 30)
-tod.to_s                         # => "14:30"
+tod.to_s                                        # => "14:30"
+
+TimeOfDay.new(14, 30, 45).to_s                  # => "14:30:45"
 
-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>
 
-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>
+TimeOfDay.new(17, 0) - TimeOfDay.new(9, 0)       # => 28800 (seconds)
+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)
@@ -92,9 +109,33 @@ in { hour: (9..17) }
 end
 ```
 
+### JSON
+
+All classes implement `#as_json`, returning the same string as `#to_s`:
+
+```ruby
+YearMonth.new(2026, 3).as_json   # => "2026-03"
+MonthDay.new(3, 19).as_json      # => "--03-19"
+TimeOfDay.new(14, 30).as_json    # => "14:30"
+```
+
+## Configuration
+
+### MonthDay parse order
+
+By default, `MonthDay.parse` interprets ambiguous formats like `"3/19"` as month/day. For day/month (European convention):
+
+```ruby
+DateValues.config.month_day_order = :day_first
+
+MonthDay.parse('19/3')   # => #<DateValues::MonthDay --03-19>
+```
+
+ISO 8601 format (`--MM-DD`) is always month/day regardless of this setting.
+
 ## Rails Integration
 
-See [date_values-rails](https://github.com/ursm/date_values-rails) for ActiveModel/ActiveRecord type casting, validation, and I18n support.
+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

@@ -19,9 +19,18 @@ module DateValues
 
     def self.parse(str)
       case str
-      when /\A--(\d{1,2})-(\d{1,2})\z/ then new($1.to_i, $2.to_i)
-      when /\A(\d{1,2})[\/\-](\d{1,2})\z/ then new($1.to_i, $2.to_i)
-      else raise ArgumentError, "invalid MonthDay: #{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
+
+        if DateValues.config.month_day_order == :day_first
+          new(b, a)
+        else
+          new(a, b)
+        end
+      else
+        raise ArgumentError, "invalid MonthDay: #{str}"
       end
     end
 
@@ -31,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)
@@ -40,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,45 @@ 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 -(other)
+      case other
+      when Integer   then self + (-other)
+      when TimeOfDay then to_seconds - other.to_seconds
+      else raise TypeError, "#{other.class} can't be coerced into Integer or TimeOfDay"
+      end
+    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.2.0'
+  VERSION = '0.2.2'
 end

data/lib/date_values/year_month.rb

@@ -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,28 @@ 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
+         | (TimeOfDay other) -> Integer
+
+    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.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Keita Urashima
@@ -20,6 +20,7 @@ files:
 - README.md
 - Rakefile
 - lib/date_values.rb
+- lib/date_values/configuration.rb
 - lib/date_values/month_day.rb
 - lib/date_values/time_of_day.rb
 - lib/date_values/version.rb