unit-converter

単位変換

複数の物理量にわたって単位を変換します。

機能

• 複数のカテゴリ：長さ、質量、温度、時間、体積など
• 複合単位：速度、密度、圧力
• 精度の制御：小数点以下の桁数を設定可能
• 一括変換：値のリストを変換
• 数式の表示：変換式を表示

クイックスタート

from unit_converter import UnitConverter

converter = UnitConverter()

# Simple conversion
result = converter.convert(100, "km", "miles")
print(f"100 km = {result:.2f} miles")

# With full details
result = converter.convert_with_details(72, "fahrenheit", "celsius")
print(result)

CLI の使い方

# Basic conversion
python unit_converter.py 100 km miles

# Temperature
python unit_converter.py 98.6 fahrenheit celsius

# With precision
python unit_converter.py 1.5 kg lbs --precision 4

# List supported units
python unit_converter.py --list

# List units in category
python unit_converter.py --list length

# Show formula
python unit_converter.py 100 cm inches --formula

API リファレンス

UnitConverter クラス

class UnitConverter:
    def __init__(self)

    # Conversion
    def convert(self, value: float, from_unit: str, to_unit: str) -> float
    def convert_with_details(self, value: float, from_unit: str, to_unit: str) -> dict
    def batch_convert(self, values: list, from_unit: str, to_unit: str) -> list

    # Information
    def list_categories(self) -> list
    def list_units(self, category: str = None) -> dict
    def get_formula(self, from_unit: str, to_unit: str) -> str
    def find_unit(self, query: str) -> list

対応カテゴリ

長さ

単位	別名
meter	m
kilometer	km
centimeter	cm
millimeter	mm
inch	in
foot	ft
yard	yd
mile	mi
nautical_mile	nm

質量

単位	別名
kilogram	kg
gram	g
milligram	mg
pound	lb, lbs
ounce	oz
ton
metric_ton	tonne

温度

単位	別名
celsius	c
fahrenheit	f
kelvin	k

時間

単位	別名
second	s, sec
minute	min
hour	h, hr
day	d
week	wk
month	mo
year	yr

体積

単位	別名
liter	l
milliliter	ml
gallon	gal
quart	qt
pint	pt
cup
fluid_ounce	fl_oz
cubic_meter	m3

面積

単位	別名
square_meter	m2, sqm
square_kilometer	km2
square_foot	sqft, ft2
acre
hectare	ha

速度

単位	別名
meters_per_second	m/s, mps
kilometers_per_hour	km/h, kph
miles_per_hour	mph
knots	kt

デジタルストレージ

単位	別名
byte	b
kilobyte	kb
megabyte	mb
gigabyte	gb
terabyte	tb

エネルギー

単位	別名
joule	j
kilojoule	kj
calorie	cal
kilocalorie	kcal
watt_hour	wh
kilowatt_hour	kwh

ワークフローの例

一括変換

converter = UnitConverter()
weights_kg = [50, 75, 100, 125]
weights_lbs = converter.batch_convert(weights_kg, "kg", "lbs")
for kg, lbs in zip(weights_kg, weights_lbs):
    print(f"{kg} kg = {lbs:.1f} lbs")

変換可能な単位を検索

converter = UnitConverter()
# Search for units
matches = converter.find_unit("meter")
# Returns: ['meter', 'kilometer', 'centimeter', ...]

変換式を取得

converter = UnitConverter()
formula = converter.get_formula("celsius", "fahrenheit")
print(formula)  # "F = (C × 9/5) + 32"

出力形式

convert_with_details()

{
    "value": 100,
    "from_unit": "km",
    "to_unit": "miles",
    "result": 62.1371,
    "formula": "miles = km × 0.621371",
    "category": "length"
}

依存関係

外部依存関係はありません。Python 標準ライブラリを使用します。