date_values 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f294856b7f5149ded52770b4d43d003b5cac6e8ee533f81ec003ac04caf9988b
-  data.tar.gz: 8c1f6046926d15cda1a01e55f89e2975b92e6cf515bbc21cb0b6892d816bf93b
+  metadata.gz: 2fcd39df5c13a6c209d893be43a2be980a20219c5e02c5cc1283a67ba84cf07e
+  data.tar.gz: 16ddf29780a17802e64bef957362fe4588fe4e1c9bd67af9a95798d4c65f1379
 SHA512:
-  metadata.gz: 05e23c3cd91ddda9dcdf5ae63e81dd89c7a6bfd5150dab2893231ebe63c12bc64023cae0667c296e4e88db2dd5869ebdab39245370291cb29cbb9b2d906ad3e3
-  data.tar.gz: 28e82e5dc12f33c6e8af8b546338636ef2f6cda3273a2957bf7f86dcb4bb4a6074a4e2376c1c0ed0600f19e98b2783661710c8882b066eb05d3d9c1aa359aea8
+  metadata.gz: b0611c9270e1237268eb2a1d17cca321455bebca402afc5ce4730922171364948498759deba7ba471474657aa2e445b066d7ab26b33e23318f6848bb95363e6b
+  data.tar.gz: 664a70b1c75f04341ba490823ae76073bc7d5618493497d7e64c513e3de8c198ae67b0c8ce84549fca3100608922fc79f8b63592180c529be468e45300082e1f

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [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.

data/README.md

@@ -23,6 +23,7 @@ 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>
@@ -32,6 +33,9 @@ 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>]
@@ -48,7 +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
+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)
@@ -66,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
@@ -92,9 +108,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,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.2.0'
+  VERSION = '0.2.1'
 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,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.2.0
+  version: 0.2.1
 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