@suzukihayate/jp-holidays 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hayate Suzuki (鈴木颯)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# jp-holidays
+
+日本の祝日を**計算で求める**、依存ゼロのライブラリです。祝日のデータファイルを毎年更新する必要がありません。
+
+- 固定日・ハッピーマンデー（成人の日・海の日・敬老の日・スポーツの日）
+- **春分の日・秋分の日**（天文近似式）
+- **振替休日**（祝日が日曜のとき）・**国民の休日**（祝日に挟まれた平日）
+- **五輪特例**（2020/2021 の海の日・スポーツの日・山の日の移動）
+- 依存ゼロ・型定義つき・ESM をそのまま import
+
+対応範囲：**1980〜2099 年**（春分・秋分の近似式が有効な範囲）。
+
+## インストール
+```bash
+npm install @suzukihayate/jp-holidays
+```
+
+## 使い方
+```js
+import { holidays, isHoliday, holidayName } from '@suzukihayate/jp-holidays';
+
+holidays(2024);
+// [ { date: 2024-01-01, name: '元日' },
+//   { date: 2024-01-08, name: '成人の日' }, ... 振替休日も含む ]
+
+isHoliday('2024-05-03');   // true
+isHoliday('2024-06-02');   // false
+holidayName('2024-05-06'); // "振替休日"
+```
+
+## API
+- `holidays(year)` — その年の祝日を `{ date, name }[]`（日付順）で返す
+- `isHoliday(input)` — `Date` / `"YYYY-MM-DD"` が祝日か
+- `holidayName(input)` — 祝日名（祝日でなければ `null`）
+
+## 正確性
+2024 年の全祝日（振替休日含む）、2020 年の五輪特例、国民の休日などをテストで検証しています（`node --test`）。春分・秋分は 1980〜2099 年で官報の確定日と一致する近似式を使用しています。
+
+## License
+MIT © 2026 Hayate Suzuki

package/index.d.ts

@@ -0,0 +1,24 @@
+export interface Holiday {
+  /** 祝日の日付（ローカルタイムの Date）。 */
+  date: Date;
+  /** 祝日名（例: "元日"、"振替休日"）。 */
+  name: string;
+}
+
+export type DateInput = Date | string;
+
+/** 指定年（1980〜2099）の祝日を計算して返す（日付順）。 */
+export function holidays(year: number): Holiday[];
+
+/** 日付（Date / "YYYY-MM-DD"）が祝日か判定する。 */
+export function isHoliday(input: DateInput): boolean;
+
+/** 日付が祝日ならその名称、そうでなければ null を返す。 */
+export function holidayName(input: DateInput): string | null;
+
+declare const _default: {
+  holidays: typeof holidays;
+  isHoliday: typeof isHoliday;
+  holidayName: typeof holidayName;
+};
+export default _default;

package/index.js

@@ -0,0 +1,141 @@
+// jp-holidays — 日本の祝日を「計算」で求める依存ゼロのライブラリ（データファイル不要）。
+//   - 固定日・ハッピーマンデー・春分/秋分（天文近似）
+//   - 振替休日（祝日が日曜の場合）・国民の休日（祝日に挟まれた平日）
+//   - 五輪特例（2020/2021 の海の日・スポーツの日・山の日の移動）
+// 対応範囲: 1980〜2099 年（春分・秋分の近似式が有効な範囲）。
+
+const MIN_YEAR = 1980;
+const MAX_YEAR = 2099;
+
+const pad = (n) => String(n).padStart(2, '0');
+const ymd = (d) => `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+
+/** 指定月の第n月曜日。 */
+function nthMonday(year, month, nth) {
+  const firstDow = new Date(year, month - 1, 1).getDay(); // 0=日
+  const firstMon = 1 + ((1 - firstDow + 7) % 7);
+  return new Date(year, month - 1, firstMon + (nth - 1) * 7);
+}
+
+/** 春分の日（1980-2099 の近似式）。 */
+function shunbun(y) {
+  return Math.floor(20.8431 + 0.242194 * (y - 1980) - Math.floor((y - 1980) / 4));
+}
+/** 秋分の日（1980-2099 の近似式）。 */
+function shubun(y) {
+  return Math.floor(23.2488 + 0.242194 * (y - 1980) - Math.floor((y - 1980) / 4));
+}
+
+/** その年の「国民の祝日」（振替・国民の休日を除く本来の祝日）を求める。 */
+function baseHolidays(y) {
+  const list = [];
+  const add = (month, day, name) => list.push({ month, day, name });
+
+  add(1, 1, '元日');
+  add(...mdOf(nthMonday(y, 1, 2)), '成人の日'); // 2000年以降。本ライブラリは1980-2099対応なので常にハッピーマンデー
+  add(2, 11, '建国記念の日');
+  if (y >= 2020) add(2, 23, '天皇誕生日');
+  else add(12, 23, '天皇誕生日'); // 1989-2018（2019は無し→下で除外）
+  if (y === 2019) {
+    // 2019年は天皇誕生日なし
+    for (let i = list.length - 1; i >= 0; i--) if (list[i].name === '天皇誕生日') list.splice(i, 1);
+  }
+  add(3, shunbun(y), '春分の日');
+  add(4, 29, '昭和の日'); // 2007年以降（本対応範囲では常に昭和の日）
+  add(5, 3, '憲法記念日');
+  add(5, 4, 'みどりの日'); // 2007年以降
+  add(5, 5, 'こどもの日');
+
+  // 海の日
+  if (y === 2020) add(7, 23, '海の日');
+  else if (y === 2021) add(7, 22, '海の日');
+  else add(...mdOf(nthMonday(y, 7, 3)), '海の日'); // 2003年以降
+
+  // スポーツの日（旧・体育の日）
+  const sportsName = y >= 2020 ? 'スポーツの日' : '体育の日';
+  if (y === 2020) add(7, 24, sportsName);
+  else if (y === 2021) add(7, 23, sportsName);
+  else add(...mdOf(nthMonday(y, 10, 2)), sportsName);
+
+  // 山の日（2016年以降）
+  if (y >= 2016) {
+    if (y === 2020) add(8, 10, '山の日');
+    else if (y === 2021) add(8, 8, '山の日');
+    else add(8, 11, '山の日');
+  }
+
+  add(...mdOf(nthMonday(y, 9, 3)), '敬老の日'); // 2003年以降
+  add(9, shubun(y), '秋分の日');
+  add(11, 3, '文化の日');
+  add(11, 23, '勤労感謝の日');
+
+  return list.map((h) => ({ date: new Date(y, h.month - 1, h.day), name: h.name }))
+             .sort((a, b) => a.date - b.date);
+}
+
+function mdOf(date) { return [date.getMonth() + 1, date.getDate()]; }
+
+/**
+ * 指定年の祝日を計算して返す（日付順）。
+ * @param {number} year 1980〜2099
+ * @returns {{ date: Date, name: string }[]}
+ */
+export function holidays(year) {
+  const y = Number(year);
+  if (!Number.isInteger(y) || y < MIN_YEAR || y > MAX_YEAR) {
+    throw new RangeError(`jp-holidays: 対応年は ${MIN_YEAR}〜${MAX_YEAR} です（指定: ${year}）`);
+  }
+
+  const base = baseHolidays(y);
+  const map = new Map(base.map((h) => [ymd(h.date), h.name]));
+
+  // 国民の休日（前後が祝日の平日。1986年以降）
+  if (y >= 1986) {
+    const start = new Date(y, 0, 1), end = new Date(y, 11, 31);
+    for (let d = new Date(start); d <= end; d.setDate(d.getDate() + 1)) {
+      const k = ymd(d);
+      if (map.has(k) || d.getDay() === 0) continue;
+      const prev = new Date(d); prev.setDate(prev.getDate() - 1);
+      const next = new Date(d); next.setDate(next.getDate() + 1);
+      if (map.has(ymd(prev)) && map.has(ymd(next))) {
+        base.push({ date: new Date(d), name: '国民の休日' });
+        map.set(k, '国民の休日');
+      }
+    }
+  }
+
+  // 振替休日（祝日が日曜のとき、次の祝日でない日。1973年以降＝本対応範囲では常に有効）
+  const result = base.slice().sort((a, b) => a.date - b.date);
+  for (const h of result.slice()) {
+    if (h.date.getDay() !== 0) continue;
+    const sub = new Date(h.date);
+    do { sub.setDate(sub.getDate() + 1); } while (map.has(ymd(sub)));
+    base.push({ date: new Date(sub), name: '振替休日' });
+    map.set(ymd(sub), '振替休日');
+  }
+
+  return base.sort((a, b) => a.date - b.date);
+}
+
+/** 日付（Date / "YYYY-MM-DD"）が祝日か判定する。 */
+export function isHoliday(input) {
+  return holidayName(input) !== null;
+}
+
+/** 日付が祝日ならその名称、そうでなければ null を返す。 */
+export function holidayName(input) {
+  let d;
+  if (input instanceof Date) d = input;
+  else if (typeof input === 'string') {
+    const m = input.match(/^(\d{4})-(\d{1,2})-(\d{1,2})/);
+    if (!m) throw new TypeError('jp-holidays: 日付は Date か "YYYY-MM-DD" で指定してください。');
+    d = new Date(+m[1], +m[2] - 1, +m[3]);
+  } else {
+    throw new TypeError('jp-holidays: 日付は Date か "YYYY-MM-DD" で指定してください。');
+  }
+  const key = ymd(d);
+  for (const h of holidays(d.getFullYear())) if (ymd(h.date) === key) return h.name;
+  return null;
+}
+
+export default { holidays, isHoliday, holidayName };

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@suzukihayate/jp-holidays",
+  "version": "0.1.0",
+  "description": "日本の祝日を計算で求める依存ゼロのライブラリ。春分・秋分、ハッピーマンデー、振替休日、国民の休日、五輪特例に対応。",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  },
+  "files": ["index.js", "index.d.ts", "README.md", "LICENSE"],
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": ["japanese-holidays", "祝日", "holidays", "japan", "calendar", "振替休日", "国民の休日", "zero-dependency"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HaYaTedonn/jp-holidays.git"
+  },
+  "author": "Hayate Suzuki",
+  "license": "MIT",
+  "engines": { "node": ">=18" },
+  "sideEffects": false
+}