freesewing/markdown/dev/reference/api/utils/units/en.md

---

title: units()

string utils.units(float value, string format = 'metric')

Converts the units value you pass it into a formatted string for the format you pass it.

Format must be either imperial or metric (the default).

The Part.shorthand call provides a context-aware unit() method that will call this method and pass it the units requested by the user.