yajima-tatsuro/jp-area-converter

Convert between tsubo, jo, and square meters (Japanese area units).

Installs: 0

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

pkg:composer/yajima-tatsuro/jp-area-converter

v1.0.0 2025-10-14 10:59 UTC

This package is auto-updated.

Last update: 2025-10-14 11:10:31 UTC


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

四捨五入の例

入力値 変換先 計算結果 四捨五入後
10.0㎡ 3.0251... 3.025
10.0㎡ 6.0502... 6.05
30.0㎡ 9.0751... 9.075

畳について

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

要件

  • PHP 8.1以上

ライセンス

MIT License

開発

テストの実行

composer test

コードスタイルの修正

composer cs-fix

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

composer cs-check

PHP CodeSniffer

composer phpcs
composer phpcbf