{"id":18601150,"url":"https://github.com/laravel-ready/readable-numbers","last_synced_at":"2025-04-10T19:30:32.779Z","repository":{"id":62549289,"uuid":"484558448","full_name":"laravel-ready/readable-numbers","owner":"laravel-ready","description":"Human readable numbers for Laravel. Convert very large numbers to 1.2K, 1.2M, 1.2B, 1.2T","archived":false,"fork":false,"pushed_at":"2024-05-27T13:54:13.000Z","size":22,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T03:01:37.144Z","etag":null,"topics":["laravel","numbers","readable","readable-nu"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/laravel-ready.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-22T20:07:39.000Z","updated_at":"2024-07-05T09:34:52.000Z","dependencies_parsed_at":"2022-11-03T01:30:29.071Z","dependency_job_id":null,"html_url":"https://github.com/laravel-ready/readable-numbers","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laravel-ready%2Freadable-numbers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laravel-ready%2Freadable-numbers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laravel-ready%2Freadable-numbers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laravel-ready%2Freadable-numbers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/laravel-ready","download_url":"https://codeload.github.com/laravel-ready/readable-numbers/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248281395,"owners_count":21077423,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","numbers","readable","readable-nu"],"created_at":"2024-11-07T02:07:21.244Z","updated_at":"2025-04-10T19:30:32.432Z","avatar_url":"https://github.com/laravel-ready.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Readable Numbers\n\n[![EgoistDeveloper Readable Numbers](https://preview.dragon-code.pro/EgoistDeveloper/Readable-Numbers.svg?brand=laravel)](https://github.com/laravel-ready/readable-numbers)\n\n[![Stable Version][badge_stable]][link_packagist]\n[![Unstable Version][badge_unstable]][link_packagist]\n[![Total Downloads][badge_downloads]][link_packagist]\n[![License][badge_license]][link_license]\n\nHuman readable numbers for Laravel. In some cases, you may need to format numbers in a way that is easier to read. Especially when you are dealing with numbers that are very large, for example we want to show page views and we have `100000000` views. So we can show it in the `100M` format.\n\n## Installation\n\n```bash\ncomposer require laravel-ready/readable-numbers\n```\n\n## Thresholds\n\n| Threshold          | Suffix      | Result |\n| ------------------ | ----------- | ------ |\n| 900                |             | 900    |\n| 900.000            | k           | 0.9 K  |\n| 900.000.000        | m           | 0.9 M  |\n| 900.000.000.000    | b           | 9 T    |\n| 90.000.000.000.000 | t           | 900 T  |\n\n## Usages\n\n`make` method takes 3 aguments: `make(float $value, int $decimals = 1, $lang = null)`\n\n\n### Service Example\n\n```php\n\nuse LaravelReady\\ReadableNumbers\\Services\\ReadableNumbers;\n\n...\n\n$readableNumber = ReadableNumbers::make(123456789); // 123.5 M\n$readableNumber = ReadableNumbers::make(-123456789); // -123.5 M\n\n// with more decimals\n$readableNumber = ReadableNumbers::make(123456789, 2); // 123.46 M\n\n// with target language (default is english)\n$readableNumber = ReadableNumbers::make(123456789, 2, 'tr'); // 123.46 Mn\n$readableNumber = ReadableNumbers::make(123456789, 3, 'ja'); // 123.457 億\n$readableNumber = ReadableNumbers::make(123456789, 4, 'de'); // 123.4568 Mio.\n\n```\n\n### Directive Example\n\nThere is only one directive: `@readableNumber()`, again takes three arguments: `@readableNumber(float $value, int $decimals = 1, $lang = null)`. If you use a multi-language system, you should remember to directives are cached. So, you should pass decimal count and language.\n\n\n```html\n\n...\n\n\u003cspan\u003e\n    @readableNumber(123456789, 1, app()-\u003egetLocale())\n\u003c/span\u003e\n\n...\n\n\u003cspan class=\"view-counter\"\u003e\n    \u003ci class=\"icon icon-eye\"\u003e\u003c/i\u003e\n\n    Viewed @readableNumber($blogPost-\u003eviews, 1, app()-\u003egetLocale()) times\n\u003c/span\u003e\n\n```\n\n## Languages\n\nSupported languages are listed [here](lang/) and reference are used in [unicode.org](https://www.unicode.org/cldr/cldr-aux/charts/28/verify/numbers/). If you want to add your own language and send PR.\n\nDon't forget to these shortings are depends on a mathematical view.\n\n\n[badge_downloads]:      https://img.shields.io/packagist/dt/laravel-ready/readable-numbers.svg?style=flat-square\n\n[badge_license]:        https://img.shields.io/packagist/l/laravel-ready/readable-numbers.svg?style=flat-square\n\n[badge_stable]:         https://img.shields.io/github/v/release/laravel-ready/readable-numbers?label=stable\u0026style=flat-square\n\n[badge_unstable]:       https://img.shields.io/badge/unstable-dev--main-orange?style=flat-square\n\n[link_license]:         LICENSE\n\n[link_packagist]:       https://packagist.org/packages/laravel-ready/readable-numbers\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaravel-ready%2Freadable-numbers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaravel-ready%2Freadable-numbers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaravel-ready%2Freadable-numbers/lists"}