minhtrancms/vn-number-to-words

Convert numbers to Vietnamese words. Chuyển đổi số thành chữ tiếng Việt.

v1.0.0 2026-01-08 02:16 UTC

Requires

• php: ^8.0

Requires (Dev)

• phpunit/phpunit: ^10.0

MIT

• Nhat Minh

• php
• currency
• vietnamese
• vietnam
• number-to-words
• tieng-viet

README

Chuyển đổi số thành chữ tiếng Việt / Convert numbers to Vietnamese words.

✨ Features

• ✅ Số nguyên (integers)
• ✅ Số âm (negative numbers)
• ✅ Số thập phân (decimal numbers)
• ✅ Số lớn đến hàng nghìn tỷ
• ✅ Hỗ trợ format tiền tệ
• ✅ Xử lý đúng các trường hợp đặc biệt: "mười một", "hai mươi mốt", "linh", "lăm", "tư"

📦 Installation

composer require minhtrancms/vn-number-to-words

🚀 Usage

Basic Usage

<?php

require_once 'vendor/autoload.php';

use MinhTranCms\VnNumberToWords\NumberToWords;

// Basic conversion
echo NumberToWords::convert(123);
// Output: một trăm hai mươi ba

echo NumberToWords::convert(1234567);
// Output: một triệu hai trăm ba mươi bốn nghìn năm trăm sáu mươi bảy

// Negative numbers
echo NumberToWords::convert(-100);
// Output: âm một trăm

// Decimal numbers
echo NumberToWords::convert(123.45);
// Output: một trăm hai mươi ba phẩy bốn năm

With Currency

echo NumberToWords::convertWithCurrency(1500000);
// Output: một triệu năm trăm nghìn đồng

echo NumberToWords::convertWithCurrency(1500000, 'VND');
// Output: một triệu năm trăm nghìn VND

📋 Examples

Number	Vietnamese
0	không
1	một
10	mười
11	mười một
21	hai mươi mốt
24	hai mươi tư
25	hai mươi lăm
100	một trăm
105	một trăm linh năm
110	một trăm mười
1000	một nghìn
1000000	một triệu
1000000000	một tỷ

🧪 Testing

composer test

📄 License

MIT License. See LICENSE file.

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

👨‍💻 Author

• Nhat Minh