# @ethersproject/units

> Unit conversion functions for Ethereum.

Latest version **5.8.0** (published 2025-02-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install @ethersproject/units
pnpm add @ethersproject/units
yarn add @ethersproject/units
bun add @ethersproject/units
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 5.8.0 |
| Published | 2025-02-26 |
| First published | 2019-03-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 19.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8714 |
| Author | Richard Moore |
| Maintainers | ricmoo |
| Keywords | Ethereum, ethers, units, conversion |

## Links

- npm: https://www.npmjs.com/package/@ethersproject/units
- Repository: https://github.com/ethers-io/ethers.js
- Homepage: https://github.com/ethers-io/ethers.js#readme
- Issues: https://github.com/ethers-io/ethers.js/issues
- Funding: https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2
- npm.io page: https://npm.io/package/@ethersproject/units

## Dependencies (3)

- [@ethersproject/logger](https://npm.io/package/@ethersproject/logger.md) ^5.8.0
- [@ethersproject/bignumber](https://npm.io/package/@ethersproject/bignumber.md) ^5.8.0
- [@ethersproject/constants](https://npm.io/package/@ethersproject/constants.md) ^5.8.0

## Recent versions

- 5.8.0 (latest) — 2025-02-26
- 5.7.0 — 2022-08-19
- 5.6.1 — 2022-05-24
- 5.6.0 — 2022-03-10
- 5.5.0 — 2021-10-20
- 5.4.0 — 2021-06-26
- 5.3.0 — 2021-06-01
- 5.2.0 — 2021-05-20
- 5.1.0 — 2021-03-30
- 5.0.11 — 2021-03-08
- 5.0.10 — 2021-02-01
- 5.0.9 — 2021-01-08
- 5.0.8 — 2020-11-24
- 5.0.7 — 2020-11-18
- 5.0.6 — 2020-10-08
- … 23 more at https://npm.io/package/@ethersproject/units/versions

## README

Ethereum Unit Conversion Utilities
==================================

This sub-module is part of the [ethers project](https://github.com/ethers-io/ethers.js).

It contains functions to convert between string representations and numeric
representations of numbers, including those out of the range of JavaScript.

For more information, see the [documentation](https://docs.ethers.io/v5/api/utils/display-logic/).


Importing
---------

Most users will prefer to use the [umbrella package](https://www.npmjs.com/package/ethers),
but for those with more specific needs, individual components can be imported.

```javascript
const {

    formatUnits,
    parseUnits,

    formatEther,
    parseEther,

    commify

} = require("@ethersproject/units");
```


License
-------

MIT License

---
_Source: https://npm.io/package/@ethersproject/units · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._