vlaim/slownie

A library for writing numbers in word form in Polish

1.0.2 2025-03-12 19:33 UTC

Requires

• php: >=7.2

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.16
• phpstan/phpstan: ^0.12.32
• phpunit/phpunit: ^8
• squizlabs/php_codesniffer: ^3.5

MIT

• Vladislav Alexeyev

• currency
• polish
• number-to-words
• polish-language

README

🇵🇱 Słownie to biblioteka PHP umożliwiająca zamianę liczb na zapis słowny w języku polskim.

🇬🇧 Słownie is a PHP library that converts numbers into words in Polish.

📦 Installation

Using Composer

Install this package via Composer:

{
    "require": {
        "vlaim/slownie": "^1"
    }
}

Run:

composer require vlaim/slownie

🚀 Basic Usage

The main method to convert numbers to words:

Slownie::convert($number, bool $hideGrosze = false, bool $hideZlote = false)

Parameters:

• $number (int | float | string) – The number to convert.
• $hideGrosze (bool, default: false) – If true, omits grosze (00/100).
• $hideZlote (bool, default: false) – If true, omits "złoty/złotych/złote".

Examples:

Convert a number to words:

Slownie::convert(10348);
// Output: "dziesięć tysięcy trzysta czterdzieści osiem złotych 00/100"

Hide grosze:

Slownie::convert(10348, true);
// Output: "dziesięć tysięcy trzysta czterdzieści osiem złotych"

Hide "złoty/złotych/złote":

Slownie::convert(10348, true, true);
// Output: "dziesięć tysięcy trzysta czterdzieści osiem"

🧪 Running Tests

To run tests, use:

composer test

🛠 Issues & Support

For bug reports and feature requests, visit the GitHub Issue Tracker.

Feel free to open an issue if you have any questions.

📜 License

vlaim/slownie is released under the MIT License.