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

🧪 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