Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

minimum_wage_jp — 日本の地域別最低賃金 Rust ライブラリ

Crates.io Documentation CI License: MIT

日本の地域別最低賃金(47都道府県別の最低賃金一覧・2015〜2025年度対応)を扱う Rust クレートです。 指定日に適用される最低賃金(時給)の取得と、時給が最低賃金を満たすかの判定(不足額の算出つき)ができます。 データは厚生労働省の公式発表に基づいて埋め込み済みのため、外部通信・API キー・設定ファイルは不要です。

English: A Rust crate for Japan's regional minimum wage (地域別最低賃金) by prefecture. Look up the legally required hourly minimum wage for any date — per-prefecture effective dates are handled with automatic fallback to the previous revision — and check whether a given hourly wage complies (with shortage calculation). Official data from the Ministry of Health, Labour and Welfare (MHLW) is embedded; no network access required.

特徴

  • 指定日の最低賃金(円)を取得
  • 指定時給が最低賃金を満たすか判定(不足額も算出)
  • 年度(改定年)を指定して率を取得
  • データは埋め込み済み、都道府県ごとの発効日を考慮し、発効日前は前年データに自動フォールバック

インストール

[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);
    }
}

実行可能なサンプルは examples/basic.rscargo run --example basic)にあります。

API

最低賃金の取得

メソッド 説明
rate(pref: u8) 今日の最低賃金(円)を取得
rate_on_date(date: NaiveDate, pref: u8) 指定日の最低賃金(円)を取得
rate_for_revision(year: u16, pref: u8) 指定年版(改定年)の最低賃金を取得

コンプライアンス判定

メソッド 説明
is_compliant(pref: u8, hourly_yen: u32) 今日の時給が最低賃金を満たすか判定
is_compliant_on_date(date: NaiveDate, pref: u8, hourly_yen: u32) 指定日の時給が最低賃金を満たすか判定

戻り値の型

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

エラー型

エラー 説明
InvalidPrefCode(u8) 都道府県コードが 1〜47 の範囲外
DatasetNotFoundForDate { date, prev, next } 指定日のデータが存在しない
DatasetNotFoundForYear { year } 指定年版のデータが存在しない

詳細な API ドキュメントは docs.rs/minimum_wage_jp を参照してください。

都道府県別 最低賃金一覧(2025年度・2024年度)

都道府県コードは JIS X 0401 に準拠した 1〜47 の数値コードです。 2025年版(令和7年度)の発効日は都道府県により異なります。

コード 都道府県 2025年版(円) 2025年版 発効日 2024年版(円)
1 北海道 1,075 2025-10-04 1,010
2 青森県 1,029 2025-11-21 953
3 岩手県 1,031 2025-12-01 952
4 宮城県 1,038 2025-10-04 973
5 秋田県 1,031 2026-03-31 951
6 山形県 1,032 2025-12-23 955
7 福島県 1,033 2026-01-01 955
8 茨城県 1,074 2025-10-12 1,005
9 栃木県 1,068 2025-10-01 1,004
10 群馬県 1,063 2026-03-01 985
11 埼玉県 1,141 2025-11-01 1,078
12 千葉県 1,140 2025-10-03 1,076
13 東京都 1,226 2025-10-03 1,163
14 神奈川県 1,225 2025-10-04 1,162
15 新潟県 1,050 2025-10-02 985
16 富山県 1,062 2025-10-12 998
17 石川県 1,054 2025-10-08 984
18 福井県 1,053 2025-10-08 984
19 山梨県 1,052 2025-12-01 988
20 長野県 1,061 2025-10-03 998
21 岐阜県 1,065 2025-10-18 1,001
22 静岡県 1,097 2025-11-01 1,034
23 愛知県 1,140 2025-10-18 1,077
24 三重県 1,087 2025-11-21 1,023
25 滋賀県 1,080 2025-10-05 1,017
26 京都府 1,122 2025-11-21 1,058
27 大阪府 1,177 2025-10-16 1,114
28 兵庫県 1,116 2025-10-04 1,052
29 奈良県 1,051 2025-11-16 986
30 和歌山県 1,045 2025-11-01 980
31 鳥取県 1,030 2025-10-04 957
32 島根県 1,033 2025-11-17 962
33 岡山県 1,047 2025-12-01 982
34 広島県 1,085 2025-11-01 1,020
35 山口県 1,043 2025-10-16 979
36 徳島県 1,046 2026-01-01 980
37 香川県 1,036 2025-10-18 970
38 愛媛県 1,033 2025-12-01 956
39 高知県 1,023 2025-12-01 952
40 福岡県 1,057 2025-11-16 992
41 佐賀県 1,030 2025-11-21 956
42 長崎県 1,031 2025-12-01 953
43 熊本県 1,034 2026-01-01 952
44 大分県 1,035 2026-01-01 954
45 宮崎県 1,023 2025-11-16 952
46 鹿児島県 1,026 2025-11-01 953
47 沖縄県 1,023 2025-12-01 952

データセット

同梱データ

年版 発効日(都道府県により異なる)
2015(平成27年度) 2015-10-01 〜 2015-10-18
2016(平成28年度) 2016-10-01 〜 2016-10-20
2017(平成29年度) 2017-09-30 〜 2017-10-14
2018(平成30年度) 2018-10-01 〜 2018-10-06
2019(令和元年度) 2019-10-01 〜 2019-10-06
2020(令和2年度) 2020-10-01 〜 2020-10-09 ※
2021(令和3年度) 2021-10-01 〜 2021-10-08
2022(令和4年度) 2022-10-01 〜 2022-10-20
2023(令和5年度) 2023-10-01 〜 2023-10-14
2024(令和6年度) 2024-10-01 〜 2024-11-01
2025(令和7年度) 2025-10-01 〜 2026-03-31

※ 2020年版はコロナ禍の影響で 7 都道府県(北海道・東京・静岡・京都・大阪・広島・山口)が 据え置き(改定なし)となりました。据え置きの都道府県は便宜上 2020-10-01 を発効日として 収録していますが、前年版と同額のため取得結果は全期間で連続します。

出典: 厚生労働省「地域別最低賃金の全国一覧」厚生労働省「過去5年間の賃金推移」

仕様

  • 指定日に適用される最新の年版を自動選択
  • 発効日は都道府県ごとに異なり、発効日前は前年版にフォールバック
    • 例: 東京都の 2025 年版発効日は 2025-10-03、北海道は 2025-10-04、秋田県は 2026-03-31
  • 最初の年版より前の日付や、最初の年版の発効日前(前年版なし)の日付を指定した場合は DatasetNotFoundForDate エラーを返却(次に適用される年版の情報つき)

よくある質問(FAQ)

2025年度(令和7年度)の最低賃金はいつから適用されますか?

都道府県により異なります。最も早い栃木県が 2025年10月1日、最も遅い秋田県は 2026年3月31日です。 本クレートの rate_on_date は県別の発効日を考慮して、指定日に実際に適用される額を返します。

東京都の最低賃金はいくらですか?

2025年版(令和7年度)は 1,226円(2025年10月3日発効)、2024年版は 1,163円です。

データの更新はどうなりますか?

毎年度の改定(例年8月答申・10月前後発効)に合わせてデータセットを更新し、新バージョンとして公開します。

タイムゾーンについて

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

テスト

cargo test

貢献

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

ライセンス

MIT License

About

日本の地域別最低賃金(都道府県別)Rust ライブラリ / Japan minimum wage by prefecture for Rust

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages