wareki 1.1.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00264c0e982ca9fc5ddddf077d222e473281f09ae91d1fb4cfc5cd0b445c200a
-  data.tar.gz: 90d886bb8ef63e259e24134ccaeaf3df0722ebc415e15c932f5a6d770a93de55
+  metadata.gz: 1559659acd73e0b2e1760b9d5d889f59f7ac592ec6ff357ebe17e9631398cd18
+  data.tar.gz: 9c2271acf0e4522b2bc69b00abe579e6ae10299d6d560bbd987bd88581ad578a
 SHA512:
-  metadata.gz: 8b06ba92792afd6213be68dc40a836f1b7799e8e836052ce3ff17c036a7f33770a8319dc1e714a07168485c791b8e682622bfb5f21e2905696a35fa355a55892
-  data.tar.gz: ad8e3fd61fe9a697d13c90eeead0f3fdc6b973591f9cb99624e609224c326b1a3f8c775ef0d55b8ffbfc408285eb841fbee918d76bcb33fd0c7a03a45e86e766
+  metadata.gz: b6e16627c6d96af8128ecba167c59c077970373f1f37dfac0f156b88478869a29d8fe04e0bcf91c77dacd482c32cc1493b6aaa2cd065915b5a6c1696a293d450
+  data.tar.gz: bc6ba557cff73de604dc895f95b60f0baa4ecd82c8796b1b8e3c23cb9f6395c004c213d01ea781a92a7c72145e53772cdaba0d0302ccf2585a3a20e6a2cb9c8f

data/ChangeLog

@@ -1,3 +1,69 @@
+2026-07-13  Tatsuki Sugiura  <sugi@nemui.org>
+
+	* Version: 2.1.0
+	* Shrink in-memory kyuureki calendar table to ~1/48 (bit-packed
+	  one-integer-per-year representation in new internal module
+	  Wareki::Calendar); calendar definitions now load ~30x faster
+	* Era definitions are now generated from manakai/data-locale
+	  era-defs.json instead of the Wikipedia era list page
+	  (build-util/gen-era-def.rb); corrects 正平/建徳/文中 boundaries,
+	  白雉/朱鳥 now cover until the end of their last kyuureki year,
+	  and ERA_NORTH_DEFS 元徳 now ends at 正慶 transition
+	* Wareki.parse_to_date and patched Date.parse/_parse no longer
+	  fall back to stdlib parsing on UnsupportedDateRange; the error
+	  propagates again as in 1.x (reverts a 2.0.0 change)
+	* Cache kansuji conversion of small numbers for %J format
+	  directives; Utils.to_simple_kan delegates non-Integer values
+	  to YaKansuji
+	* Fast-path ASCII-only strings in patched Date.parse/Date._parse
+	* Remove internal constants Wareki::YEAR_DEFS, Wareki::YEAR_BY_NUM,
+	  Wareki::Year and Wareki::Utils.find_year
+	* required_ruby_version is now >= 2.3
+
+2026-07-13  Tatsuki Sugiura  <sugi@nemui.org>
+
+	* Version: 2.0.0
+	* Time.parse now understands Japanese kansuji/zenkaku time notations
+	  (十二時三十四分五十六秒, 午後三時半, 正午, ...) via the patched
+	  Date._parse; Date.parse no longer misreads bare 時分秒 strings
+	* Add %JT* time format directives (%JTf/%JTF/%JTH(k)/%JTM(k)/%JTS(k));
+	  Time#strftime now supports all %J directives and DateTime#strftime
+	  expands %JT too; add Time#to_wareki_date
+	* Strict date validation: nonexistent dates now raise
+	  Wareki::InvalidDate (< ArgumentError) (month/day out of range,
+	  nonexistent leap month, and the Meiji 5 December calendar-switch
+	  gap for all era notations); patched Date.parse re-raises it
+	  instead of falling back to stdlib misinterpretation
+	* README: document that conversion from Date/jd prefers northern court
+	  eras during the Nanboku-cho period (previous statement was wrong;
+	  behavior unchanged from 1.1.0)
+	* Update kyuureki calendar data (regenerated from
+	  manakai/data-locale); corrects month boundaries of some
+	  historical years
+	* Wareki::Date#- returns day count for date-like operands;
+	  #+ raises TypeError for non-numeric operands (stdlib parity)
+	* Support date calculation with ActiveSupport::Duration
+	  (was NotImplementedError)
+	* Add Wareki::Date#hash, #<=>, Comparable and #succ
+	* Invalidate cached jd on attribute writes; writers keep
+	  year/era_year consistent
+	* Freeze era definition structs to prevent accidental mutation
+	  of shared state
+	* Fix imperial_year= setter (sign error)
+	* Parse apostrophe leap-month markers so %Jf/%Jm output round-trips
+	* Fix misokka (晦日) parsing for 皇紀/西暦/紀元前/era-less dates
+	* DateTime#strftime now supports %J directives
+	* Escaped %%J or invalid %J sequences no longer trigger conversion;
+	  Wareki::Date#strftime honors %% escapes too
+	* Fast-path non-wareki strings in patched Date.parse/_parse
+	* Wareki.parse_to_date falls back on UnsupportedDateRange too
+	* Fix deprecated Utils.i_to_kan (was calling undefined method)
+	* gemspec: SPDX license identifier (BSD-2-Clause)
+
+	[ by masa.kunikata <masa.kunikata@gmail.com> ]
+	* Add zero padding format feature
+	* Use zero padded format on default
+
 2019-12-24  Tatsuki Sugiura  <sugi@nemui.org>
 
 	* Version: 1.1.0

data/README.md

@@ -1,16 +1,16 @@
 # wareki - ruby 和暦ライブラリ
 
 [<img src="https://badge.fury.io/rb/wareki.svg" alt="Gem Version" />](https://badge.fury.io/rb/wareki)
-[<img src="https://travis-ci.org/sugi/wareki.svg?branch=master" alt="Build Status" />](https://travis-ci.org/sugi/wareki)
-[<img src="https://coveralls.io/repos/sugi/wareki/badge.svg?branch=master&service=github" alt="Coverage Status" />](https://coveralls.io/github/sugi/wareki?branch=master)
+[<img src="https://github.com/sugi/wareki/actions/workflows/ci.yml/badge.svg" alt="Build Status" />](https://github.com/sugi/wareki/actions/workflows/ci.yml)
+[<img src="https://coveralls.io/repos/github/sugi/wareki/badge.svg?branch=master" alt="Coverage Status" />](https://coveralls.io/github/sugi/wareki?branch=master)
 [<img src="https://api.codeclimate.com/v1/badges/c9209422700b526d2b45/maintainability" />](https://codeclimate.com/github/sugi/wareki/maintainability)
-[![Codacy Badge](https://api.codacy.com/project/badge/Grade/9242ddf1725c404aac2d9f82b9bc1d75)](https://www.codacy.com/app/sugi/wareki?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=sugi/wareki&amp;utm_campaign=Badge_Grade)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/a5e0b6022b6d485b86a195be7a392da5)](https://app.codacy.com/gh/sugi/wareki/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
 
 ## 概要
 
 日本の和暦をサポートするライブラリです。
 旧暦は445年から、元号は大化から全て処理できます。
-元号はWikipedia、暦は日本暦日原典由来のデータを元にしています。
+元号・暦とも [manakai/data-locale](https://github.com/manakai/data-locale) のデータを元にしています (暦は日本暦日原典由来)。
 
 ## 機能
 
@@ -20,10 +20,15 @@
   * 閏月サポート
   * 月の別名のサポート (如月、弥生、師走など)
   * 元年、正月、朔日、晦日、廿一日、卅日 などの特殊な表記の日付サポート
+  * 時刻の漢数字・全角数字表記のサポート (十二時三十四分五十六秒、午後三時半、正午 など)
 * Date クラスの拡張
   * 標準の strftime に和暦へのフォーマット文字列を追加
   * to_wareki_date を追加
   * Date::JAPAN (明治改暦日)の追加
+* Time / DateTime クラスの拡張
+  * strftime に時刻の全角・漢数字フォーマット文字列 (%JT 系) を追加
+  * Time.parse で和暦・漢数字時刻の文字列を解釈 (要 `require 'time'`)
+  * Time#to_wareki_date を追加
 
 ## インストール
 
@@ -71,6 +76,20 @@ Wareki::Date.parse("正嘉元年 うるう3月 １２日") # => Wareki::Date イ
 Wareki::Date.new("明治", 8, 2, 1).to_date   # => 標準 Date インスタンス 1875-02-01
 ```
 
+### 時刻のパースとフォーマット
+
+時刻の漢数字・全角数字表記も透過的に扱えます。時刻には暦のようなマッピングは
+存在しないため、単純な数字変換として処理されます。
+
+```ruby
+require 'time'
+t = Time.parse("平成元年五月四日 午後三時三十四分五十六秒")
+# => 1989-05-04 15:34:56
+t.strftime("%JF %JTF")       # => "平成元年五月四日 十五時三十四分五十六秒"
+t.strftime("%JTf")           # => "15時34分56秒"
+t.strftime("%JTHk時%JTMk分") # => "十五時三十四分"
+```
+
 ### 和暦・旧暦へのフォーマット
 
 日本では明治5年まで、グレゴリオ暦でもユリウス歴でもない旧暦が使われていました。これもフォーマット文字列経由で透過的に扱えます。
@@ -154,6 +173,18 @@ strftime が拡張されるので、 `config/locale/ja.yml` にそのままフ
 * %JDk: 和暦日の漢数字
 * %JDK: 和暦日の漢数字の特殊記法 (朔、晦)
 
+以下の時刻フォーマット文字列は Time / DateTime の strftime でのみ使用できます
+(Date は時刻情報を持たないため展開されません)。
+
+* %JTf: "%JTH時%JTM分%JTS秒" 相当の半角ゼロ埋め複合表記 (例: 15時04分05秒)
+* %JTF: 漢数字の複合表記 (例: 十五時四分五秒)
+* %JTH: 時の全角数字
+* %JTHk: 時の漢数字
+* %JTM: 分の全角数字
+* %JTMk: 分の漢数字
+* %JTS: 秒の全角数字
+* %JTSk: 秒の漢数字
+
 ## 仕様、限界、制限など
 
 * 作者は暦の専門家ではまったくありません。ツッコミお待ちしています。
@@ -162,18 +193,25 @@ strftime が拡張されるので、 `config/locale/ja.yml` にそのままフ
 * 日本暦日原典の対照表が、どの暦法を元にしているのか分かっていません。単にデータだけを利用しています。
 * 内部的には全てユリウス日を経由して変換しています。
 * パース時には元号の存在しない年(例: 霊亀百年)を受け入れます。しかし現状、Date に変換した場合この情報は捨てられ、パース時の元号を復元することはできません。(Wareki::Date を直接扱えば可能です)
-* 改暦による存在しない日(明治5年12月3日〜31日)は基本的に例外(ArgumentError)を上げます。が、現状このチェックは完全ではありません。
-* 北朝の元号も解釈できます。しかし現在の所、北朝の元号で文字列にフォーマットすることはできません。
+* 存在しない日付(月・日の範囲超過、存在しない閏月、改暦により存在しない明治5年12月3日〜31日など)は例外(Wareki::InvalidDate, ArgumentError のサブクラス)を上げます。
+* 南朝・北朝どちらの元号も解釈できます。Date やユリウス日からの変換では、南北朝期は通常の慣例に従い北朝の元号を優先します(元弘・延元など、北朝側の改元前で北朝に固有の元号がない期間は南朝の元号になります)。
+* 元号の開始日より前の日付表記(例: 令和元年1月1日)は受理し、その元号の元年として解釈します。逆変換では実際の元号(平成31年1月1日)になります。
 * 10月の別名は「神無月」しかサポートしていません
 * 将来の日付に関しては、現在の元号がずっと継続しているとみなします
 * 日本でユリウス暦は使われていないので、Date::JAPAN は単にグレゴリオ暦への改暦日の目安、と言うだけです。Date.new で使う意味はほぼありません。
+* 時刻の解釈・出力は単純な数字変換のみで、十二時辰などの伝統的時刻制度との対応はありません
+* 時刻パース時、「午前」は無変換、「午後」は12時未満の時にのみ+12します (午後十二時 → 12:00)
+* 「三時間」「13時代」のような「数字+時」を含む複合語も時刻として解釈されることがあります (このため、従来 Date.parse が数字を日として解釈して成功していた文字列がエラーになる場合があります)
+* 範囲外の時刻 (二十五時など) は ASCII 表記 (25:00) と同様に扱われ、Time.parse では通常 ArgumentError になります
+* 和暦・漢数字時刻のパース対応は Date.parse / Date._parse / Time.parse のみです。DateTime.parse は Ruby 内部のパーサを直接呼ぶため対象外です
 
 ## 参照元データ
 
 作成には以下のデータを参照しました。
 
-* 旧暦: [suikawiki - 旧暦](http://wiki.suikawiki.org/n/%E6%97%A7%E6%9A%A6#section-%E5%AF%BE%E7%85%A7%E8%A1%A8%E3%81%A8%E5%A4%89%E6%8F%9B%E3%83%84%E3%83%BC%E3%83%AB) にある「日本暦日原典」第4版準拠の先発グレゴリオ暦対照表
-* 元号: [Wikipedia - 元号一覧_(日本)](https://ja.wikipedia.org/wiki/%E5%85%83%E5%8F%B7%E4%B8%80%E8%A6%A7_%28%E6%97%A5%E6%9C%AC%29) のユリウス歴とグレゴリオ暦表記の物に基づいています
+* Wakaba 氏による https://github.com/manakai/data-locale のデータを利用しています
+  * 旧暦: [suikawiki - 旧暦](http://wiki.suikawiki.org/n/%E6%97%A7%E6%9A%A6#section-%E5%AF%BE%E7%85%A7%E8%A1%A8%E3%81%A8%E5%A4%89%E6%8F%9B%E3%83%84%E3%83%BC%E3%83%AB) にある「日本暦日原典」第4版準拠の先発グレゴリオ暦対照表 (kyuureki-map.txt)
+  * 元号: 同リポジトリの元号定義データ (era-defs.json)
 
 ## ライセンス
 

data/lib/wareki/calendar.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require 'wareki/calendar_def'
+
+module Wareki
+  # 旧暦テーブルの参照ロジック。1年分の旧暦情報は整数1個 (40bit) に
+  # ビットパックされている。PACKED[西暦年 - YEAR_MIN]:
+  #   bits 0..21  : その年の最初の月の初日のユリウス通日 (JD)
+  #   bits 22..34 : 月の大小マスク (bit i = i 番目の月が大の月 = 30日)
+  #   bit  35     : 閏月を含む13ヶ月の年なら1
+  #   bits 36..39 : 閏月の月番号 (1..12、閏月がなければ0)
+  # 明治5年12月 (テーブル最終月) はグレゴリオ暦切替のため LAST_MONTH_DAYS
+  # (= 2) 日で打ち切られており、大小マスクには反映されていない。
+  module Calendar
+    module_function
+
+    def covers_year?(year)
+      year.between?(YEAR_MIN, YEAR_MAX)
+    end
+
+    def covers_jd?(jd)
+      jd.between?(JD_MIN, JD_MAX)
+    end
+
+    # 閏月の月番号。閏月のない年・範囲外の年は nil
+    def leap_month(year)
+      covers_year?(year) or return nil
+      lp = PACKED[year - YEAR_MIN] >> 36
+      lp == 0 ? nil : lp
+    end
+
+    # 月番号 (1始まり) を月配列添字 (閏月込み・0始まり) に変換する。
+    # year がテーブル範囲内であることは呼び出し側が保証すること。
+    def month_index(year, month, is_leap)
+      lp = leap_month(year)
+      idx = month - 1
+      is_leap || (lp && month > lp) and idx += 1
+      idx
+    end
+
+    def last_day_of_month(year, month, is_leap)
+      covers_year?(year) or return nil
+      packed = PACKED[year - YEAR_MIN]
+      idx = month_index(year, month, is_leap)
+      months = 12 + ((packed >> 35) & 1)
+      return LAST_MONTH_DAYS if year == YEAR_MAX && idx == months - 1
+
+      29 + ((packed >> (22 + idx)) & 1)
+    end
+
+    def to_jd(year, month, day, is_leap)
+      covers_year?(year) or return nil
+      packed = PACKED[year - YEAR_MIN]
+      idx = month_index(year, month, is_leap)
+      jd = packed & 0x3fffff
+      i = 0
+      while i < idx
+        jd += 29 + ((packed >> (22 + i)) & 1)
+        i += 1
+      end
+      jd + day - 1
+    end
+
+    # jd を [西暦年, 月, 日, 閏月フラグ] に変換する。範囲外は nil
+    def find_date_ary(jd)
+      covers_jd?(jd) or return nil
+      i = PACKED.bsearch_index { |packed| (packed & 0x3fffff) > jd }
+      if i.nil?
+        i = PACKED.size - 1
+      else
+        i -= 1
+      end
+      packed = PACKED[i]
+      month_start = packed & 0x3fffff
+      months = 12 + ((packed >> 35) & 1)
+      lp = packed >> 36
+      idx = 0
+      while idx < months - 1
+        next_start = month_start + 29 + ((packed >> (22 + idx)) & 1)
+        break if jd < next_start
+
+        month_start = next_start
+        idx += 1
+      end
+      month = idx + 1
+      month -= 1 if lp != 0 && lp < month
+      [YEAR_MIN + i, month, jd - month_start + 1, lp != 0 && lp == idx]
+    end
+  end
+end