Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tonghoangvu/read-vietnamese-numbers
API đọc số thành chữ trong Tiếng Việt
https://github.com/tonghoangvu/read-vietnamese-numbers
Last synced: about 2 months ago
JSON representation
API đọc số thành chữ trong Tiếng Việt
- Host: GitHub
- URL: https://github.com/tonghoangvu/read-vietnamese-numbers
- Owner: tonghoangvu
- Created: 2020-12-11T15:32:45.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-03-08T05:22:16.000Z (almost 2 years ago)
- Last Synced: 2024-10-30T17:11:46.674Z (3 months ago)
- Language: TypeScript
- Homepage:
- Size: 451 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# read-vietnamese-numbers
### Introduction
Checkout version mới hơn, được deploy dưới dạng NPM package, có thể dùng được ngay tại https://github.com/tonghoangvu/read-vietnamese-number.
API đọc số thành chữ trong Tiếng Việt.
Bao gồm API được viết bằng NodeJS và TypeScript, cộng với một trang web đơn giản để demo. Tất cả đã được deploy lên VPS của tôi.
Live demo: [http://tonghoangvu.xyz:3000/](http://tonghoangvu.xyz:3000/)
### Features
Trang web có thể đọc được các số tiếng Việt:
* Số âm, số dương, số thập phân
* Chữ số lên tới hàng tỉ tỉ
* Độ dài không giới hạn (chỉ cần thêm các lớp khác cao hơn tỉ tỉ)
* Các tùy chọn khác như đơn vị tính, dấu phân tách, bỏ qua phần 000 ở giữa
### API
API duy nhất dùng để đọc chuỗi số thành chữ trong tiếng Việt.
```
/read?number=-00012345
```
API có thêm các query param để tùy chỉnh kết quả trả về:
* `separator`: dấu phân cách giữa các từ (mặc định là khoảng trắng). Ví dụ separator là dấu *_* thì kết quả của *123* là *một_trăm_hai_mươi_ba_đơn_vị*
* `unit`: đơn vị tính ở cuối cùng (mặc định là đơn vị). Ví dụ unit là *đồng* thì kết quả của *1000000* là *một triệu đồng*
### Installation
**Step 1**: Cài đặt các dependency cần thiết (dùng NPM hoặc Yarn)
```shell
npm install
yarn install
```
**Step 2**: Để chạy server trên môi trường test (local)
```shell
npm run dev
yarn run dev
```
**Step 3**: Chạy server trên VPS hoặc server (production)
```shell
// npm
npm run build
npm run start
// yarn
yarn run build
yarn run start
```
Sau đó truy cập vào [http://localhost:3000](http://localhost:3000) để xem kết quả.
### TEST
```shell
npm run test:e2e
yarn run test:e2e
```
### Support
Hãy star cho repository này hoặc follow tôi nếu bạn thấy hay nhé!