https://github.com/oschwald/currency-format

https://github.com/oschwald/currency-format

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/oschwald/currency-format
• Owner: oschwald
• License: mit
• Created: 2022-01-20T23:26:39.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-01-20T23:36:16.000Z (over 4 years ago)
• Last Synced: 2025-03-23T14:43:43.037Z (about 1 year ago)
• Size: 18.6 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Currency Format JSON

[![npm version](https://badge.fury.io/js/currency-format.svg)](https://badge.fury.io/js/currency-format) [![bower version](https://badge.fury.io/bo/currency-format.svg)](https://badge.fury.io/bo/currency-format)

JSON with information about currencies: codes (ISO 4217), the names, grapheme (symbols), fraction and formatting.

## Installation

Copy the JSON file into your project or use npm/bower package manager:

- Execute the following command: `npm install currency-format` or `bower install currency-format`

## Usage

The structure of the JSON file:

```javascript

{

  'AMD': {                          // ISO 4217 currency code.

     'name': 'Armenian Dram',       // Currency name.

     'fractionSize': 2,             // Fraction size, a number of decimal places.

     'symbol': {                    // Currency symbol information.

         'grapheme': 'դր.',         // Currency symbol.

         'template': '1 $',         // Template showing where the currency symbol should be located

                                    // (before or after amount).

         'rtl': false               // Writing direction.

     },

     'uniqSymbol': {                // Alternative currency symbol. We recommend to use it when you want

                                    // to exclude a repetition of symbols in different currencies.

         'grapheme': 'դր.',         // Alternative currency symbol.

         'template': '1 $',         // Template showing where the alternative currency symbol should be

                                    // located (before or after amount).

         'rtl': false               // Writing direction.

     }

  },

  ...

}

```

symbol/uniqSymbol field is `null`, when the currency has no symbol/alternative symbol.

## Currency reference

The list of currency codes was taken from https://en.wikipedia.org/wiki/ISO_4217.

## License

The MIT License.

See [LICENSE](https://github.com/xsolla/currency-format/blob/master/LICENSE)