rostand-dev/wordify-number

此库将数字转换为它们的文字表示形式(123 -> 一百二十三)。

1.0.0 2023-11-14 11:50 UTC

This package is auto-updated.

Last update: 2024-09-14 15:07:04 UTC


README

WordifyNumber 是一个 PHP 库,可以将数字转换为文字,支持多种语言和格式。

项目目标

该项目最初是为了创建一个面向企业的 ERP(企业资源计划)系统而设计的,特别强调自动化的发票功能。自动化的一个关键功能是将数字金额转换为文字,以便在发票文档上提供更友好的显示。

WordifyNumber 的设计目标是提供一种独立且轻量级的解决方案,无需依赖其他外部库。目标是使 ERP 项目能够轻松集成,提供数字到文字的转换功能,而不需要依赖于第三方解决方案。这保证了转换逻辑的更高控制和个性化,从而满足自动化发票系统的精确需求。

Wordify 吸收了同一领域更完整的项目,如 kwn/number-to-words。

安装

要在您的项目中使用此库,您必须通过 Composer 安装它

composer require rostand-dev/wordify-number

使用

存在两种将数字转换为文字的类型:数字和货币。为了使用特定语言的适当转换器,创建 NumberToWords 类的实例并调用创建所需转换器实例的方法。

默认语言是法语:fr。

默认货币:XOF。

创建实例

$wordify = new WordifyNumber();

数字转换器

echo $wordify::transformNumber(12345, 'fr'); // Affiche "douze mille trois cent quarante-cinq"

货币转换器

echo $wordify::transformNumber(12345, 'XOF', 'fr); // Affiche "douze mille trois cent quarante-cinq francs CFA"

贡献

贡献者列表.

如果您想为此项目做出贡献,请遵循以下步骤

  1. Fork 项目
  2. 创建新分支(git checkout -b feature/nouvelle-fonctionnalite
  3. 提交您的修改(git commit -am '添加新功能'
  4. 推送分支(git push origin feature/nouvelle-fonctionnalite
  5. 在 GitHub 上打开一个拉取请求

许可

此项目采用 MIT 许可。