使い方

インストール

npm install jp-money-data

現在値を取得する

各データセットは有効期間つきの slices を持ちます。現行スライス（effectiveTo === null）は currentSlice() で取れます。

import { koyoHokenKihonTeate, currentSlice, resolveSlice } from 'jp-money-data'

// 現行スライス
const now = currentSlice(koyoHokenKihonTeate)
console.log(now.values.teateUpper.under30) // 7255

// 基準日で解決（過去日の値も引ける）
const at = resolveSlice(koyoHokenKihonTeate, '2025-09-01')
console.log(at?.effectiveFrom) // '2025-08-01'

resolveSlice(ds, 'YYYY-MM-DD') は基準日に適用されるスライスを返します（収録範囲外の過去日は null、不正な日付形式は RangeError）。

データセット単位で import（tree-shaking）

import { koseiNenkin } from 'jp-money-data/datasets/kosei-nenkin'

CDN / 生JSON

ビルドを介さず生の JSON を取得できます（@0.1.0 のようにバージョン固定も可能）。推奨は jsDelivr（npm ミラー・自前APIなし）:

https://cdn.jsdelivr.net/npm/jp-money-data@0/data/labor/koyo-hoken-kihon-teate.json

GitHub raw も利用できます（リポジトリ公開後）:

https://raw.githubusercontent.com/<owner>/jp-money-data/main/data/labor/koyo-hoken-kihon-teate.json

型

すべてのデータセットは Dataset<T> 型で、値型 T はデータセット毎にエクスポートされています。金額は整数円、率は小数、日付は YYYY-MM-DD に正規化されています。詳細はスキーマ仕様を参照してください。