单位换算 API

长度、重量、面积、体积、温度、速度、数据存储、时间、压强、能量、角度单位互相换算,含斤、两、里、亩等中国市制单位

数据来源:本地计算(国际单位制、1959 年国务院统一计量制度命令中的市制换算)

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data },支持跨域,免注册每天可免费调用 100 次,注册后每天 10000 次。

单位换算(不传 to 时换算为同类全部单位)

GET /api/unit

请求参数

  • value(必填):要换算的数值,示例 3
  • from(必填):原单位:代号(如 km、jin、mu、C、MB)或中文(如 公里、斤、亩、摄氏度);区分大小写,完整列表见 /api/unit/list,示例 斤
  • to:目标单位,须与原单位同类;不传时只返回 all(换算到同类所有单位),示例 kg

返回字段

  • category(string):单位类别代号:length、mass、area、volume、temperature、speed、data、time、pressure、energy、angle
  • categoryName(string):单位类别中文名,如 重量
  • value(number):原数值
  • from(object):识别出的原单位
  • from.unit(string):单位代号,如 jin
  • from.name(string):单位中文名,如 斤(市斤)
  • to(object|null):识别出的目标单位;未传 to 时为 null
  • to.unit(string):单位代号
  • to.name(string):单位中文名
  • result(number|null):换算结果(保留 12 位有效数字);未传 to 时为 null
  • text(string|null):换算结果的中文表述,如 "3 斤(市斤) = 1.5 千克";未传 to 时为 null
  • all(array):原数值换算到同类每个单位的结果
  • all[].unit(string):单位代号
  • all[].name(string):单位中文名
  • all[].value(number):换算结果(保留 12 位有效数字)

全部可换算的单位

GET /api/unit/list

无需参数。

返回字段

  • [].category(string):类别代号,如 length
  • [].name(string):类别中文名,如 长度
  • [].units(array):该类别下的单位
  • [].units[].unit(string):单位代号(from/to 参数可直接使用,区分大小写)
  • [].units[].name(string):单位中文名
  • [].units[].aliases(array):也可使用的别名(字符串数组,如 公里、斤),可能为空数组