README

日本の面積単位（坪、畳、平方メートル）を相互変換するPHPパッケージです。

インストール

composer require yajima-tatsuro/jp-area-converter

使用方法

use JapaneseAreaConverter\AreaConverter;

$converter = new AreaConverter();

// 坪から平方メートルに変換
$result = $converter->fromTsubo(10.0)->toSquareMeter(); // 33.0579

// 畳から平方メートルに変換
$result = $converter->fromJo(6.0)->toSquareMeter(); // 9.9174

// 平方メートルから坪に変換
$result = $converter->fromSquareMeter(30.0)->toTsubo(); // 9.075

// 平方メートルから畳に変換
$result = $converter->fromSquareMeter(20.0)->toJo(); // 12.0999

複数の単位への変換

$converter = new AreaConverter();

// 同じ値から複数の単位に変換
$squareMeters = $converter->fromSquareMeter(30.0)->toSquareMeter(); // 30.0
$tsubo = $converter->fromSquareMeter(30.0)->toTsubo(); // 9.075
$jo = $converter->fromSquareMeter(30.0)->toJo(); // 18.15

すべての変換パターン

$converter = new AreaConverter();

// 平米→坪の変換
$result = $converter->fromSquareMeter(30.0)->toTsubo(); // 9.075

// 平米→畳の変換
$result = $converter->fromSquareMeter(20.0)->toJo(); // 12.0999

// 坪→平米の変換
$result = $converter->fromTsubo(10.0)->toSquareMeter(); // 33.0579

// 坪→畳の変換
$result = $converter->fromTsubo(1.0)->toJo(); // 2.0

// 畳→平米の変換
$result = $converter->fromJo(6.0)->toSquareMeter(); // 9.9174

// 畳→坪の変換
$result = $converter->fromJo(2.0)->toTsubo(); // 1.0

変換率

• 1坪 = 3.30579平方メートル
• 1畳 = 1.6529平方メートル
• 1坪 = 2畳

引数の型

引数は整数でも小数でも指定できます。PHPが自動的に適切な型に変換します。

$converter = new AreaConverter();

// 整数でも正常に動作
$result = $converter->fromSquareMeter(20)->toJo(); // 12.0999

// 小数でも同じ結果
$result = $converter->fromSquareMeter(20.0)->toJo(); // 12.0999

小数点の扱い

このパッケージでは、すべての変換結果を小数点第4位までで四捨五入して返します。

$converter = new AreaConverter();

// 例：10平方メートルを坪に変換
$result = $converter->fromSquareMeter(10.0)->toTsubo(); // 3.025

// 例：10平方メートルを畳に変換
$result = $converter->fromSquareMeter(10.0)->toJo(); // 6.05

四捨五入の例

畳について

「畳」は地域によってサイズが異なりますが、このパッケージでは全国統一の標準サイズ（1.6529平方メートル）で計算しています。

要件

• PHP 8.1以上

ライセンス

MIT License

開発

テストの実行

composer test

コードスタイルの修正

composer cs-fix

コードスタイルのチェック

composer cs-check

PHP CodeSniffer

composer phpcs
composer phpcbf