PHPackages                             adampatterson/numeral - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. adampatterson/numeral

ActiveLibrary[Utility & Helpers](/categories/utility)

adampatterson/numeral
=====================

A PHP library for formatting and manipulating numbers.

0.0.7(10y ago)811.2k↑12.5%3[4 issues](https://github.com/adampatterson/Numeral/issues)MITPHP

Since Feb 16Pushed 2y ago1 watchersCompare

[ Source](https://github.com/adampatterson/Numeral)[ Packagist](https://packagist.org/packages/adampatterson/numeral)[ RSS](/packages/adampatterson-numeral/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)DependenciesVersions (10)Used By (0)

Numeral PHP
===========

[](#numeral-php)

[![PHP Composer](https://github.com/adampatterson/Numeral/workflows/PHP%20Composer/badge.svg?branch=main)](https://github.com/adampatterson/Numeral/workflows/PHP%20Composer/badge.svg?branch=main)[![Packagist Version](https://camo.githubusercontent.com/8777d4b341db2fa959af17100aa58ccb2343e6988fcd60ac779ea4b53764ae88/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6164616d706174746572736f6e2f6e756d6572616c)](https://packagist.org/packages/adampatterson/numeral)[![Packagist Downloads](https://camo.githubusercontent.com/5722b3ef399451e803a242c18ed179a01f5f5a3d6b2077e098d203918add921e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6164616d706174746572736f6e2f6e756d6572616c)](https://packagist.org/packages/adampatterson/numeral/stats)

A PHP library for formatting and manipulating numbers.

This script is still under development and a PHP clone of [Numeral-js](https://github.com/adamwdraper/Numeral-js) by [Adam Draper](https://github.com/adamwdraper).

Install from [Packagist](https://packagist.org/packages/adampatterson/numeral)
------------------------------------------------------------------------------

[](#install-from-packagist)

```
composer require adampatterson/numeral

```

For use in Laravel Views ( Blade files )
----------------------------------------

[](#for-use-in-laravel-views--blade-files-)

Open `config/app.php` and add Numeral to the aliases array.

```
'Numeral'      => Numeral\Numeral::class

```

`{{ \Numeral::number(85193.456)->format('0.00') }}`

Usage
-----

[](#usage)

```
use Numeral\Numeral;

class SomeController extends Controller
{
    public function myMethod(Numeral $numeral){
        $numeral->number('85193.456')->format()
    }

    // OR

    public function myOtherMethod(){
        Numeral::number('85193.456')->format()
    }
}

```

### Numbers

[](#numbers)

```
var_dump(Numeral::number('85193.456')->format()); // 85193
var_dump(Numeral::number('85193.456')->format('0.00')); // 85193.46
var_dump(Numeral::number('85193.456')->format('0,0.00')); // 85,193.46
var_dump(Numeral::number('-85193.00')->format()); // -85193
var_dump(Numeral::number('-85193')->format('0.00')); // -85193.00

```

### Percentages

[](#percentages)

```
var_dump(Numeral::number('-0.43')->format('0%')); // -43%
var_dump(Numeral::number('0.75')->format('0%')); // 75%

```

### Time

[](#time)

```
var_dump(Numeral::number('25')->format('00:00:00')); // 0:00:25
var_dump(Numeral::number('238')->format('00:00:00')); // 0:03:58
var_dump(Numeral::number('63846')->format('00:00:00')); // 17:44:06

```

### Currency

[](#currency)

**Work in progress.**

```
var_dump(Numeral::number('85187993.00')->format('$0,0.00')); // $85,187,993.00
var_dump(Numeral::number('85187993.00')->format('$0,0')); // $85,187,993
var_dump(Numeral::number('$85187993.00')->format('$0.00')); // $85187993.00
var_dump(Numeral::number('85187993.00')->format('$0')); // $85187993

```

### Un-format

[](#un-format)

**Work in progress.**

Tests
-----

[](#tests)

```
$ composer global require phpunit/phpunit
$ export PATH=~/.composer/vendor/bin:$PATH
$ which phpunit
~/.composer/vendor/bin/phpunit

```

`composer run-script test`

Local Dev
---------

[](#local-dev)

`ln -s ~/Sites/personal/_packages/Numeral/ ~/Sites/personal/projectName/vendor/adampatterson/Numeral`

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

7

Last Release

3738d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/042770de9c0c4d404547538b5a64dfe6f6e4400e212e6db042b541e3bef250c4?d=identicon)[adampatterson](/maintainers/adampatterson)

---

Top Contributors

[![adampatterson](https://avatars.githubusercontent.com/u/31537?v=4)](https://github.com/adampatterson "adampatterson (60 commits)")

---

Tags

composernumbernumeralpackagistphpphp-libraryformattimenumberspercentageNumerals

### Embed Badge

![Health badge](/badges/adampatterson-numeral/health.svg)

```
[![Health](https://phpackages.com/badges/adampatterson-numeral/health.svg)](https://phpackages.com/packages/adampatterson-numeral)
```

###  Alternatives

[willdurand/negotiation

Content Negotiation tools for PHP provided as a standalone library.

1.4k122.0M157](/packages/willdurand-negotiation)[wapmorgan/morphos

A morphological solution for Russian and English language written completely in PHP. Provides classes to inflect personal names, geographical names, decline and pluralize nouns, generate cardinal and ordinal numerals, spell out money amounts and time.

8351.3M7](/packages/wapmorgan-morphos)[symfony/clock

Decouples applications from the system clock

431168.9M205](/packages/symfony-clock)[consistence/consistence

Consistence - consistent approach and additions to PHP's functionality

1831.1M18](/packages/consistence-consistence)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)