{"id":29715603,"url":"https://github.com/khensolomon/myanmar-notation","last_synced_at":"2025-07-24T05:37:36.425Z","repository":{"id":304908604,"uuid":"145391812","full_name":"khensolomon/myanmar-notation","owner":"khensolomon","description":"Node.js module and a library which converts the given number into words in Myanmar","archived":false,"fork":false,"pushed_at":"2024-02-06T14:21:06.000Z","size":2607,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-17T01:23:03.071Z","etag":null,"topics":["burma","burmese","myanmar","notation","number","numeral"],"latest_commit_sha":null,"homepage":"https://khensolomon.github.io/myanmar-notation/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/khensolomon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-08-20T08:53:37.000Z","updated_at":"2024-02-02T09:11:08.000Z","dependencies_parsed_at":"2025-07-17T07:55:15.647Z","dependency_job_id":"223e052c-4c07-43bb-850d-c5258b646ce7","html_url":"https://github.com/khensolomon/myanmar-notation","commit_stats":null,"previous_names":["khensolomon/myanmar-notation"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/khensolomon/myanmar-notation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khensolomon%2Fmyanmar-notation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khensolomon%2Fmyanmar-notation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khensolomon%2Fmyanmar-notation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khensolomon%2Fmyanmar-notation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/khensolomon","download_url":"https://codeload.github.com/khensolomon/myanmar-notation/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khensolomon%2Fmyanmar-notation/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266796971,"owners_count":23985515,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["burma","burmese","myanmar","notation","number","numeral"],"created_at":"2025-07-24T05:37:35.850Z","updated_at":"2025-07-24T05:37:36.412Z","avatar_url":"https://github.com/khensolomon.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# myanmar-notation\n\nA [Node.js](#nodejs) module and a [library](#browser) which converts the given number into words in Myanmar. Following written rule and add the creaky tone on number places `10^5`, `10^6` and `10^7`. Check [live Demo][demo] is available...\n\n[![workflows-badge]][workflows]\n[![travis-badge]][travis]\n[![npm-badge]][npm]\n[![webpack-badge]][latest-min-unpkg]\n![test-mocha]\n\nNormally \"ပေါင်း\" in Myanmar translated \"plus\", however the same word using in a large number of amount dedicate multiply. For example\nသိန်းတစ်သောင်း is `1 0000 00000` and can also/usually pronounced သိန်းပေါင်း တစ်သောင်း which mean \"`(100000*10000)`\", therefor \"သိန်းတစ်သောင်း\" and \"သိန်းပေါင်း တစ်သောင်း\" has dedicated the same amount. This module is using \"ပေါင်း\" when the dedicated amount is larger than the subsequent scale name \"ခု\", \"ဆယ်\", \"ရာ\", \"ထောင်\", \"သောင်း\", \"သိန်း\", \"သန်း\" and \"ကု​ဋေ​\".\n\nIt can be a bit confusing between \"သိန်းတစ်သိန်း\" and \"တစ်သိန်း\" as of spoken usually does\n\n\u003e \"ငွေ သိန်းတစ်သိန်းလောက်  ချေးပေးလို့ရမလား ခင်ဗျာ\"\n\nthey probabbly just wanted \"100000\",\nbut it is entirely different as \"သိန်းတစ်သိန်း\" mean \"10000 000000\" and \"တစ်သိန်း\" mean \"100000\".\n\nThere are also difference positioning scale name, primarly it is followed by the given number\n\n\u003e 10: \"တစ်ဆယ်\" 20: \"နှစ်ဆယ်\" 10000000: \"တစ်ကု​ဋေ​\"\n\nHowever using this primarly structure in large amount seem very weird, eg.100000000: \"တစ်ထောင်သိန်း\", \"တစ်ရာသန်း\", \"တစ်ဆယ်ကု​ဋေ​\", therefore in such amount the scale name lead the number to take away this weirdness.\n\n\u003e 100000000: \"သိန်းတစ်ထောင်\", \"သန်းတစ်ရာ\", \"ကု​ဋေ​တစ်ဆယ်\"\n\n## Feature\n\n- [x] Decimals are rounded (floor)\n- [x] Query `get(2700)`, `get('၂၇၀၀')`, `get('27,000,000.00')` ,`get('5.23e+8')` is flexible\n- [x] [Demo][demo]\n- [x] mocha\n- [x] webpack\n\n## Usage\n\n### Node.JS\n\n\u003e Oops: `myanmar-notation` export ES module from CommonJS built version.\n\n```js\nexport * from \"./index.js\";\n\nimport * as e from \"./index.js\";\nexport default e;\n```\n\n`npm i myanmar-notation` can be `require` or `import` from your Node.JS application. However `myanmar-notation` is assuming that one day npm might force us to seperate ES module and CommonJS. Therefore, it is a good practice to start coding Node.JS application using ES module.\n\n```js\n// ES6\nimport myanmarNotation from 'myanmar-notation';\nimport {get} from 'myanmar-notation';\n\nmyanmarNotation.get(2700);\n// myanmarNotation.multiplication(5);\n// myanmarNotation.keep(123);\n// myanmarNotation.turn('၄၅၆');\nget(12345678);\n\n// CommonJS\nconst myanmarNotation = require('myanmar-notation');\nconst {get} = require('myanmar-notation');\n\nmyanmarNotation.get(2700);\nget(12345678);\n```\n\n### Browser\n\nInclude the file `myanmar-notation@latest/min.js` in your web application. It is available on [UNPKG][unpkg] and [jsDelivr][jsdelivr].\n\n- [https://cdn.jsdelivr.net/npm/ttfmeta@latest/min.js][latest-min-unpkg]\n- [https://unpkg.com/ttfmeta@latest/min.js][latest-min-jsdelivr]\n\nNow let's assume that you have picked the [jsDelivr][latest-min-jsdelivr] one...\n\n```html\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/ttfmeta@latest/min.js\"\u003e\u003c/script\u003e\n\u003cscript\u003e\nlet notation = window.myanmarNotation;\n\u003c/script\u003e\n```\n\n## API\n\nYou may assure that the *API*s are not going to change without a good reason for end user. So any exported `methods` and `classes` **name** will stays the same as the *last* updates.\n\n- [myanmar-notation](#myanmar-notation)\n  - [Feature](#feature)\n  - [Usage](#usage)\n    - [Node.JS](#nodejs)\n    - [Browser](#browser)\n  - [API](#api)\n    - [Multiplication](#multiplication)\n    - [Keep](#keep)\n    - [Turn](#turn)\n    - [get](#get)\n  - [License](#license)\n\n### Multiplication\n\nthe `notation.multiplication()` construct the given len to zero ending, it takes 2 arguments `(len, head='1')`, second argument is optional and return the result as string.\n\n```js\nnotation.multiplication(5,'10');\n\u003e \"100000\"\n```\n\n### Keep\n\nthe `notation.keep()` convert the given string(number) to Burmese number and return the result as string.\n\n```js\nnotation.keep(1234567);\n\u003e \"၁၂၃၄၅၆၇\"\n\nnotation.keep('a567');\n\u003e \"a၅၆၇\"\n```\n\n### Turn\n\nthe `notation.turn()` convert the given string(number) to English number and return the result as string.\n\n```js\nnotation.turn('၁၂၃၄၅၆၇');\n\u003e \"1234567\"\n\nnotation.turn('123၅၆၇');\n\u003e \"123567\"\n```\n\n### get\n\nthe `notation.get()` return an object if there is a sense in get query, otherwise empty Object return.\n\n```js\nnotation.get(2700);\n// return\n\u003e  {\n    \"number\": \"၂၇၀၀\",\n    \"digit\": \"2700\",\n    \"notation\": [\n      {\n        \"sense\": \"နှစ်ထောင့်ခုနစ်ရာ\"\n      }\n    ]\n  }\n\nnotation.get(12345678);\n// return\n\u003e  {\n    \"number\": \"၁၂၃၄၅၆၇၈\",\n    \"digit\": \"12345678\",\n    \"notation\": [\n      {\n        \"sense\": \"သိန်းတစ်ရာ့နှစ်ဆယ့်သုံး လေးသောင်းငါးထောင့်ခြောက်ရာ့ခုနစ်ဆယ့်ရှစ်\",\n        \"rule\": 5,\n        \"size\": 8,\n        \"list\": [\n          \"123\",\n          \"45678\"\n        ]\n      },\n      {\n        \"sense\": \"သန်းတစ်ဆယ့်နှစ် သုံးသိန်းလေးသောင်းငါးထောင့်ခြောက်ရာ့ခုနစ်ဆယ့်ရှစ်\",\n        \"rule\": 6,\n        \"size\": 8,\n        \"list\": [\n          \"12\",\n          \"345678\"\n        ]\n      },\n      {\n        \"sense\": \"တစ်ကု​ဋေ​ နှစ်သန်းသုံးသိန်းလေးသောင်းငါးထောင့်ခြောက်ရာ့ခုနစ်ဆယ့်ရှစ်\",\n        \"rule\": 7,\n        \"size\": 8,\n        \"list\": [\n          \"1\",\n          \"2345678\"\n        ]\n      }\n    ]\n  }\n```\n\n## License\n\n![shield-license]\n\n[demo]: https://khensolomon.github.io/myanmar-notation/\n[workflows-badge]: https://github.com/khensolomon/myanmar-notation/workflows/Node/badge.svg\n[workflows]: https://github.com/khensolomon/myanmar-notation/actions/workflows/node.yml\n[test-mocha]: https://img.shields.io/badge/test-mocha-green.svg?longCache=true\n[webpack-badge]: https://img.shields.io/badge/webpack-yes-green.svg?longCache=true\n\n[unpkg]: https://unpkg.com/\n[latest-min-unpkg]: https://unpkg.com/myanmar-notation@latest/min.js\n[jsdelivr]: https://www.jsdelivr.com/\n[latest-min-jsdelivr]: https://cdn.jsdelivr.net/npm/myanmar-notation@latest/min.js\n\n[travis-badge]: https://app.travis-ci.com/khensolomon/myanmar-notation.svg?branch=master\n[travis]: https://app.travis-ci.com/khensolomon/myanmar-notation\n[npm-badge]: https://img.shields.io/npm/dt/myanmar-notation.svg\n[npm]: https://www.npmjs.com/package/myanmar-notation\n[shield-license]: https://img.shields.io/github/license/khensolomon/myanmar-notation?style=social\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhensolomon%2Fmyanmar-notation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhensolomon%2Fmyanmar-notation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhensolomon%2Fmyanmar-notation/lists"}