zakuro 0.9.1 → 0.9.3

data/lib/zakuro/era/japan/gengou/resource/yaml/set-003-modern.yaml

@@ -5,16 +5,24 @@ last_year:
   japan: 7981
   western: 9999
 last_date:
-  japan: 令和7981年12月31日
-  western: '9999-12-31'
+  calculation:
+    japan: ''
+    western: ''
+  operation:
+    japan: 令和7981年12月31日
+    western: '9999-12-31'
 list:
 - name: 明治
   start_year:
     japan: 1
     western: 1868
   start_date:
-    japan: 明治01年09月08日
-    western: '1868-10-23'
+    calculation:
+      japan: ''
+      western: ''
+    operation:
+      japan: 明治01年09月08日
+      western: '1868-10-23'
   disuse:
     new_year_date: '1868-1-25'
     note: ''
@@ -23,8 +31,12 @@ list:
     japan: 1
     western: 1912
   start_date:
-    japan: 大正01年07月30日
-    western: '1912-7-30'
+    calculation:
+      japan: ''
+      western: ''
+    operation:
+      japan: 大正01年07月30日
+      western: '1912-7-30'
   disuse:
     new_year_date: '1912-1-1'
     note: ''
@@ -33,8 +45,12 @@ list:
     japan: 1
     western: 1926
   start_date:
-    japan: 昭和01年12月25日
-    western: '1926-12-25'
+    calculation:
+      japan: ''
+      western: ''
+    operation:
+      japan: 昭和01年12月25日
+      western: '1926-12-25'
   disuse:
     new_year_date: '1926-1-1'
     note: ''
@@ -43,8 +59,12 @@ list:
     japan: 1
     western: 2019
   start_date:
-    japan: 令和01年05月01日
-    western: '2019-5-1'
+    calculation:
+      japan: ''
+      western: ''
+    operation:
+      japan: 令和01年05月01日
+      western: '2019-5-1'
   disuse:
     new_year_date: '2019-1-1'
     note: ''

data/lib/zakuro/era/japan/gengou/resource.rb

@@ -27,6 +27,22 @@ module Zakuro
             __dir__
           ))
         ].freeze
+
+        # @return [Array<Set>] 元号セット情報リスト（運用値）
+        OPERATED_LIST = [
+          Parser.run(filepath: File.expand_path(
+            './resource/yaml/set-001-until-south.yaml',
+            __dir__
+          ), operated: true),
+          Parser.run(filepath: File.expand_path(
+            './resource/yaml/set-002-from-north.yaml',
+            __dir__
+          ), operated: true),
+          Parser.run(filepath: File.expand_path(
+            './resource/yaml/set-003-modern.yaml',
+            __dir__
+          ), operated: true)
+        ].freeze
       end
     end
   end

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

@@ -26,13 +26,15 @@ module Zakuro
         # @param [Integer] line 行番号
         # @param [Western::Calendar] start_date 開始日
         # @param [Western::Calendar] last_date 終了日
+        # @param [True, False] operated 運用値設定
         #
         # @return [Array<LinearGengou>] 該当行の元号
         #
         def line(line: FIRST_LINE,
-                 start_date: Western::Calendar.new, last_date: Western::Calendar.new)
+                 start_date: Western::Calendar.new, last_date: Western::Calendar.new,
+                 operated: false)
           Alignment.get(
-            line: line, start_date: start_date, last_date: last_date
+            line: line, start_date: start_date, last_date: last_date, operated: operated
           )
         end
 
@@ -42,11 +44,12 @@ module Zakuro
         # @param [Integer] line 行番号
         # @param [Western::Calendar] start_date 開始日
         # @param [Western::Calendar] last_date 終了日
+        # @param [True, False] operated 運用値設定
         #
         # @return [Array<LinearGengou>] 該当行の元号
         #
-        def line_by_name(line: FIRST_LINE, name:)
-          Alignment.get_by_name(line: line, name: name)
+        def line_by_name(line: FIRST_LINE, name:, operated: false)
+          Alignment.get_by_name(line: line, name: name, operated: operated)
         end
       end
     end

data/lib/zakuro/era/western/calendar.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative './date_text'
+
 require 'date'
 
 # :nodoc:
@@ -402,9 +404,7 @@ module Zakuro
         # @raise [ArgumentError] 引数エラー
         #
         def parse(text: '', type: Type::DEFAULT)
-          unless valid_date_string(text: text, type: type)
-            raise ArgumentError, "invalid date string: #{text}"
-          end
+          raise ArgumentError, "invalid date string: #{text}" unless valid_date_text(text: text)
 
           start = DATE_START.fetch(type, DATE_START[Type::DEFAULT])
           date = Date.parse(text, start)
@@ -423,14 +423,8 @@ module Zakuro
         # @return [True] 正しい
         # @return [True] 正しくない
         #
-        def valid_date_string(text: '', type: Type::DEFAULT)
-          start = DATE_START.fetch(type, DATE_START[Type::DEFAULT])
-          begin
-            Date.parse(text, start)
-          rescue ArgumentError => _e
-            return false
-          end
-          true
+        def valid_date_text(text: '')
+          DateText.validate(text: text)
         end
       end
     end

data/lib/zakuro/era/western/date_text.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  #
+  # Western 西暦
+  #
+  module Western
+    #
+    # DateText 日付文字列
+    #
+    module DateText
+      # @return [Regexp] ハイフン区切り
+      HYPHEN = /^[0-9]{1,5}-[0-9]{1,2}-[0-9]{1,2}$/.freeze
+      # @return [Regexp] スラッシュ区切り
+      SLASH = %r{^[0-9]{1,5}/[0-9]{1,2}/[0-9]{1,2}$}.freeze
+
+      #
+      # 有効な日付文字列か検証する
+      #
+      #  * 従来は Date.parse で日付文字列を検証していた
+      #  * [貞観4年3月20日] のような文字列でも有効扱いになっていた
+      #  * [20] [20日] のように2桁の数字が含まれると有効な日付扱いされる
+      #  * 特定のフォーマットのみ受け付けるように改変した
+      #
+      # @param [String] text 文字列
+      #
+      # @return [True] 有効
+      # @return [True] 無効
+      #
+      def self.validate(text: '')
+        return true if HYPHEN.match(text)
+
+        return true if SLASH.match(text)
+
+        false
+      end
+    end
+  end
+end

data/lib/zakuro/gateway/locale/date.rb

@@ -112,12 +112,12 @@ module Zakuro
         # @param [String] text 日付文字列
         #
         def parse_text(text:)
-          if Western::Calendar.valid_date_string(text: text)
+          if Western::Calendar.valid_date_text(text: text)
             @western_date = Western::Calendar.parse(text: text)
             return
           end
 
-          return unless Japan::Calendar.valid_date_string(text: text)
+          return unless Japan::Calendar.valid_date_text(text: text)
 
           @japan_date = Japan::Calendar.parse(text: text)
         end

data/lib/zakuro/operation/month/validator.rb

@@ -136,7 +136,13 @@ module Zakuro
           def western_date?(str: '')
             return Western::Calendar.new if str == EMPTY_STRING
 
-            Western::Calendar.valid_date_string(text: str)
+            # 1316-11-16/1317-4-13
+            dates = str.split('/')
+            dates.each do |date|
+              return true if Western::Calendar.valid_date_text(text: date)
+            end
+
+            false
           end
         end
       end

data/lib/zakuro/operation/yaml/month.yaml

@@ -3091,7 +3091,7 @@
         dest: "-"
       days:
         src: 大
-        dest: 小
+        dest: 大
     solar_term:
       src:
         index: "-"
@@ -11697,11 +11697,11 @@
   diffs:
     month:
       number:
-        src: "-"
-        dest: "-"
+        src: '8'
+        dest: '7'
       leaped:
-        src: "-"
-        dest: "-"
+        src: 'false'
+        dest: 'true'
       days:
         src: 大
         dest: 小
@@ -11730,11 +11730,11 @@
   diffs:
     month:
       number:
-        src: "-"
-        dest: "-"
+        src: '8'
+        dest: '8'
       leaped:
-        src: "-"
-        dest: "-"
+        src: 'true'
+        dest: 'false'
       days:
         src: 大
         dest: 大
@@ -15070,10 +15070,10 @@
   diffs:
     month:
       number:
-        src: '11'
+        src: '12'
         dest: '11'
       leaped:
-        src: 'true'
+        src: 'false'
         dest: 'false'
       days:
         src: 大
@@ -15102,11 +15102,11 @@
   diffs:
     month:
       number:
-        src: "-"
-        dest: "-"
+        src: '12'
+        dest: '12'
       leaped:
-        src: "-"
-        dest: "-"
+        src: 'true'
+        dest: 'false'
       days:
         src: 大
         dest: 大

data/lib/zakuro/output/logger.rb

@@ -9,6 +9,7 @@ module Zakuro
     # @note 本番では使用しない
     #
     class Logger
+      # @return [Hash<Symbol, Integer>] ログレベル
       LEVELS = {
         none: -1,
         debug: 0,
@@ -17,6 +18,7 @@ module Zakuro
         error: 3
       }.freeze
 
+      # @return [Integer] 現在ログレベル
       LEVEL = LEVELS[:none]
 
       # @return [String] 呼び出し位置
@@ -32,7 +34,9 @@ module Zakuro
       # @param [String] messages メッセージ
       #
       def debug(*messages)
-        return if LEVEL < LEVELS[:debug]
+        return if none?
+
+        return if LEVEL >= LEVELS[:debug]
 
         output('DEBUG', *messages)
       end
@@ -43,7 +47,9 @@ module Zakuro
       # @param [String] messages メッセージ
       #
       def info(*messages)
-        return if LEVEL < LEVELS[:info]
+        return if none?
+
+        return if LEVEL >= LEVELS[:info]
 
         output('INFO', *messages)
       end
@@ -55,7 +61,9 @@ module Zakuro
       # @param [String] messages メッセージ
       #
       def error(error, *messages)
-        return if LEVEL < LEVELS[:error]
+        return if none?
+
+        return if LEVEL >= LEVELS[:error]
 
         output('ERROR', *messages)
         output('ERROR', error.message)
@@ -64,6 +72,16 @@ module Zakuro
 
       private
 
+      #
+      # 出力なしか
+      #
+      # @return [True] 出力なし
+      # @return [False] 出力あり
+      #
+      def none?
+        LEVEL < LEVELS[:debug]
+      end
+
       #
       # 標準出力を行う
       #

data/lib/zakuro/tools/remainder_comparer.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative '../output/logger'
+
+require_relative '../calculation/cycle/abstract_remainder'
+
+# :nodoc:
+module Zakuro
+  #
+  # Tools 汎用メソッド群
+  #
+  module Tools
+    #
+    # RemainderComparer 大余小余比較
+    #
+    module RemainderComparer
+      LOGGER = Output::Logger.new(location: 'RemainderComparer')
+
+      class << self
+        #
+        # 大余を基準に範囲チェックをする
+        #
+        # 次のパターンで用いる
+        # 1. 月内（当月朔日から当月末日（来月朔日の前日）の間）に二十四節気があるか
+        #   * target: 二十四節気
+        #   * start: 当月朔日
+        #   * last: 次月朔日
+        # 2. ある二十四節気に対象の日があるか
+        #   * target: 対象の日
+        #   * start: 二十四節気
+        #   * last: 次の二十四節気
+        #
+        # @param [Calcuration::Cycle::AbstractRemainder] target 対象日
+        # @param [Calcuration::Cycle::AbstractRemainder] start 範囲開始
+        # @param [Calcuration::Cycle::AbstractRemainder] last 範囲終了
+        #
+        # @return [True] 対象日がある
+        # @return [False] 対象日がない
+        #
+        def in_range?(target:, start:, last:)
+          # 『日本暦日便覧』では下記5日を没日ありとしている
+          #  これは二十四節気の小余と秒が0の場合に限って、範囲を翌日にずらすことを指している
+          #
+          # * 貞観12年7月18日
+          # * 天喜5年3月11日
+          # * 寛元1年11月4日
+          # * 永享2年7月26日
+          # * 元和3年3月19日
+          #
+          last_day = last.only_day? ? last.day + 1 : last.day
+          in_range_day?(target: target.day, start: start.day, last: last_day)
+        end
+
+        #
+        # 大余を基準に範囲チェックをする
+        #
+        # @param [Calcuration::Cycle::AbstractRemainder] target 対象日
+        # @param [Calcuration::Cycle::AbstractRemainder] start 範囲開始
+        # @param [Integer] limit 大余上限
+        #
+        # @return [True] 対象日がある
+        # @return [False] 対象日がない
+        #
+        def in_limit?(target:, start:, limit:)
+          last_day = start.add_day(limit).day
+
+          in_range_day?(target: target.day, start: start.day, last: last_day)
+        end
+
+        private
+
+        #
+        # 大余を基準に範囲チェックをする
+        #
+        # @note 大余60で一巡するため 以下2パターンがある
+        #   * start <= last : (二十四節気) >= start && (二十四節気) < last
+        #   * start > last  : (二十四節気) >= start || (二十四節気) < last
+        #
+        # @param [Integer] target 対象日
+        # @param [Integer] start 範囲開始
+        # @param [Integer] last 範囲終了
+        #
+        # @return [True] 対象日がある
+        # @return [False] 対象日がない
+        #
+        def in_range_day?(target:, start:, last:)
+          start_over = (target >= start)
+          last_under = (target < last)
+
+          return start_over && last_under if start <= last
+
+          start_over || last_under
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zakuro
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.3
 platform: ruby
 authors:
 - pldb
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-11-25 00:00:00.000000000 Z
+date: 2023-03-25 00:00:00.000000000 Z
 dependencies: []
 description: mainly lunar solar calendar
 email:
@@ -86,6 +86,9 @@ files:
 - lib/zakuro/calculation/monthly/const.rb
 - lib/zakuro/calculation/monthly/first_day.rb
 - lib/zakuro/calculation/monthly/initialized_month.rb
+- lib/zakuro/calculation/monthly/meta.rb
+- lib/zakuro/calculation/monthly/meta/all_solar_term.rb
+- lib/zakuro/calculation/monthly/meta/meta_collector.rb
 - lib/zakuro/calculation/monthly/month.rb
 - lib/zakuro/calculation/monthly/month_label.rb
 - lib/zakuro/calculation/monthly/operated_month.rb
@@ -143,6 +146,7 @@ files:
 - lib/zakuro/era/japan/gengou/resource/yaml/set-003-modern.yaml
 - lib/zakuro/era/japan/version.rb
 - lib/zakuro/era/western/calendar.rb
+- lib/zakuro/era/western/date_text.rb
 - lib/zakuro/exception/case/pattern.rb
 - lib/zakuro/exception/case/preset.rb
 - lib/zakuro/exception/case/template.rb
@@ -180,6 +184,7 @@ files:
 - lib/zakuro/result/operation/month/annotation.rb
 - lib/zakuro/result/operation/month/history.rb
 - lib/zakuro/result/result.rb
+- lib/zakuro/tools/remainder_comparer.rb
 - lib/zakuro/tools/stringifier.rb
 - lib/zakuro/tools/typeconv.rb
 - lib/zakuro/tools/typeof.rb