bizdays-toolkit 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -4,11 +4,20 @@
 
 ## [Unreleased]
 
+## [0.11.1] - 2026-10-19
+
+ライブラリのコードは 0.11.0 と同じ。
+
+### Changed
+
+- README: よくある設定の例に、「その日が月の第何営業日か」（`businessDaysBetween` + 1。`nthBusinessDayOfMonth` の逆算）、「次の休業日と、その理由」（`daysBetween` で営業日でない最初の日）、「銀行の営業日」（3 行の設定。着金日は合成で求める）の 3 件を足した
+- CHANGELOG: 0.11.0 の「移行」に `docs/migration.md` への案内を足した（GitHub Release の本文は公開後に直してあり、これでリポジトリ側もそろう）
+
 ## [0.11.0] - 2026-10-19
 
 ### 移行
 
-作業は要りません（繰り返しの規則の新しい形と、カレンダーを合成する関数の追加）。
+作業は要りません（繰り返しの規則の新しい形と、カレンダーを合成する関数の追加）。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
 
 ### Added
 
@@ -291,7 +300,8 @@
 
 - 日本: 2026 年 2 月の官報（2027 年の春分・秋分の日）まで反映（`dataVersion: "2026-02"`、`confirmedThrough: 2027`）
 
-[Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.11.0...HEAD
+[Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.11.1...HEAD
+[0.11.1]: https://github.com/inohan77/bizdays-toolkit/compare/v0.11.0...v0.11.1
 [0.11.0]: https://github.com/inohan77/bizdays-toolkit/compare/v0.10.0...v0.11.0
 [0.10.0]: https://github.com/inohan77/bizdays-toolkit/compare/v0.9.1...v0.10.0
 [0.9.1]: https://github.com/inohan77/bizdays-toolkit/compare/v0.9.0...v0.9.1

package/README.md

@@ -296,6 +296,44 @@ const special = createSchedule<Hours>({
 special.valueOn("2027-01-01"); // null
 ```
 
+**Which business day of the month a date is**: count the business days from the first of the month up to (and excluding) the date, then add one. `businessDaysBetween` excludes `to`, so the date itself is the `+ 1`. This is the inverse of `nthBusinessDayOfMonth`.
+
+```ts
+import { monthOf } from "bizdays-toolkit";
+
+const calendar = createCalendar({ holidays: jp, closedWeekdays: [0, 6] });
+const businessDayIndex = (date: string): number =>
+  calendar.isBusinessDay(date) ? calendar.businessDaysBetween(`${monthOf(date)}-01`, date) + 1 : 0;
+businessDayIndex("2026-10-07"); // 5 (the 5th business day of October)
+businessDayIndex("2026-10-03"); // 0 (Saturday: not a business day)
+calendar.nthBusinessDayOfMonth("2026-10", 5); // "2026-10-07"
+```
+
+**The next closed day and why**: there is no `nextClosedDay`, but `daysBetween` returns `dayInfo` for every day, so take the first one that is not a business day.
+
+```ts
+import { addDays } from "bizdays-toolkit";
+
+const calendar = createCalendar({ holidays: jp, closedWeekdays: [0, 6] });
+const nextClosedDay = (date: string) =>
+  calendar.daysBetween(addDays(date, 1), addDays(date, 60)).find((d) => !d.businessDay);
+nextClosedDay("2026-10-05")?.date; // "2026-10-10"
+nextClosedDay("2026-10-05")?.reason; // "closed-weekday"
+nextClosedDay("2026-10-11")?.reason; // "holiday" (Sports Day, October 12)
+```
+
+**Business days of Japanese banks**: banks are closed on weekends, holidays and December 31 to January 3, so a bank calendar is three lines. Combine it with your own calendar for a remittance date (see "Combining calendars").
+
+```ts
+const bank = createCalendar({
+  holidays: jp,
+  closedWeekdays: [0, 6],
+  closedAnnual: [{ from: "12-31", to: "01-03", name: "Bank holiday period" }],
+});
+bank.isBusinessDay("2026-12-30"); // true
+bank.nextBusinessDay("2026-12-30"); // "2027-01-04"
+```
+
 **Build per-store calendars from shared options**: options are plain objects, so spread and extend them.
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bizdays-toolkit",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "Holidays, business-day calendar and day-by-day schedules (e.g. store hours) with time zone support. Japanese holidays verified against the Cabinet Office data; UK bank holidays (England, Wales, Scotland, Northern Ireland) verified against GOV.UK. / 祝日と営業日のカレンダー（タイムゾーン対応・日本の祝日は内閣府、英国の bank holidays は GOV.UK のデータで全日照合）",
   "keywords": [
     "bank-holidays",