date_values 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9128f65130329b58d9b750e411178c545086d0b46121ebe8a502fd3bb2774d9f
+  data.tar.gz: 39c349f3f8edb108890f1c3b267a75e3e16ef59f846fc5bebdc5198f38a89f31
+SHA512:
+  metadata.gz: 30ceca8989f62e0fa958b02858ccefef45cff6d637e77f0fa7f4f3e87c6be562fb5d7c444873ebedb0f0ccf665f2662806ff7a5a0103459e47cce86e7753988e
+  data.tar.gz: d0c2a75cb71ae66715f1cf357602f948910d518d3d9901a57672f7457626e500fe6a91ebd18cb0d56738aeb6c2c66c74797043b92576f154d656fe4c138b9eae

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-03-19
+
+- `DateValues::YearMonth` — year-month value object with arithmetic (`+`, `-`), `Range` support, and `Date` conversion
+- `DateValues::MonthDay` — month-day value object with ISO 8601 `--MM-DD` format
+- `DateValues::TimeOfDay` — time-of-day value object with optional seconds
+- All classes are `Data.define`-based (immutable, value equality) and include `Comparable`
+- `require 'date_values/rails'` registers ActiveModel types (`:year_month`, `:month_day`, `:time_of_day`)
+- RBS type signatures included

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Keita Urashima
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,75 @@
+# DateValues
+
+Value objects for `YearMonth`, `MonthDay`, and `TimeOfDay` — the date/time types Ruby is missing.
+
+Ruby has `Date`, `Time`, and `DateTime`, but no way to represent "March 2026" without picking a day, "March 19" without picking a year, or "14:30" without picking a date. DateValues fills that gap with immutable, `Comparable` value objects built on `Data.define`.
+
+## Installation
+
+```bash
+bundle add date_values
+```
+
+## Usage
+
+```ruby
+require 'date_values'
+include DateValues
+```
+
+### YearMonth
+
+```ruby
+ym = YearMonth.new(2026, 3)
+ym.to_s                          # => "2026-03"
+ym.to_date                       # => #<Date: 2026-03-01>
+
+YearMonth.parse('2026-03')       # => YearMonth[2026-03]
+
+ym + 1                           # => YearMonth[2026-04]
+ym - 1                           # => YearMonth[2026-02]
+YearMonth.new(2026, 3) - YearMonth.new(2025, 1)  # => 14
+
+# Range support
+(YearMonth.new(2026, 1)..YearMonth.new(2026, 3)).to_a
+# => [YearMonth[2026-01], YearMonth[2026-02], YearMonth[2026-03]]
+```
+
+### MonthDay
+
+```ruby
+md = MonthDay.new(3, 19)
+md.to_s                          # => "--03-19"
+md.to_date(2026)                 # => #<Date: 2026-03-19>
+
+MonthDay.parse('--03-19')        # => MonthDay[--03-19]
+```
+
+### TimeOfDay
+
+```ruby
+tod = TimeOfDay.new(14, 30)
+tod.to_s                         # => "14:30"
+
+TimeOfDay.new(14, 30, 45).to_s  # => "14:30:45"
+
+TimeOfDay.parse('14:30')         # => TimeOfDay[14:30]
+```
+
+## Rails Integration
+
+Opt-in ActiveModel type casting for ActiveRecord attributes:
+
+```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
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/lib/date_values/month_day.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'date'
+
+module DateValues
+  MonthDay = Data.define(:month, :day) do
+    include Comparable
+
+    def initialize(month:, day:)
+      raise ArgumentError, "invalid month: #{month}" unless (1..12).include?(month)
+      raise ArgumentError, "invalid day: #{day} for month: #{month}" unless (1..max_day(month)).include?(day)
+
+      super
+    end
+
+    def self.parse(str)
+      raise ArgumentError, "invalid MonthDay: #{str}" unless str.match?(/\A--\d{2}-\d{2}\z/)
+
+      month, day = str[2..].split('-').map(&:to_i)
+      new(month, day)
+    end
+
+    def <=>(other)
+      return nil unless other.is_a?(MonthDay)
+
+      [month, day] <=> [other.month, other.day]
+    end
+
+    def to_date(year)
+      Date.new(year, month, day)
+    end
+
+    def to_s
+      format('--%02d-%02d', month, day)
+    end
+
+    def inspect
+      "MonthDay[#{self}]"
+    end
+
+    private
+
+    def max_day(m)
+      case m
+      when 2 then 29
+      when 4, 6, 9, 11 then 30
+      else 31
+      end
+    end
+  end
+end

data/lib/date_values/rails/month_day_type.rb

@@ -0,0 +1,30 @@
+# 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
+        else raise ArgumentError, "can't cast #{value.class} to MonthDay"
+        end
+      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

@@ -0,0 +1,33 @@
+# 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
+        else raise ArgumentError, "can't cast #{value.class} to TimeOfDay"
+        end
+      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

@@ -0,0 +1,30 @@
+# 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
+        else raise ArgumentError, "can't cast #{value.class} to YearMonth"
+        end
+      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

@@ -0,0 +1,12 @@
+# 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'
+
+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)

data/lib/date_values/time_of_day.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module DateValues
+  TimeOfDay = Data.define(:hour, :minute, :second) do
+    include Comparable
+
+    def initialize(hour:, minute:, second: 0)
+      raise ArgumentError, "invalid hour: #{hour}" unless (0..23).include?(hour)
+      raise ArgumentError, "invalid minute: #{minute}" unless (0..59).include?(minute)
+      raise ArgumentError, "invalid second: #{second}" unless (0..59).include?(second)
+
+      super
+    end
+
+    def self.parse(str)
+      parts = str.split(':')
+      raise ArgumentError, "invalid TimeOfDay: #{str}" unless [2, 3].include?(parts.size)
+
+      new(*parts.map(&:to_i))
+    end
+
+    def <=>(other)
+      return nil unless other.is_a?(TimeOfDay)
+
+      [hour, minute, second] <=> [other.hour, other.minute, other.second]
+    end
+
+    def to_s
+      if second.zero?
+        format('%02d:%02d', hour, minute)
+      else
+        format('%02d:%02d:%02d', hour, minute, second)
+      end
+    end
+
+    def inspect
+      "TimeOfDay[#{self}]"
+    end
+  end
+end

data/lib/date_values/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module DateValues
+  VERSION = "0.1.0"
+end

data/lib/date_values/year_month.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'date'
+
+module DateValues
+  YearMonth = Data.define(:year, :month) do
+    include Comparable
+
+    def initialize(year:, month:)
+      raise ArgumentError, "invalid month: #{month}" unless (1..12).include?(month)
+
+      super
+    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)
+    end
+
+    def <=>(other)
+      return nil unless other.is_a?(YearMonth)
+
+      [year, month] <=> [other.year, other.month]
+    end
+
+    def +(n)
+      total = (year * 12 + (month - 1)) + n
+      self.class.new(total / 12, total % 12 + 1)
+    end
+
+    def -(other)
+      case other
+      when Integer
+        self + (-other)
+      when YearMonth
+        (year * 12 + month) - (other.year * 12 + other.month)
+      else
+        raise TypeError, "#{other.class} can't be coerced into Integer or YearMonth"
+      end
+    end
+
+    def succ
+      self + 1
+    end
+
+    def to_date
+      Date.new(year, month, 1)
+    end
+
+    def to_s
+      format('%04d-%02d', year, month)
+    end
+
+    def inspect
+      "YearMonth[#{self}]"
+    end
+  end
+end

data/lib/date_values.rb

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

data/sig/date_values/rails.rbs

@@ -0,0 +1,44 @@
+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

data/sig/date_values.rbs

@@ -0,0 +1,73 @@
+module DateValues
+  VERSION: String
+
+  class YearMonth
+    include Comparable
+
+    attr_reader year: Integer
+    attr_reader month: Integer
+
+    def initialize: (Integer year, Integer month) -> void
+
+    def self.parse: (String str) -> YearMonth
+
+    def <=>: (YearMonth other) -> Integer
+           | (untyped other) -> nil
+
+    def +: (Integer n) -> YearMonth
+
+    def -: (Integer n) -> YearMonth
+         | (YearMonth other) -> Integer
+
+    def succ: () -> YearMonth
+
+    def to_date: () -> Date
+
+    def to_s: () -> String
+
+    def inspect: () -> String
+  end
+
+  class MonthDay
+    include Comparable
+
+    attr_reader month: Integer
+    attr_reader day: Integer
+
+    def initialize: (Integer month, Integer day) -> void
+
+    def self.parse: (String str) -> MonthDay
+
+    def <=>: (MonthDay other) -> Integer
+           | (untyped other) -> nil
+
+    def to_date: (Integer year) -> Date
+
+    def to_s: () -> String
+
+    def inspect: () -> String
+
+    private
+
+    def max_day: (Integer m) -> Integer
+  end
+
+  class TimeOfDay
+    include Comparable
+
+    attr_reader hour: Integer
+    attr_reader minute: Integer
+    attr_reader second: Integer
+
+    def initialize: (Integer hour, Integer minute, ?Integer second) -> void
+
+    def self.parse: (String str) -> TimeOfDay
+
+    def <=>: (TimeOfDay other) -> Integer
+           | (untyped other) -> nil
+
+    def to_s: () -> String
+
+    def inspect: () -> String
+  end
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: date_values
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Keita Urashima
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+email:
+- ursm@ursm.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/date_values.rb
+- lib/date_values/month_day.rb
+- lib/date_values/rails.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
+metadata:
+  homepage_uri: https://github.com/ursm/date_values
+  source_code_uri: https://github.com/ursm/date_values
+  changelog_uri: https://github.com/ursm/date_values/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Value objects for YearMonth, MonthDay, and TimeOfDay
+test_files: []