Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/greatfriends/ThaiBahtText
Generate money amount text in Thai language for example: from 121.50 will be "หนึ่งร้อยยี่สิบเอ็ดบาทห้าสิบสตางค์"
https://github.com/greatfriends/ThaiBahtText
Last synced: 2 months ago
JSON representation
Generate money amount text in Thai language for example: from 121.50 will be "หนึ่งร้อยยี่สิบเอ็ดบาทห้าสิบสตางค์"
- Host: GitHub
- URL: https://github.com/greatfriends/ThaiBahtText
- Owner: greatfriends
- License: mit
- Created: 2015-05-04T14:00:05.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-10-01T17:22:30.000Z (over 4 years ago)
- Last Synced: 2024-11-10T02:43:38.004Z (2 months ago)
- Language: JavaScript
- Homepage: http://ThaiBahtText.azurewebsites.net/
- Size: 1.42 MB
- Stars: 40
- Watchers: 9
- Forks: 18
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-thai-dev - greatfriends/ThaiBahtText - แปลง "121.50 บาท" --> "หนึ่งร้อยยี่สิบเอ็ดบาทห้าสิบสตางค์" (C# || Visual Basic && Javascript) (ไลบรารี่)
README
[](https://ci.appveyor.com/project/surrealist/thaibahttext)
[](https://www.nuget.org/packages/ThaiBahtText)
[](https://www.nuget.org/packages/ThaiBahtText)
# ThaiBahtText
ให้ข้อความจำนวนเงินภาษาไทย เช่น จำนวน 121.50 บาท จะให้ผลลัพธ์เป็น "หนึ่งร้อยยี่สิบเอ็ดบาทห้าสิบสตางค์"
## เริ่มต้นใช้งาน
ภาษา C#
```c#
using GreatFriends.ThaiBahtText;
...
decimal amount = 121.50M;
string s = amount.ThaiBahtText(); // หนึ่งร้อยยี่สิบเอ็ดบาทห้าสิบสตางค์
```
ภาษา Visual Basic .NET
```vb
Imports GreatFriends.ThaiBahtText
...
Dim amount As Decimal = 121.50D
Dim s As String = amount.ThaiBahtText() ' หนึ่งร้อยยี่สิบเอ็ดบาทห้าสิบสตางค์
```
## การติดตั้งและอับเดตเวอร์ชั่นล่าสุด
คลิกเมนู TOOLS ใน Visual Studio เลือก NuGet Package Manager > Package Manager Console
```
PM> Install-Package ThaiBahtText
```
ตรวจสอบและอับเดตให้เป็นเวอร์ชั่นล่าสุด
```
PM> Update-Package ThaiBahtText
```
การถอนการติดตั้งออก
```
PM> Uninstall-Package ThaiBahtText
```
Nuget Package Page: https://www.nuget.org/packages/ThaiBahtText/
## ตัวเลือก
ฟังก์ชั่น ThaiBahtText มี overloads ดังนี้
1. _amount_.**ThaiBahtText**(**UsesEt** mode, **Unit** unit, int decimalPlaces, bool includeBahtOnly);
2. _amount_.**ThaiBahtText**(**ThaiBahtTextOptions** options);
โดยที่ _amount_ อาจจะเป็น `decimal` หรือ `decimal?` ก็ได้
คลาส `ThaiBahtTextOptions` ใช้เพื่อส่งค่าตัวเลือกได้สะดวกขึ้น โดยมี properties ดังนี้
Property | Type |Description
---------| ---------|---------------
UsesEt | enum | การใช้เอ็ดเมื่อมีค่าหนึ่งในหลักหน่วย กำหนดค่าเป็น `UsesEt.Always` เมื่อต้องการใช้เอ็ดเสมอ (เป็นค่าเริ่มต้น) เช่น ห้าร้อยเอ็ดล้านถ้วน และ `UsesEt.TensOnly` เมื่อต้องการใช้เอ็ดในหลักสิบเท่านั้น เช่น ห้าร้อยหนึ่งล้านถ้วน
Unit | enum | กำหนดหน่วยของข้อความที่ต้องการว่า จะเป็น `Unit.Baht` บาท (เป็นค่าเริ่มต้น) `Unit.Million` ล้านบาท `Unit.Billion` พันล้านบาท หรือ `Unit.Trillion` ล้านล้านบาท
DecimalPlaces | int | จำนวนหน่วยทศนิยม มีค่าได้ระหว่าง 0 ถึง 6 (มีค่าเริ่มต้นเป็น 2) จะถูกนำไปใช้ก็ต่อเมื่อ Unit มีค่าไม่เท่ากับ `Unit.Baht` เท่านั้น
appendBahtOnly | bool | เพิ่มคำว่าถ้วนหรือไม่ (มีค่าเริ่มต้นเป็น `true`)
### UsesEt.Always
ThaiBahtText(`UsesEt.Always`)
ใช้เอ็ดเสมอ (เป็นค่าเริ่มต้น) สำหรับหลักหน่วยที่มีค่าเป็น 1 รวมถึงหลักล้านที่มีค่าเป็น 1 ด้วย
**เป็นรูปแบบที่แนะนำให้ใช้** ตามหลักภาษาไทยที่ถูกต้องแนะนำโดยราชบัณฑิตยสภา
```c#
string s21 = (101M).ThaiBahtText(mode: UsesEt.Always); // หนึ่งร้อยเอ็ดบาทถ้วน
string s22 = (101M).ThaiBahtText(); // หนึ่งร้อยเอ็ดบาทถ้วน
string s23 = (11M).ThaiBahtText(); // สิบเอ็ดบาทถ้วน
string s24 = (211M).ThaiBahtText(); // สองร้อยสิบเอ็ดบาทถ้วน
string s25 = (1001M).ThaiBahtText(); // หนึ่งพันเอ็ดบาทถ้วน
string s26 = (1001000000M).ThaiBahtText(); // หนึ่งพันเอ็ดล้านบาทถ้วน
```
### UsesEt.TensOnly
ThaiBahtText(`UsesEt.TensOnly`)
ใช้เอ็ดเฉพาะกับหลักสิบเท่านั้น (เฉพาะสิบเอ็ดถึงเก้าสิบเอ็ด) ถ้าไม่ระบุจะใช้ตัวเลือกนี้เป็นค่าเริ่มต้น
**ไม่เป็นรูปแบบที่แนะนำให้ใช้**
```c#
string s11 = (101M).ThaiBahtText(mode: UsesEt.TensOnly); // หนึ่งร้อยหนึ่งบาทถ้วน
string s12 = (101M).ThaiBahtText(UsesEt.TensOnly); // หนึ่งร้อยหนึ่งบาทถ้วน
string s13 = (11M).ThaiBahtText(UsesEt.TensOnly); // สิบเอ็ดบาทถ้วน
string s14 = (211M).ThaiBahtText(UsesEt.TensOnly); // สองร้อยสิบเอ็ดบาทถ้วน
string s15 = (1001M).ThaiBahtText(UsesEt.TensOnly); // หนึ่งพันหนึ่งบาทถ้วน
string s16 = (1001000000M).ThaiBahtText(UsesEt.TensOnly); // หนึ่งพันหนึ่งล้านบาทถ้วน
```
### หน่วยของจำนวนเงิน
ค่าเริ่มต้นเป็น บาท แต่สามารถเปลี่ยนข้อความผลลัพธ์เป็นหน่วยอื่นได้ เช่น
```C#
var million = new ThaiBahtTextOptions(Unit.Million, appendBahtOnly: false);
var billion = new ThaiBahtTextOptions(Unit.Billion, appendBahtOnly: false);
var s1 = (123456000m).ThaiBahtText(million); // หนึ่งร้อยยี่สิบสามจุดสี่หกล้านบาท
var s2 = (123456000m).ThaiBahtText(billion); // ศูนย์จุดหนึ่งสองพันล้านบาท
```
## ตารางผลลัพธ์
ดูที่ https://github.com/greatfriends/ThaiBahtText/wiki/Sample-Result