modeling-app/docs/kcl-std/functions/std-units-toCentimeters.md

---
title: "units::toCentimeters"
subtitle: "Function in std::units"
excerpt: "Convert a number to centimeters from its current units."
layout: manual
---

Convert a number to centimeters from its current units.

```kcl
units::toCentimeters(@num: number(cm)): number(cm)
```



### Arguments

| Name | Type | Description | Required |
|----------|------|-------------|----------|
| `num` | [`number(cm)`](/docs/kcl-std/types/std-types-number) | A number | Yes |

### Returns

[`number(cm)`](/docs/kcl-std/types/std-types-number) - A number