{"id":19150438,"url":"https://github.com/vicompany/vi18n","last_synced_at":"2025-02-22T20:45:36.405Z","repository":{"id":36737165,"uuid":"41043760","full_name":"vicompany/vi18n","owner":"vicompany","description":"Simple number, currency and date formatters based on the Internationalization API.","archived":false,"fork":false,"pushed_at":"2018-04-26T13:58:16.000Z","size":328,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-02-13T11:52:32.240Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/vicompany.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-19T15:48:05.000Z","updated_at":"2021-06-18T08:02:04.000Z","dependencies_parsed_at":"2022-07-09T15:47:05.170Z","dependency_job_id":null,"html_url":"https://github.com/vicompany/vi18n","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vicompany%2Fvi18n","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vicompany%2Fvi18n/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vicompany%2Fvi18n/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vicompany%2Fvi18n/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vicompany","download_url":"https://codeload.github.com/vicompany/vi18n/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240236198,"owners_count":19769571,"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","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":[],"created_at":"2024-11-09T08:12:01.505Z","updated_at":"2025-02-22T20:45:36.368Z","avatar_url":"https://github.com/vicompany.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VI18N\n\n[![npm](https://img.shields.io/npm/v/vi18n.svg)](https://npm.im/vi18n)\n[![Build Status](https://travis-ci.org/vicompany/vi18n.svg)](https://travis-ci.org/vicompany/vi18n)\n[![Coverage Status](https://coveralls.io/repos/vicompany/vi18n/badge.svg?branch=master\u0026service=github)](https://coveralls.io/github/vicompany/vi18n?branch=master)\n\nSimple number, currency, type and date formatters based on the [Internationalization API](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl).\n\n## Requirements\n\n* [**Intl** object (ECMAScript Internationalization API)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl) see the [support](http://caniuse.com/#feat=internationalization).\n  * You can include the [polyfill](https://github.com/andyearnshaw/Intl.js) when supporting older environments.\n  * Or use the Financial Times polyfill service at [cdn.polyfill.io](https://cdn.polyfill.io).\n\n## Installation\n\n```\nnpm install --save vi18n\n```\n\n## Examples\n\n### Creating a locale\n```javascript\nimport VI18N from 'vi18n';\n\n// const locale = new VI18N(culture, options);\n\nconst nl = new VI18N(); // Default locale is 'nl-NL' (Dutch)\nconst uk = new VI18N('en-GB');\n\n// overriding default settings with options\nconst ch = new VI18N('de-ch', { number: { maximumFractionDigits: 2 } });\nconst nl = new VI18N('nl-NL', { percent: { minimumFractionDigits: 2 } });\nconst jp = new VI18N('ja', { currency: { currency: 'JPY' } });\n\nconst uk = new VI18N('en-GB', {\n  time: { timeZone: 'etc/UTC' },\n  currency: { currency: 'GBP' },\n});\n\nconst us = new VI18N('en-US', {\n  time: { hour: 'numeric' },\n  currency: { currency: 'USD' } ,\n});\n```\n\nThe `options` parameter can contain the following configuration objects:\n- `number`\n- `percent`\n- `currency`\n- `time`\n\nSee [MDN: NumberFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat) for possible values for the `number`, `percent` and `currency` configuration objects.\nSee [MDN: DateTimeFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat) for possible values for the `time` configuration object.\n\n### Number formatting\n```javascript\nnl.formatNumber(12.50); // '12,50'\nuk.formatNumber(12.50); // '12.50'\n```\n\n### Currency formatting\n```javascript\nnl.formatCurrency(12.50); // '€ 12,50'\nuk.formatCurrency(12.50); // '£12.50'\n```\n\n### Percent formatting\n```javascript\nnl.formatPercent(0.75); // '75%'\nuk.formatPercent(0.75); // '75%'\n```\n\n### Date and time formatting\n```javascript\nvar date = new Date();\n\nnl.formatDate(date); // '2-9-2015'\nuk.formatDate(date); // '02/09/2015'\n\nnl.formatTime(date); // '12:38:09'\nuk.formatTime(date); // '12:38:09'\n```\n\n### Decimal and thousand separator\n```javascript\nnl.getDecimalSeparator();   // ','\nnl.getThousandSeparator();  // '.'\n```\n\n### Months and days\n```javascript\n// Possible representations are 'narrow', 'short' or 'long' (default).\n\nuk.getMonths()          // [ 'January', 'February', 'March', etc. ]\nuk.getMonths('short')   // [ 'Jan', 'Feb', 'Mar', etc. ]\nuk.getMonths('narrow')  // [ 'J', 'F', 'M', etc. ]\n\nuk.getDays()            // [ 'Sunday', 'Monday', 'Tuesday', etc. ]\nuk.getDays('short')     // [ 'Sun', 'Mon', 'Tue', etc. ]\nuk.getDays('narrow')    // [ 'S', 'M', 'T', etc. ]\n```\n\n### Static methods\n```javascript\n// Check for native browser support or the presence of a polyfill.\nVI18N.isSupported();\n```\n\n## License\n\nMIT © [VI Company](http://vicompany.nl)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvicompany%2Fvi18n","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvicompany%2Fvi18n","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvicompany%2Fvi18n/lists"}