---
title: "string(fromKilograms:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/massformatter/string(fromkilograms:)"
---

# string(fromKilograms:)

Returns a mass string for the provided value.

## Declaration

```swift
func string(fromKilograms numberInKilograms: Double) -> String
```

## Parameters

- `numberInKilograms`: The mass’s value in kilograms.

## Return Value

Return Value A string that combines a value and a unit string appropriate for the formatter’s locale.

## Discussion

Discussion This method converts the provided mass in kilograms into units appropriate for the formatter’s locale.

## See Also

### Formatting Mass Strings

- [isForPersonMassUse](foundation/massformatter/isforpersonmassuse.md)
- [getObjectValue(_:for:errorDescription:)](foundation/massformatter/getobjectvalue(_:for:errordescription:).md)
- [numberFormatter](foundation/massformatter/numberformatter.md)
- [string(fromValue:unit:)](foundation/massformatter/string(fromvalue:unit:).md)
- [unitString(fromKilograms:usedUnit:)](foundation/massformatter/unitstring(fromkilograms:usedunit:).md)
- [unitString(fromValue:unit:)](foundation/massformatter/unitstring(fromvalue:unit:).md)
- [unitStyle](foundation/massformatter/unitstyle.md)