单位转换 | ThingsBoard Cloud

*4.1及以上版本*

自ThingsBoard 4.1起，部件支持根据所选单位制自动进行数据转换和单位切换。这在全球IoT方案中尤为有用，可显著改善使用不同测量标准（如公制 °C、km、kg与英制 °F、miles、lbs）的各地用户的数据交互体验。

主要优势：

单位转换功能适用于哪些场景？

所有用于展示telemetry数据的部件均包含单位转换选项。单位转换适用于telemetry数据、Y轴刻度和阈值设置。

注意： 若部件包含多个telemetry key，需为每个key单独配置单位转换。

启用单位转换

单位转换在部件设置的 telemetry keys、Y-axis 和 thresholds 配置中的 unit settings 中配置。

注意：所有可用单位按类别分组（如温度、长度、质量）。目标单位只能选择与source unit同类的单位。

注意：若未为某单位制指定单位，该单位制将回退使用 Source unit 字段中的单位。

启用单位转换后，单位字段旁会出现图标，表示该功能已启用。

Range color settings 使用从服务器接收的 原始telemetry值（在应用任何单位转换之前的 units）。

例如，若设备发送温度值 22 °C 且已启用单位转换，部件可能显示为 71 °F。但 范围逻辑仍使用原始22 °C 判定颜色。

因此，若定义 18至24 °C 的绿色范围，则该范围内的所有温度读数都将显示为绿色 —— 无论是22 °C还是71 °F。

这样可确保 范围着色保持一致，切换单位制时亦然。

更改ThingsBoard账户使用的单位制：

点击屏幕右上角 三点图标，选择“Account”。
在 Profile 设置中，从下拉列表选择所需单位制：
- Auto - 根据用户浏览器区域或地区设置自动选择合适单位制。
- Metric - 全球最广泛使用，基于米 (m)、千克 (kg)、秒 (s) 等单位。
- Imperial - 常用于美国，基于英寸 (in)、英尺 (ft)、英里 (m)、磅 (lb)、加仑 (gal) 等单位。
- Hybrid - 混合测量制，常见于英国。通常根据上下文混用公制和英制。例如：距离用英里 (mi)、温度用摄氏度 (°C)、体重用千克 (kg) 或英石 (st)。
应用更改。

In the Profile settings, choose the desired unit system from the dropdown list. Then, apply changes.

下面以 Temperature & Humidity dashboard为例配置单位转换。该dashboard包含显示 摄氏度 (°C) 的 temperature 和 百分比 (%) 的 humidity 的部件。

将为单位转换应用到 temperature telemetry值、temperature图表的Y轴和 temperature阈值。 humidity 值保持不变，因为湿度测量单位为 percentage (%)，与所选 unit system 无关。

Step 1: Edit the Chart widget

切换到“Temperature and Humidity history”图表部件的编辑模式。

首先，为“temperature” telemetry key配置单位转换：

在“temperature” key字段中点击“Units”行。可见 source unit 已设为 Celsius (°C)，符合需求。
启用转换：打开“Enable unit conversion”选项，并为各单位制指定目标单位（如Imperial为 °F，Metric和Hybrid为 °C）。
点击“Apply”。