minimum_wage_jp

日本の地域別最低賃金（都道府県別）をシンプルに扱うための Rust クレートです。

特徴

• 指定日の最低賃金（円）を取得
• 指定時給が最低賃金を満たすか判定（不足額も算出）
• 年度（改定年）を指定して率を取得
• データは埋め込み済み、適用開始日前は前年データに自動フォールバック

インストール

[dependencies]
minimum_wage_jp = "1"

クイックスタート

use chrono::NaiveDate;
use minimum_wage_jp::{MinimumWageJp, MinimumWageJpCompliance};

// 都道府県コード: 1 = 北海道, 13 = 東京都, 47 = 沖縄県
let hokkaido: u8 = 1;

// 今日の最低賃金（円）を取得
let rate_today = MinimumWageJp::rate(hokkaido).unwrap();
println!("今日の最低賃金: {}円", rate_today);

// 指定日の最低賃金（円）を取得
let date = NaiveDate::from_ymd_opt(2025, 10, 4).unwrap();
let rate = MinimumWageJp::rate_on_date(date, hokkaido).unwrap();
assert_eq!(rate, 1075);

// 時給が最低賃金を満たすか判定
let result = MinimumWageJp::is_compliant_on_date(date, hokkaido, 1020).unwrap();
match result {
    MinimumWageJpCompliance::Compliant => println!("OK"),
    MinimumWageJpCompliance::Short { shortage_yen, required_yen } => {
        println!("不足: {}円 (必要: {}円)", shortage_yen, required_yen);
    }
}

API

最低賃金の取得

コンプライアンス判定

戻り値の型

enum MinimumWageJpCompliance {
    Compliant,                                    // 最低賃金を満たしている
    Short { shortage_yen: u32, required_yen: u32 } // 不足あり
}

エラー型

都道府県コード

JIS X 0401 に準拠した 1〜47 の数値コードを使用します。

データセット

同梱データ

仕様

• 指定日に適用される最新の年版を自動選択
• 都道府県ごとの適用開始日が異なる場合、適用日前は前年版にフォールバック
  • 例: 北海道の 2025 年版適用開始日は 2025-10-04
• 最初の年版より前の日付を指定した場合はエラーを返却

タイムゾーンについて

rate() および is_compliant() は chrono::Local を使用してローカル日付を取得します。 サーバ・クライアント間でタイムゾーンが異なる環境では、rate_on_date() / is_compliant_on_date() の使用を推奨します。

テスト

cargo test

貢献

新しい年版の追加や適用開始日の修正は src/dataset.rs を編集してください。 変更時はテストも併せて更新し、フォールバック仕様が正しく動作することを確認してください。

ライセンス

MIT License