zakuro 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4269bda9e7a1bc90589d072ac97a0acc089f098a5b1e8bbe6d04d661407c256
-  data.tar.gz: cb8821e9f1f9692a867c4baec73ce515281d3bf4ef8a04db676909d03cd3b7b0
+  metadata.gz: 73a145098928102269c600528b1552422d174c88a14baa83f8cc426deaa2ee43
+  data.tar.gz: 55d493cccce632e6d654394bee779be3756a628cf747d6c064583cc8c244ab55
 SHA512:
-  metadata.gz: f4acc077c7191f18601765cc81668660f4fe0af9dbeecf0af74cf0841f20546a0792484bbcc9bf8c490f62065ef8b32c9268def780037ec62739665823950d47
-  data.tar.gz: 97ea77400bd644d2c84e08e4d3056ee121563e5d52e1b418dfb57e50cbf5c741f4dde1954d4951460618b5c5837bc13103f8ae7857075b159a307986e2fb39af
+  metadata.gz: 9df9ca681cf42f72b574b888123d40a2368218c9077f7c03415ec4e50219489d16b8e5f285c1c17cdad3f88bae1c8ea460920c2469c17f381adf4bc54d654033
+  data.tar.gz: 8eb61f2f32029e649f2faf75e3d4592daf9c2b2da82216143f5586712f0d1fe50088677bed35e980a3e2ddf2a1be3712f101c4486dfa32261efd3ce5da9bf4d7

data/lib/zakuro/calculation/cycle/abstract_remainder.rb

@@ -10,6 +10,11 @@ module Zakuro
       # 大余小余（時刻情報）
       # @abstract 大余小余計算に必要な処理を行う、暦に依存しない汎用的なクラス
       #
+      # * 十干十二支（60日）を上限とした「日時分秒」の情報で、日付（date）/時刻（time）と部分的に重なる概念
+      # * 「15日1012分5秒」のような形式で表される
+      # * 分の上限で大余に繰り上げる
+      # * 秒の上限で1分に繰り上げる
+      #
       class AbstractRemainder # rubocop:disable Metrics/ClassLength
         # @return [Integer] 大余上限
         LIMIT = 60
@@ -224,8 +229,7 @@ module Zakuro
         # @return [False] より小さい
         #
         def >=(other)
-          up?(other) || \
-            (@day == other.day && @minute == other.minute && @second == other.second)
+          up?(other) || eql?(other)
         end
 
         #
@@ -249,8 +253,7 @@ module Zakuro
         # @return [False] より大きい
         #
         def <=(other)
-          down?(other) || \
-            (@day == other.day && @minute == other.minute && @second == other.second)
+          down?(other) || eql?(other)
         end
 
         #
@@ -339,10 +342,19 @@ module Zakuro
         # @return [Integer] 小余（秒切り捨て）
         #
         def floor_minute
-          result = @minute + @second / @base_minute
+          result = float_minute
           result.floor
         end
 
+        #
+        # 秒を含めた小余を返す
+        #
+        # @return [Float] 小余
+        #
+        def float_minute
+          @minute + @second.to_f / @base_minute
+        end
+
         #
         # 大余に四捨五入した結果を返す（秒は除外する）
         #
@@ -377,14 +389,19 @@ module Zakuro
           super(form, @day, @minute, @second)
         end
 
-        private
-
-        def carry!(day, minute, second)
-          @day, @minute, @second = carry(day, minute, second)
+        #
+        # 繰り上げる
+        #
+        # @return [AbstractRemainder] 繰り上げ結果
+        #
+        def carry!
+          @day, @minute, @second = carry(@day, @minute, @second)
 
           self
         end
 
+        private
+
         # 繰り上げ、繰り下げ
         def carry(param_day, param_minute, param_second)
           # NOTE: 計算方法としてマイナスでも徐算・剰余算の結果をプラス同様に扱う
@@ -437,33 +454,29 @@ module Zakuro
         def up?(other)
           invalid?(param: other)
           day = other.day
-          minute = other.minute
+          minute = other.float_minute
+
           return true if @day > day
           return false if @day < day
 
-          return true if @minute > minute
-          return false if @minute < minute
-
-          @second > other.second
+          float_minute > minute
         end
 
         def eql?(other)
           invalid?(param: other)
 
-          (@day == other.day && @minute == other.minute && @second == other.second)
+          (@day == other.day && float_minute == other.float_minute)
         end
 
         def down?(other)
           invalid?(param: other)
           day = other.day
-          minute = other.minute
+          minute = other.float_minute
+
           return true if @day < day
           return false if @day > day
 
-          return true if @minute < minute
-          return false if @minute > minute
-
-          @second < other.second
+          float_minute < minute
         end
       end
     end

data/lib/zakuro/calculation/stella/lunar/abstract_location.rb

@@ -46,6 +46,15 @@ module Zakuro
           # abstract
         end
 
+        #
+        # 1始まりの大余小余を取得する
+        #
+        # @return [Cycle::AbstractRemainder] 1始まりの大余小余
+        #
+        def adjusted_remainder
+          @remainder.add(Cycle::AbstractRemainder.new(day: 1, minute: 0, second: 0))
+        end
+
         private
 
         #
@@ -63,13 +72,6 @@ module Zakuro
         def decrease(limit:)
           # abstract
         end
-
-        #
-        # 1始まりにする
-        #
-        def one_based
-          @remainder.add!(Cycle::AbstractRemainder.new(day: 1, minute: 0, second: 0))
-        end
       end
     end
   end

data/lib/zakuro/calculation/stella/lunar/choukei_value.rb

@@ -30,6 +30,25 @@ module Zakuro
           day
         end
 
+        #
+        # 秒がない大余小余にする
+        #
+        # @param [Cycle::LunarRemainder] remainder 大余小余
+        #
+        # @note 815年で大余繰り上げあり
+        #
+        # @return [Integer] 大余
+        # @return [Float] 小余
+        #
+        def self.remainder_without_second(remainder:)
+          adjusted = remainder.class.new(
+            day: remainder.day, minute: remainder.floor_minute, second: 0
+          )
+          adjusted.carry!
+
+          [adjusted.day, adjusted.minute]
+        end
+
         def self.day_only(remainder_minute:, denominator:)
           float_day = Type::OldFloat.new(remainder_minute / denominator)
           # 切り捨て（プラスマイナスに関わらず小数点以下切り捨て）

data/lib/zakuro/era/japan/reki.rb

@@ -44,7 +44,7 @@ module Zakuro
           start_date: Western::Calendar.new(year: 698, month: 2, day: 16)
         ),
         Range.new(
-          class_name: 'Zakuro::Taien::Gateway',
+          class_name: 'Zakuro::Daien::Gateway',
           start_date: Western::Calendar.new(year: 764, month: 2, day: 7)
         ),
         Range.new(

data/lib/zakuro/version.rb

@@ -3,5 +3,5 @@
 # :nodoc:
 module Zakuro
   # @return [String] library version
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/zakuro/version/context.rb

@@ -11,7 +11,7 @@ module Zakuro
     attr_reader :version_name
     attr_reader :resolver
 
-    VERSION_NAMES = %w[Genka Gihou Taien Senmyou Joukyou Kansei Tenpou Gregorio].freeze
+    VERSION_NAMES = %w[Genka Gihou Daien Senmyou Joukyou Kansei Tenpou Gregorio].freeze
 
     def initialize(version_name:)
       raise ArgumentError.new, 'invalid version' unless VERSION_NAMES.include?(version_name)

data/lib/zakuro/version/daien/const/number.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Daien
+    #
+    # Const 定数
+    #
+    module Const
+      #
+      # Number 数値
+      #
+      module Number
+        #
+        # Cycle 周期
+        #
+        module Cycle
+          # @return [Integer] 通法（1日=3040分）
+          DAY = 3040
+          #
+          # @return [Float] 転日（1近点月 = 27日1685分79秒（1分=80秒））
+          # @note 小数点以下の値によって大幅に結果が変わる。除算結果を設定した
+          #
+          ANOMALISTIC_MONTH = 83_765 + (79.0 / 80)
+          # @return [Integer] 朔望月
+          SYNODIC_MONTH = 89_773
+          # @return [Integer] 一年
+          YEAR = 1_110_343
+        end
+
+        #
+        # Derivation 導出
+        #
+        module Derivation
+          # @return [Integer] 通余:  (YEAR - DAY * 12 * 30)
+          #   1110343 - 1094400
+          REMAINDER_ALL_YEAR = 15_943
+          # @return [Integer] 旬周（60日） DAY * 60
+          SIXTY_DAYS = 182_400
+        end
+
+        #
+        # 累積
+        #
+        module Stack
+          # @return [Integer] 積年（甲子夜半朔旦冬至〜暦の開始前）
+          TOTAL_YEAR = 96_961_740
+          # @return [Integer] 暦の開始年（開元12年）
+          BEGIN_YEAR = 724
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/version/daien/const/remainder.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative '../cycle/remainder'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Daien
+    #
+    # Const 定数
+    #
+    module Const
+      #
+      # Remainder 大余小余
+      #
+      module Remainder
+        #
+        # Solar 太陽
+        #
+        module Solar
+          # @return [Remainder] 気策（24分の1年）
+          # 1年（1_110_343） / 24 / 1日（3040）= 15 余り 664.2916666666642
+          #   * 0.2916666666642 * 24（1分=24秒） = 6.999999999940799 ≒ 7
+          SOLAR_TERM_AVERAGE = Cycle::Remainder.new(day: 15, minute: 664, second: 7)
+          #
+          # @note 揲法 89773 = 29-1613
+          #   * 89773 / 4 = 22443.25 / 3040 = 7 余り 1163.25
+          #   * 0.25 * 24（1分=24秒） = 6
+          #
+          # @return [Cycle::Remainder] 弦（1分=80秒）
+          QUARTER = Cycle::Remainder.new(day: 7, minute: 1163, second: 6)
+        end
+
+        #
+        # Lunar 月
+        #
+        module Lunar
+          # @return [Cycle::LunarRemainder] 転日（1近点月）
+          ANOMALISTIC_MONTH = \
+            Cycle::LunarRemainder.new(day: 27, minute: 1685, second: 79)
+          #
+          # @note 揲法 89773 = 29-1613
+          #   * 89773 / 4 = 22443.25 / 3040 = 7 余り 1163.25
+          #   * 0.25 * 80（1分=80秒） = 20
+          #
+          # @return [Cycle::LunarRemainder] 弦（1分=80秒）
+          # TODO: 秒が20では通らない。少なくとも0.01247は必要になる
+          QUARTER = Cycle::LunarRemainder.new(day: 7, minute: 1163, second: 20.01247)
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/version/daien/cycle/remainder.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative '../../../calculation/cycle/abstract_remainder'
+
+require_relative '../const/number'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Daien
+    # :nodoc:
+    module Cycle
+      #
+      # Remainder 時刻情報（大余小余）
+      #
+      class Remainder < Calculation::Cycle::AbstractRemainder
+        # 『歴代天文律暦等志彙編　七』中華書房 p.2056
+        # 「象統;二十四」「其秒盈象統,従小餘」
+        # 上記は舊唐志の記述だが、新唐志（p.2218）でも同様であることを確認した
+        # @return [Integer] 分（1分=24秒）
+        MINUTE = 24
+
+        #
+        # 初期化
+        #
+        # @param [Integer] day 大余（"日"に相当）
+        # @param [Integer] minute 小余（"分"に相当）
+        # @param [Integer] second 秒
+        # @param [Integer] total 繰り上げなしの小余
+        #
+        def initialize(day: -1, minute: -1, second: -1, total: -1)
+          super(base_day: Const::Number::Cycle::DAY, base_mitune: MINUTE,
+                day: day, minute: minute, second: second, total: total)
+        end
+      end
+
+      #
+      # LunarRemainder 月の位相計算向け時刻情報（大余小余）
+      #
+      class LunarRemainder < Calculation::Cycle::AbstractRemainder
+        # @return [Integer] 分（1分=80秒）
+        MINUTE = 80
+
+        #
+        # 初期化
+        #
+        # @param [Integer] day 大余（"日"に相当）
+        # @param [Integer] minute 小余（"分"に相当）
+        # @param [Integer] second 秒
+        # @param [Integer] total 繰り上げなしの小余
+        #
+        def initialize(day: -1, minute: -1, second: -1, total: -1)
+          super(base_day: Const::Number::Cycle::DAY, base_mitune: MINUTE,
+                day: day, minute: minute, second: second, total: total)
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/version/daien/cycle/solar_term.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative '../../../calculation/cycle/abstract_solar_term'
+
+require_relative '../const/remainder'
+
+require_relative './remainder'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Daien
+    # :nodoc:
+    module Cycle
+      #
+      # SolarTerm 二十四節気
+      #
+      class SolarTerm < Calculation::Cycle::AbstractSolarTerm
+        # @return [Remainder] 気策（24分の1年）
+        SOLAR_TERM_AVERAGE = Const::Remainder::Solar::SOLAR_TERM_AVERAGE
+
+        #
+        # 初期化
+        #
+        # @param [Integer] index 連番
+        # @param [Remainder] remainder 時刻情報（大余小余）
+        #
+        def initialize(index: -1, remainder: Remainder.new)
+          super(index: index, remainder: remainder, average: SOLAR_TERM_AVERAGE)
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/version/daien/daien.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative '../abstract_version'
+
+# :nodoc:
+module Zakuro
+  #
+  # Daien 大衍暦
+  #
+  module Daien
+    #
+    # Gateway アクセサメソッド群
+    #
+    class Gateway < AbstractVersion
+      # @return [True] リリースあり
+      RELEASE = true
+
+      # @return [String] 暦クラス名
+      VERSION_NAME = 'Daien'
+
+      #
+      # 西暦日から和暦日に変換する
+      #
+      # @param [Date] western_date 西暦日
+      #
+      # @return [Result::Single] 和暦日
+      #
+      def self.to_japan_date(western_date:)
+        date = Western::Calendar.create(date: western_date)
+
+        context = Context.new(version_name: VERSION_NAME)
+        Calculation::Summary::Single.get(context: context, date: date)
+      end
+    end
+  end
+end