ya_kansuji 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97f2f4c063933b7c86ede7c11d8d34704e612f7eb4e82e2f60f469d8aa8ded4c
-  data.tar.gz: 4aa55c66f2d6b5ae168278e0b2b1a096e062ae1a3e96d31bcb118f415c184bb0
+  metadata.gz: 2ebbcd000d7dd15c3c1438fffa073ee979cda4ae3f74cc898fbe6bab3d0f2308
+  data.tar.gz: 1674ffc3d50bc2748f7700e1faa0d579ef1d4d98fdd6830a0b1f7486adc7c169
 SHA512:
-  metadata.gz: 0203eaef1b77450bd6ea5c9666cf695bfe72fd7fb21d966d18bb177fa38db3ca500dff690841c3f1b5d25b9406c62f7bf38a90be98f6c5983f5df68fe65df8cb
-  data.tar.gz: 7a420d832dbd4da1149ac293820dca4f510226c53513bc1f579d2fa889cc8b16708f717406c76be8937f21623090eaf7d073896234296598e40e36a8275091ae
+  metadata.gz: 29b3931d46062d1874d25db90d1dc62ae9f633d0328e23f704e661f85ea81816d348afed00d6bc27be90eb9e5b0d7c57c8e9a288bdd5d8727900982354fe5cd3
+  data.tar.gz: d3b04eeff5270d76b509ad9ecd0742bc26767066c488259a666650fb1fd11d45bac4604761fa99420614c17ff5313550787d6ddd1281243555501337c8781e61

data/ChangeLog

@@ -1,3 +1,13 @@
+2026-07-14  Tatsuki Sugiura  <sugi@nemui.org>
+
+	* Version: 1.3.0
+	* Support fractional numbers (Float / Rational / BigDecimal) on
+	  to_kan, using Japanese small number units (分 厘 毛 ... 清浄)
+	* Fractions are rounded at 10^-21; floats are interpreted by their
+	  shortest decimal representation (to_s)
+	* All builtin formatters render fractions in their own style
+	* Add Numeric#to_kan to core extensions and refinements
+
 2026-07-14  Tatsuki Sugiura  <sugi@nemui.org>
 
 	* Version: 1.2.0

data/README.md

@@ -23,9 +23,10 @@ YaKansuji は ruby 用の日本語の漢数字ライブラリです。 和暦ラ
   * カンマ表現 (12,345 / 5億3,456万 / 二万、五十)
   * 負数 (マイナス五十)
 * 数値から漢数字, 漢字混じり数値文字列フォーマット
+  * 小数 (分厘毛〜清浄)
   * 複数のビルトインフォーマッタ
   * フォーマッタプラグイン機構
-* (オプション) 標準の String, Interger クラスの拡張
+* (オプション) 標準の String, Numeric クラスの拡張
 
 ## インストール
 
@@ -62,6 +63,23 @@ YaKansuji.to_kan(-12345) # => マイナス一万二千三百四十五
 対応する値域は `-(10**72 - 1)` から `10**72 - 1` です。
 数値として整数化した値がこの範囲を超える場合、`RangeError` が発生します。
 
+#### 小数
+
+Float・Rational・BigDecimal を渡すと、小数の命数法 (分 = 10⁻¹ 〜 清浄 = 10⁻²¹) で小数部を出力します。
+10⁻²¹ より小さい部分は四捨五入されます。
+
+```ruby
+YaKansuji.to_kan(0.5)               # => "五分"
+YaKansuji.to_kan(123.456)           # => "百二十三・四分五厘六毛"
+YaKansuji.to_kan(3.14159, :judic_v) # => "三・一四一五九"
+YaKansuji.to_kan(123.456, :gov)     # => "123.456"
+YaKansuji.to_kan(1.05, :judic_h)    # => "１．０５"
+```
+
+Float は `to_s` の最短表現として解釈されるため、`0.1` は正確に「一分」になります。
+逆に浮動小数点演算の誤差はそのまま出力されます (`0.1 + 0.2` → `0.30000000000000004` → 「三分四弾指」)。
+誤差を避けたい場合は Rational か BigDecimal を渡してください。
+
 このさい、2つめの引数にシンボルを渡すことにより、フォーマッタを切り替えることができます。
 
 ```ruby
@@ -84,7 +102,9 @@ YaKansuji.to_kan(12340005, :judic_h) # => "１２３４万０００５"
 
 `YaKansuji#register_formatter` を使うと独自のフォーマッタを登録できます。
 `#call` を持つ任意のオブジェクトもしくはブロックを渡します。第1引数に数字、第2引数にオプションが渡ります。
-負数を渡した場合も、フォーマッタには絶対値 (非負整数) が渡され、符号 (「マイナス」) は `to_kan` 側で前置されます。
+負数を渡した場合も、フォーマッタには絶対値 (非負の値) が渡され、符号 (「マイナス」) は `to_kan` 側で前置されます。
+小数を含む値を渡した場合、フォーマッタには正規化済みの値
+(整数なら Integer、小数を含むなら Rational) がそのまま渡ります。
 
 ```ruby
 YaKansuji.register_formatter :hoge, -> (num, opts = {}) {
@@ -100,14 +120,14 @@ YaKansuji.to_kan(123, :hoge)   # => "たくさん"
 
 ### 標準クラス拡張
 
-標準では YaKansuji の特異メソッドを直接呼ぶことで使用できますが、短く書く場合、必要応じてビルトインクラス (String, Integer) の拡張を使うことができます。
+標準では YaKansuji の特異メソッドを直接呼ぶことで使用できますが、短く書く場合、必要応じてビルトインクラス (String, Numeric) の拡張を使うことができます。
 
-クラス拡張では `String#to_i` を置き換え、 `Integer#to_kan` を追加します。
+クラス拡張では `String#to_i` を置き換え、`Numeric#to_kan` を追加します。
 拡張の方法は、Refinements と直接拡張の好きな方を選択できます。
 
 #### [Refinements](https://docs.ruby-lang.org/en/2.6.0/syntax/refinements_rdoc.html) による拡張
 
-`YaKansuji::CoreRefine` を using すると、 `String#to_i` を置き換え、 `Integer#to_kan` を追加します。
+`YaKansuji::CoreRefine` を using すると、 `String#to_i` を置き換え、 `Numeric#to_kan` を追加します。
 
 ```ruby
 puts "二万".to_i     # => 0
@@ -117,6 +137,7 @@ using YaKansuji::CoreRefine
 puts "二万".to_i     # => 20000
 puts 20000.to_kan   #= > "二万"
 puts 20000.to_kan(:gov) # => "2万"
+puts 0.5.to_kan # => "五分"
 ```
 
 ちなみに、 `to_i` に base が渡された場合は、漢数字が解釈されずにビルトインクラスのものが呼ばれます。

data/lib/ya_kansuji/core_ext/numeric.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'ya_kansuji'
+
+# Core extension by kansuji
+class Numeric
+  def to_kan(formatter = :simple, options = {})
+    YaKansuji.to_kan self, formatter, options
+  end
+end

data/lib/ya_kansuji/core_ext.rb

@@ -2,3 +2,4 @@
 
 require 'ya_kansuji/core_ext/string'
 require 'ya_kansuji/core_ext/integer'
+require 'ya_kansuji/core_ext/numeric'

data/lib/ya_kansuji/core_refine.rb

@@ -18,6 +18,12 @@ module YaKansuji
         YaKansuji.to_kan self, formatter, options
       end
     end
+
+    refine Numeric do
+      def to_kan(formatter = :simple, options = {})
+        YaKansuji.to_kan self, formatter, options
+      end
+    end
   end
 end
 

data/lib/ya_kansuji/formatter/gov.rb

@@ -7,13 +7,15 @@ module YaKansuji
       module_function
 
       def call(num, _options = {})
-        return '0' if num.zero?
+        int, frac = Formatter.split_fraction(num)
+        frac.empty? ? frac_part = nil : frac_part = ".#{frac.join}"
+        return frac_part ? "0#{frac_part}" : '0' if int.zero?
 
         parts = []
-        chunks = Formatter.split_by_unit4(num)
+        chunks = Formatter.split_by_unit4(int)
         (chunks.size - 1).downto(0) do |idx4|
           i4 = chunks[idx4]
-          next if i4.zero?
+          next if i4.zero? && !(idx4.zero? && frac_part)
 
           unit4 = Formatter::UNIT4_UNITS[idx4]
           if i4 == 1
@@ -22,7 +24,9 @@ module YaKansuji
           end
           parts << (i4.to_s + unit4)
         end
-        parts.join(', ')
+        ret = parts.join(', ')
+        ret << frac_part if frac_part
+        ret
       end
     end
     YaKansuji.register_formatter :gov, Formatter::Gov

data/lib/ya_kansuji/formatter/judic_h.rb

@@ -8,14 +8,15 @@ module YaKansuji
       module_function
 
       def call(num, _options = {})
-        return '０' if num.zero?
+        int, frac = Formatter.split_fraction(num)
+        return '０' if int.zero? && frac.empty?
 
         ret = +''
         head = true
-        chunks = Formatter.split_by_unit4(num)
+        chunks = Formatter.split_by_unit4(int)
         (chunks.size - 1).downto(0) do |idx4|
           i4 = chunks[idx4]
-          next if i4.zero?
+          next if i4.zero? && !(idx4.zero? && !frac.empty?)
 
           unit4 = Formatter::UNIT4_UNITS[idx4]
           if head
@@ -25,6 +26,7 @@ module YaKansuji
           end
           head = false
         end
+        ret << '．' << frac.join unless frac.empty?
         ret.tr('0-9', '０-９')
       end
       YaKansuji.register_formatter :judic_h, self

data/lib/ya_kansuji/formatter/judic_v.rb

@@ -8,14 +8,15 @@ module YaKansuji
       module_function
 
       def call(num, _options = {})
-        return '〇' if num.zero?
+        int, frac = Formatter.split_fraction(num)
+        return '〇' if int.zero? && frac.empty?
 
         ret = +''
         head = true
-        chunks = Formatter.split_by_unit4(num)
+        chunks = Formatter.split_by_unit4(int)
         (chunks.size - 1).downto(0) do |idx4|
           i4 = chunks[idx4]
-          next if i4.zero?
+          next if i4.zero? && !(idx4.zero? && !frac.empty?)
 
           unit4 = Formatter::UNIT4_UNITS[idx4]
           if head
@@ -25,6 +26,7 @@ module YaKansuji
           end
           head = false
         end
+        ret << '・' << frac.join unless frac.empty?
         ret.tr('0-9', '〇一二三四五六七八九')
       end
       YaKansuji.register_formatter :judic_v, self

data/lib/ya_kansuji/formatter/lawyer.rb

@@ -8,13 +8,15 @@ module YaKansuji
       module_function
 
       def call(num, _options = {})
-        return '0' if num.zero?
+        int, frac = Formatter.split_fraction(num)
+        frac.empty? ? frac_part = nil : frac_part = ".#{frac.join}"
+        return frac_part ? "0#{frac_part}" : '0' if int.zero?
 
         ret = +''
-        chunks = Formatter.split_by_unit4(num)
+        chunks = Formatter.split_by_unit4(int)
         (chunks.size - 1).downto(0) do |idx4|
           i4 = chunks[idx4]
-          next if i4.zero?
+          next if i4.zero? && !(idx4.zero? && frac_part)
 
           unit4 = Formatter::UNIT4_UNITS[idx4]
           if i4 == 1
@@ -24,6 +26,7 @@ module YaKansuji
 
           ret << ((i4 >= 1000 ? "#{i4.to_s[0]},#{i4.to_s[1..-1]}" : i4.to_s) + unit4)
         end
+        ret << frac_part if frac_part
         ret
       end
       YaKansuji.register_formatter :lawyer, self

data/lib/ya_kansuji/formatter/simple.rb

@@ -10,10 +10,11 @@ module YaKansuji
       module_function
 
       def call(num, _options = {})
-        return '零' if num.zero?
+        int, frac = Formatter.split_fraction(num)
+        return '零' if int.zero? && frac.empty?
 
         ret = nil
-        chunks = Formatter.split_by_unit4(num)
+        chunks = Formatter.split_by_unit4(int)
         (chunks.size - 1).downto(0) do |idx4|
           i4 = chunks[idx4]
           next if i4.zero?
@@ -40,6 +41,13 @@ module YaKansuji
           end
           ret << unit4
         end
+        unless frac.empty?
+          ret << '・' if ret
+          ret ||= +''
+          frac.each_with_index do |d, idx|
+            ret << DIGITS[d - 1] << UNIT_FRAC[idx] unless d.zero?
+          end
+        end
         ret || ''
       end
       YaKansuji.register_formatter :simple, self

data/lib/ya_kansuji/formatter.rb

@@ -6,6 +6,7 @@ module YaKansuji
     UNIT4_BASE = 10_000
     UNIT4_CHUNK_LIMIT = UNIT_EXP4.size + 1
     UNIT4_UNITS = ([''] + UNIT_EXP4).freeze
+    EMPTY_FRACTION = [].freeze
 
     module_function
 
@@ -18,5 +19,21 @@ module YaKansuji
       end
       chunks
     end
+
+    def split_fraction(num)
+      num = YaKansuji.normalize_value(num)
+      raise ArgumentError, 'Value must be non-negative' if num.negative?
+
+      return [num, EMPTY_FRACTION] if num.is_a?(Integer)
+
+      int = num.truncate
+      scaled = ((num - int) * FRAC_BASE).to_i
+      digits = []
+      UNIT_FRAC.size.times do
+        scaled, d = scaled.divmod(10)
+        digits.unshift(d) unless digits.empty? && d.zero?
+      end
+      [int, digits]
+    end
   end
 end

data/lib/ya_kansuji/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module YaKansuji
-  VERSION = '1.2.0'
+  VERSION = '1.3.0'
 end

data/lib/ya_kansuji.rb

@@ -7,6 +7,9 @@ module YaKansuji
   UNIT_EXP3 = %w(十 百 千).freeze
   UNIT_EXP4 = %w(万 億 兆 京 垓 𥝱 穣 溝 澗 正 載 極 恒河沙 阿僧祇 那由他 不可思議 無量大数).freeze
   MAX_VALUE = (10_000**(UNIT_EXP4.size + 1)) - 1
+  UNIT_FRAC = %w(分 厘 毛 糸 忽 微 繊 沙 塵 埃 渺 漠
+                 模糊 逡巡 須臾 瞬息 弾指 刹那 六徳 虚空 清浄).freeze
+  FRAC_BASE = 10**UNIT_FRAC.size
   NUM_ALT_CHARS = '〇一二三四五六七八九０１２３４５６７８９零壱壹弌弐貳貮参參弎肆伍陸漆質柒捌玖拾什陌佰阡仟萬秭'
   NUM_NORMALIZED_CHARS = '01234567890123456789011122233345677789十十百百千千万𥝱'
   # rubocop:disable Lint/DuplicateRegexpCharacterClassElement
@@ -81,6 +84,44 @@ module YaKansuji
     matched[0].start_with?('マイナス') ? -ret : ret
   end
 
+  def normalize_value(num)
+    return num if num.is_a?(Integer)
+
+    unless num.is_a?(Numeric)
+      return num._to_i_ya_kansuji_orig if num.respond_to?(:_to_i_ya_kansuji_orig)
+
+      return num.to_i
+    end
+
+    return num.to_i unless num.respond_to?(:truncate)
+
+    num = rational_from_float(num) if num.is_a?(Float)
+    num = num.to_r if num.respond_to?(:to_r)
+    int = num.truncate
+    scaled = ((num - int) * FRAC_BASE).round
+    if scaled.abs >= FRAC_BASE
+      if scaled.negative?
+        int -= 1
+      else
+        int += 1
+      end
+      scaled = 0
+    end
+    scaled.zero? ? int : Rational((int * FRAC_BASE) + scaled, FRAC_BASE)
+  end
+
+  def rational_from_float(num)
+    raise FloatDomainError, num.to_s if num.nan? || num.infinite?
+
+    m = /\A(-?)(\d+)(?:\.(\d+))?(?:e([+-]?\d+))?\z/.match(num.to_s)
+    raise FloatDomainError, num.to_s unless m
+
+    ret = Rational(Integer(m[2] + (m[3] || ''), 10))
+    ret = -ret unless m[1].empty?
+    exp = (m[4] ? Integer(m[4], 10) : 0) - (m[3] ? m[3].size : 0)
+    exp >= 0 ? ret * (10**exp) : ret / (10**-exp)
+  end
+
   def register_formatter(sym, proc = nil, &block)
     if block_given?
       @@formatters[sym] = block
@@ -100,8 +141,8 @@ module YaKansuji
   end
 
   def to_kan(num, formatter = :simple, options = {})
-    num.respond_to?(:_to_i_ya_kansuji_orig) ? num = num._to_i_ya_kansuji_orig : num = num.to_i
-    if num.abs > MAX_VALUE
+    num = normalize_value(num)
+    if num.truncate.abs > MAX_VALUE
       raise RangeError, "Value must be between #{-MAX_VALUE} and #{MAX_VALUE}"
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ya_kansuji
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Tatsuki Sugiura
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-13 00:00:00.000000000 Z
+date: 2026-07-14 00:00:00.000000000 Z
 dependencies: []
 description: |
   Pure ruby library of Japanese kansuji.
@@ -25,6 +25,7 @@ files:
 - lib/ya_kansuji.rb
 - lib/ya_kansuji/core_ext.rb
 - lib/ya_kansuji/core_ext/integer.rb
+- lib/ya_kansuji/core_ext/numeric.rb
 - lib/ya_kansuji/core_ext/string.rb
 - lib/ya_kansuji/core_refine.rb
 - lib/ya_kansuji/formatter.rb