{"name":"BIS_fnc_convertUnits","operator":null,"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","replaced_by":[],"games":[{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Converts values to a target system of units.","syntaxes":[{"syntax":"[value, from, to, mode, precision] call BIS_fnc_convertUnits","since":null,"effect":null,"exec":null,"params":[{"name":"value","type":"Number","optional":false,"default":null,"description":"source value","types":["Number"],"since":null,"text":"value: Number - source value"},{"name":"from","type":"Number","optional":false,"default":null,"description":"source unit. Can be one of:\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)","types":["Number"],"since":null,"text":"from: Number - source unit. Can be one of:\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)"},{"name":"to","type":"Number","optional":true,"default":"detected system of units via systemOfUnits","description":"destination unit. See *from*.","types":["Number"],"since":null,"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- 0: destination value (Scalar)\n- 1: destination text long (String) e.g \"5 meters\"\n- 2: destination text short (String) e.g \"5 m\"","types":["Number"],"since":null,"text":"mode: Number - (Optional, default 0) can be one of:\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**","types":["Number"],"since":null,"text":"precision: Number - (Optional, default 1) destination precision factor, -1 for no precision change. **cannot be 0**"}],"returns":{"type":"Number or String","types":["Number","String"],"description":"converted value","text":"Number or String - converted value"}}],"examples":[{"text":"```sqf\nprivate _distString = [500, 0, 5, 1, -1] call BIS_fnc_convertUnits;\n```","code":["private _distString = [500, 0, 5, 1, -1] call BIS_fnc_convertUnits;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["systemOfUnits"],"notes":[],"categories":["Arma 3: Functions","Function Group: Math","Functions","Introduced with Take On Helicopters version 1.00","Take On Helicopters: Functions","Take On Helicopters: New Functions"],"docblock":null,"filled_from_docblock":[]}