Skip to content

money2Text (tam veya ondalık) sayıyı parasal yazı formatına çeviren ufak bir JavaScript kütüphanesidir.

License

Notifications You must be signed in to change notification settings

nbayramberdiyev/money2Text

Repository files navigation

money2Text

money2Text (tam veya ondalık) sayıyı parasal yazı formatına çeviren ufak bir JavaScript kütüphanesidir.

Kurulum

CDN

<script src="https://unpkg.com/money2text"></script>

NPM

npm i money2text

Kullanım

Tarayıcıda

Yukarıda belirtildiği gibi kütüphaneyi CDN üzerinden veya alternatif olarak money2Text.min.js dosyasını projenize dahil etmeniz yeterli olacaktır. Başka herhangi bir dosya veya kütüphaneye bağımlılığı yoktur.

Modül Olarak

const money2Text = require('money2text')
// veya
import money2Text from 'money2text'

API

money2Text(sayı [, seçenekler])

sayı:

Tipi: number|string

Belirtmek zorunlu olup integer, float, string tipinde olabilir. Geçerli sayı aralığı ise 0-999999999999.99'dur. Yani bir trilyondan küçük sayılar desteklenmektedir. İsteğe bağlı olarak formatlanmış veya formatlanmamış olabilir ancak sayı formatlanmış ise geçerli format olmak zorundadır.

seçenekler:

Tipi: Object

Belirtmek zorunlu olmayıp, girdiyi ve çıktıyı özelleştirmemizi sağlar. Eğer belirtilecekse key/value şeklinde obje olarak belirtilmelidir. Aşağıda detaylı olarak açıklanmıştır.

Seçenekler

Seçenek Açıklama Varsayılan Değer
separator Sayıdaki ondalık kısmı hangi karakter ile ayırmak istediğinizi belirtir. Geçerli değerler: ,, . ,
lira Sayının tam kısmının para birimini belirtir. Türk Lirası
kurus Sayının ondalık kısmının para birimini belirtir. Kuruş

Örnekler

money2Text('12,34') // On İki Türk Lirası Otuz Dört Kuruş

money2Text('12.34', { separator: '.' }) // On İki Türk Lirası Otuz Dört Kuruş

money2Text('12,34', { lira: 'TL' }) // On İki TL Otuz Dört Kuruş

money2Text('12.34', { separator: '.', lira: 'TL', kurus: 'Krş.' }) // On İki TL Otuz Dört Krş.

money2Text('12,34', { separator: '_' }) // Error: Ayraç, virgül (,) veya nokta (.) olmalıdır.

money2Text('12,34', { separator: '.' }) // Error: Sayı veya formatı geçerli değil.

money2Text('1,23,45') // Error: Sayı veya formatı geçerli değil.

money2Text(1000000000000) // RangeError: Bir trilyon ve üstü sayılar (şimdilik) desteklenmemektedir.

License

MIT

About

money2Text (tam veya ondalık) sayıyı parasal yazı formatına çeviren ufak bir JavaScript kütüphanesidir.

Resources

License

Stars

Watchers

Forks

Packages

No packages published