{"name":"BIS_fnc_convertUnits","title":"BIS fnc convertUnits","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_convertUnits","revid":370880,"updated":"2025-02-21T10:44:03Z","groups":["Math"],"status":"ok","games":{"tkoh":"1.00","arma3":"0.50"},"since":"tkoh 1.00","arma3_since":"0.50","description":"Converts values to a target system of units.","syntaxes":[{"syntax":"[value, from, to, mode, precision] call BIS_fnc_convertUnits","params":[{"name":"value","type":"Number","description":"source value","type_expr":"Number"},{"name":"from","type":"Number","description":"source unit. Can be one of:\n\n- 0: m (meters)\n- 1: km (kilometers)\n- 2: ms (meters per second)\n- 3: kmh (kilometers per hour)\n- 4: ft (feet)\n- 5: mi (miles)\n- 6: fts (feet per second)\n- 7: mph (miles per hour)\n- 8: nm (nautical miles)\n- 9: kts (knots)","type_expr":"Number"},{"name":"to","type":"Number","optional":true,"default":"detected system of units via systemOfUnits","description":"destination unit. See *from*.","type_expr":"Number","text":"to: Number - (Optional, default detected system of units via systemOfUnits) destination unit. See *from*."},{"name":"mode","type":"Number","optional":true,"default":"0","description":"can be one of:\n\n- 0: destination value (Scalar)\n- 1: destination text long (String) e.g \"5 meters\"\n- 2: destination text short (String) e.g \"5 m\"","type_expr":"Number","text":"mode: Number - (Optional, default 0) can be one of:\n\n- 0: destination value (Scalar)\n- 1: destination text long (String) e.g \"5 meters\"\n- 2: destination text short (String) e.g \"5 m\""},{"name":"precision","type":"Number","optional":true,"default":"1","description":"destination precision factor, -1 for no precision change. **cannot be 0**","type_expr":"Number","text":"precision: Number - (Optional, default 1) destination precision factor, -1 for no precision change. **cannot be 0**"}],"returns":{"type":"Number or String","type_expr":"Number | String","description":"converted value"}}],"examples":[{"code":["private _distString = [500, 0, 5, 1, -1] call BIS_fnc_convertUnits;"]}],"see_also":["systemOfUnits"]}