Merge pull request #8 from nhamtphat/master

Cho phép thay đổi cách đọc phần thập phân

Author: vuongxuongminh

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 Tất cả lịch sử tiến trình phát triển thư viện
 
+# 1.3.0
+
+- Cho phép thay đổi cách đọc phần thập phân.
+
 # 1.2.1
 
 - Hổ trợ PHP8.

README.md

@@ -117,6 +117,16 @@ $transformer->toCurrency(95500200);
 // tám trăm năm mươi tư triệu chín trăm đồng
 $transformer->toCurrency(854000900);
 
+```
+Trong một số loại tiền tệ, bạn cần thay đổi cách đọc theo đơn vị quy đổi, ví dụ 1 đô = 100 xen
+```php
+use PHPViet\NumberToWords\Transformer;
+
+// Đặt số chữ số phần thập phân (tham số đầu tiên Dictionary có thể null)
+$transformer = new Transformer(null, 2);
+
+// năm mươi sáu đô chín mươi xen, thay vì năm mươi sáu đô chín xen
+$transformer->toCurrency(56.90);
 ```
 
 Ngoài ra ta còn có thể sử dụng đơn vị tiền tệ khác thông qua tham trị thứ 2 của phương thức

src/Concerns/NumberResolver.php

@@ -28,8 +28,13 @@ protected function resolveNumber($number): array
             throw new InvalidArgumentException(sprintf('Number arg (`%s`) must be numeric!', $number));
         }
 
-        $number += 0; // trick xóa các số 0 lẻ sau cùng của phân số đối với input là chuỗi.
-        $number = (string) $number;
+
+        if ($this->decimalPart === null) {
+            $number += 0; // trick xóa các số 0 lẻ sau cùng của phân số đối với input là chuỗi.
+            $number = (string) $number;
+        } else {
+            $number = number_format($number, $this->decimalPart, '.', '');
+        }
         $minus = '-' === $number[0];
 
         if (false !== strpos($number, '.')) {

src/Transformer.php

@@ -24,17 +24,24 @@ class Transformer
     protected $dictionary;
 
     /**
-     * Tạo đối tượng mới với từ điển chỉ định.
+     * Mặc định bỏ số các số 0 sau phần thập phân.
+     * @var int
+     */
+    protected $decimalPart;
+
+    /**
+     * Tạo đối tượng mới với từ điển chỉ định và phần thập phân.
      *
      * @param  DictionaryInterface  $dictionary
      */
-    public function __construct(?DictionaryInterface $dictionary = null)
+    public function __construct(?DictionaryInterface $dictionary = null, $decimalPart = null)
     {
         if (null === $dictionary) {
             $dictionary = new Dictionary();
         }
 
         $this->dictionary = $dictionary;
+        $this->decimalPart = $decimalPart;
     }
 
     /**

tests/CurrencyTest.php

@@ -7,6 +7,8 @@
 
 namespace PHPViet\NumberToWords\Tests;
 
+use PHPViet\NumberToWords\Transformer;
+
 /**
  * @author Vuong Minh <[email protected]>
  * @since 1.0.0
@@ -29,6 +31,61 @@ public function testUSDTransform($expect, $number)
         $this->assertEquals($expect, $this->transformer->toCurrency($number, ['đô', 'xen']));
     }
 
+    /**
+     * @dataProvider usdDecimalPartDataProvider
+     */
+    public function testUSDSetDecimalPart($expect, $float, $decimalPart)
+    {
+        $transformer =  new Transformer($this->dictionary, $decimalPart);
+
+        $this->assertEquals($expect, $transformer->toCurrency($float, ['đô', 'xen']));
+    }
+
+    public function usdDecimalPartDataProvider(): array
+    {
+        return [
+            ['không đô', 0, 1],
+            ['một nghìn đô', 1000, 2],
+            ['một nghìn không trăm linh một đô', 1001, 3],
+            ['một nghìn không trăm linh hai đô', 1002, 4],
+            ['âm không đô mười xen', -0.1, 2],
+            ['âm chín mươi chín đô', -99, 3],
+            ['âm chín mươi tám đô', -98, 4],
+            ['không đô ba trăm bảy mươi chín xen', 0.378758, 3],
+            ['không đô chín mươi hai xen', 0.922174, 2],
+            ['năm trăm bảy mươi ba đô năm mươi tám xen', 573.58, 2],
+            ['sáu trăm sáu mươi chín đô mười bốn xen', 669.135, 2],
+            ['ba trăm chín mươi lăm đô mười bốn xen', 395.136, 2],
+        ];
+    }
+
+    /**
+     * @dataProvider decimalPartDataProvider
+     */
+    public function testSetDecimalPart($expect, $float, $decimalPart)
+    {
+        $transformer =  new Transformer($this->dictionary, $decimalPart);
+        $this->assertEquals($expect, $transformer->toCurrency($float));
+    }
+
+    public function decimalPartDataProvider(): array
+    {
+        return [
+            ['không đồng', 0, 1],
+            ['một nghìn đồng', 1000, 2],
+            ['một nghìn không trăm linh một đồng', 1001, 3],
+            ['một nghìn không trăm linh hai đồng', 1002, 4],
+            ['âm không phẩy mười đồng', -0.1, 2],
+            ['âm chín mươi chín đồng', -99, 3],
+            ['âm chín mươi tám đồng', -98, 4],
+            ['không phẩy ba trăm bảy mươi chín đồng', 0.378758, 3],
+            ['không phẩy chín mươi hai đồng', 0.922174, 2],
+            ['năm trăm bảy mươi ba phẩy năm mươi tám đồng', 573.58, 2],
+            ['sáu trăm sáu mươi chín phẩy mười bốn đồng', 669.135, 2],
+            ['ba trăm chín mươi lăm phẩy mười bốn đồng', 395.136, 2],
+        ];
+    }
+
     public function usdDataProvider(): array
     {
         return [

tests/NumberTest.php

@@ -7,6 +7,8 @@
 
 namespace PHPViet\NumberToWords\Tests;
 
+use PHPViet\NumberToWords\Transformer;
+
 /**
  * @author Vuong Minh <[email protected]>
  * @since 1.0.0
@@ -37,6 +39,34 @@ public function testFractionTransform($expect, $float)
         $this->assertEquals($expect, $this->transformer->toWords($float));
     }
 
+    /**
+     * @dataProvider decimalPartDataProvider
+     */
+    public function testSetDecimalPart($expect, $float, $decimalPart)
+    {
+        $transformer =  new Transformer($this->dictionary, $decimalPart);
+
+        $this->assertEquals($expect, $transformer->toWords($float));
+    }
+
+    public function decimalPartDataProvider(): array
+    {
+        return [
+            ['không', 0, 1],
+            ['một nghìn', 1000, 2],
+            ['một nghìn không trăm linh một', 1001, 3],
+            ['một nghìn không trăm linh hai', 1002, 4],
+            ['âm không phẩy mười', -0.1, 2],
+            ['âm chín mươi chín', -99, 3],
+            ['âm chín mươi tám', -98, 4],
+            ['không phẩy ba trăm bảy mươi chín', 0.378758, 3],
+            ['không phẩy chín mươi hai', 0.922174, 2],
+            ['năm trăm bảy mươi ba phẩy năm mươi tám', 573.58, 2],
+            ['sáu trăm sáu mươi chín phẩy mười bốn', 669.135, 2],
+            ['ba trăm chín mươi lăm phẩy mười bốn', 395.136, 2],
+        ];
+    }
+
     public function fractionDataProvider(): array
     {
         return [