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

---
title: "units::toYards"
subtitle: "Function in std::units"
excerpt: "Converts a number to yards from its current units."
layout: manual
---

Converts a number to yards from its current units.

```kcl
units::toYards(@num: number(Length)): number(yd)
```



### Arguments

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

### Returns

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