{"_id":"@aligov/global-locale","_rev":"8-81926e025decde7acd4f0d59602079ee","name":"@aligov/global-locale","description":"locale information manager","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.5":{"name":"@aligov/global-locale","version":"1.0.5","license":"ISC","_id":"@aligov/global-locale@1.0.5","maintainers":[{"name":"shenyu.wsy","email":"shenyu.wsy@alibaba-inc.com"},{"name":"liunian","email":"dengjij@gmail.com"},{"name":"tao1991123","email":"tao360907796@gmail.com"},{"name":"itrip","email":"1198488651@qq.com"},{"name":"xiazhiqiang","email":"xiazhiqiangcuc@126.com"},{"name":"zhousufa","email":"zhousufa@gmail.com"},{"name":"mo.zhou","email":"bjfuzm@163.com"},{"name":"guoliang.hgl","email":"guoliang.hgl@alibaba-inc.com"},{"name":"zwhu","email":"zwhu2014@foxmail.com"},{"name":"daip","email":"15858208586@163.com"},{"name":"baizhao","email":"ethan.cqw@alibaba-inc.com"}],"dist":{"shasum":"8789f98be0a2738f10ee9d1e6604842d1775065c","tarball":"https://registry.npmjs.org/@aligov/global-locale/-/global-locale-1.0.5.tgz","fileCount":19,"integrity":"sha512-mJwkCd98zyL2L1x6V3Ke9rcVSUZOsFqjwN67ykw9LJxxiMS0blYsw7qABTTaUxPFsVo5de6X54m2psp9geLzsA==","signatures":[{"sig":"MEQCIEvC6yx5OgcIaj0wdNqkOXpn45YYk3svUjIWCHJnE+g5AiAKmcBzv57Fx/c5t8/qDvfNhBGH6dgiecZqZSBFxrx6kA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":79605,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhzEllCRA9TVsSAnZWagAAaX8QAJq0dQAqrbM/MuyogSZD\n+GZrRRkalMyfhDF3ABd+45w2uQDIuew99KK5dl9Na+5yQxeatCg5YmYPpE+T\nWDl2tKM4oExfKhC4pc2mBa6gddn63d3/EFU101GPqPciH4WY9R6XWG2F4+X/\nFMKOH1giFbEoXp7qVSJNK5vBOzWFjbh8tYGvFlaGvWa1cUrZBrAua653HeHX\nhF4Y7HtKkfJHh/cI7BK2tOLe7YWwNB6MluS+mw9U1a5nvGj1w40+pc8EpHqe\nCeqe5qGo5H3twXBNsE36EmB/gKXvWXPjqvKp2adLl72L8oAhrQVW7oDCFUgt\nrFM3sfMMrlAyrD3Ke2PMPbZ6ItIFN0uXBdvt+NKz2EIiYpBaw7ShXfqFzxj8\nNrzxLmp0BR6/gT2grnRnBIVk29roXXt0TBSDofeJAj26/PxRdxDJrT+8T6Bn\nRTjs1zVlwAazp/Rum9SK5iLybwgtpJ1GxsreyEljggpYbn+F0fJwvrx/lceR\nXJCB/n1F83fEQdj8fER0EG0wk87WmYKFA0CqSmuFMtzMe9bmGI/RdDHLkP0E\nS9KCAokZNVazqSMRTNyOVMCqkUps19jOvEDLA5y+eOUMQrFET3TxUpPBq4Tf\nAM0FHvleVp7nbPlfkLtKELNAt3Mo6QpQBQG8CbwoGBdRX7qtv2iYKje0MTIY\nH4Ba\r\n=LpG/\r\n-----END PGP SIGNATURE-----\r\n"},"main":"lib/index.js","_from":"@aligov/global-locale@1.0.5","scripts":{"test":"concurrently \"node_modules/.bin/http-server ./\" \"node_modules/.bin/electron script/electron-test/main.js\"","build":"npm run build:types && npm run build:js","start":"concurrently npm:build:types:watch npm:build:js:watch npm:electron-test","eslint":"git diff-index --name-only HEAD | grep -E \"(.*\\/)?src\\/(.*)\\.(jsx|js|ts|tsx)$\" | xargs node_modules/eslint/bin/eslint.js -c .eslintrc.js","webpack":"concurrently npm:build:types:watch npm:build:js:watch \"node_modules/.bin/webpack-dev-server --config script/compatibility-test/webpack.js\"","build:js":"babel src --out-dir lib --extensions \".ts,.tsx\" --source-maps ","type-check":"tsc --noEmit","build:types":"tsc --emitDeclarationOnly","build:js:watch":"babel src --out-dir lib --extensions \".ts,.tsx\" --source-maps --watch","type-check:watch":"npm run type-check -- --watch","build:types:watch":"tsc --emitDeclarationOnly -w","compatibility-test":"node script/compatibility-test/index"},"_npmUser":{"name":"baizhao","email":"ethan.cqw@alibaba-inc.com"},"_resolved":"https://registry.npm.alibaba-inc.com/@aligov/global-locale/download/@aligov/global-locale-1.0.5.tgz","pre-commit":["eslint"],"_npmVersion":"6.13.4","description":"locale information manager","directories":{},"_nodeVersion":"12.13.0","browserslist":["cover 99.5%","ie 11"],"_hasShrinkwrap":false,"devDependencies":{"chai":"^4.2.0","find":"^0.3.0","karma":"^4.1.0","mocha":"^6.1.4","eslint":"^5.16.0","webpack":"^4.30.0","electron":"^5.0.1","minimist":"^1.2.0","@babel/cli":"^7.4.4","pre-commit":"^1.2.2","typescript":"^3.4.5","@babel/core":"^7.4.4","@types/node":"^11.13.8","http-server":"^0.11.1","karma-mocha":"^1.3.0","webpack-cli":"^3.3.2","babel-eslint":"^10.0.1","concurrently":"^4.1.0","mocha-loader":"^2.0.1","power-assert":"^1.6.1","eslint-tinker":"^0.5.0","karma-webpack":"^3.0.5","core-js-compat":"^3.0.1","karma-coverage":"^1.1.2","@babel/preset-env":"^7.4.4","webpack-dashboard":"^3.0.5","eslint-plugin-jest":"^22.5.1","webpack-dev-server":"^3.3.1","eslint-plugin-babel":"^5.3.0","eslint-plugin-react":"^7.13.0","html-webpack-plugin":"^3.2.0","eslint-config-airbnb":"^17.1.0","eslint-plugin-import":"^2.17.2","karma-chrome-launcher":"^2.2.0","eslint-config-prettier":"^4.2.0","eslint-plugin-jsx-a11y":"^6.2.1","eslint-plugin-markdown":"^1.0.0","karma-sourcemap-loader":"^0.3.7","@babel/preset-typescript":"^7.3.3","karma-webdriver-launcher":"^1.0.5","@typescript-eslint/parser":"^1.7.0","@typescript-eslint/eslint-plugin":"^1.7.0","@babel/plugin-proposal-class-properties":"^7.4.4","@babel/plugin-proposal-object-rest-spread":"^7.4.4"},"__npminstall_done":true,"_npmOperationalInternal":{"tmp":"tmp/global-locale_1.0.5_1635998772298_0.6481103413593245","host":"s3://npm-registry-packages"}}},"time":{"created":"2021-11-04T04:06:12.245Z","modified":"2024-07-04T09:19:10.512Z","1.0.5":"2021-11-04T04:06:12.446Z"},"maintainers":[{"email":"wanyi.css@alibaba-inc.com","name":"wanyi.css"},{"email":"17682318001@163.com","name":"jasoncapricorn"},{"email":"chris_jun@aliyun.com","name":"qingkaili"},{"email":"hgxjyh@163.com","name":"huguoxin"},{"email":"shenyu.wsy@alibaba-inc.com","name":"shenyu.wsy"},{"email":"dengjij@gmail.com","name":"liunian"},{"email":"tao360907796@gmail.com","name":"tao1991123"},{"email":"1198488651@qq.com","name":"itrip"},{"email":"xiazhiqiangcuc@126.com","name":"xiazhiqiang"},{"email":"bjfuzm@163.com","name":"mo.zhou"},{"email":"guoliang.hgl@alibaba-inc.com","name":"guoliang.hgl"},{"email":"15858208586@163.com","name":"daip"},{"email":"ethan.cqw@gmail.com","name":"baizhao"}],"license":"ISC","readme":"## @aligov/global-locale \n\n### 主要特征\n- 提供获取和设置地区/语言/货币/时区等 locale 信息能力\n- 遵循[国际化开发规约](https://yuque.antfin-inc.com/ioc-doc/must-doc)\n- 抹平不同容器(web/weex/windVane/小程序)之间的差异\n\n### 安装 \n \n```\ntnpm install @aligov/global-locale --save\n```\n\n### API\n\n#### getLocale\n\n获取当前 locale 信息\n\n```js\nimport locale from '@aligov/global-locale';\n\nconst { region,lang, currency, tz} = locale.getLocale();\n\nconsole.log(region,lang, currency, tz); // CN, zh-CN, CNY, Asia/Shanghai\n```\n\n注意: 所有的locale 信息的 set 操作, 在 web 环境下生效, weex 和 windVane 跟随应用的设置.\n\n#### setRegion\n\n> locale cookie 存储默认 domain 为 location.hostname, path 为'/', 时间为一个月\n\n设置地区, 地区编码见[https://yuque.antfin-inc.com/ioc-1/specification/region](https://yuque.antfin-inc.com/ioc-1/specification/region)\n\n```js\nimport locale from '@aligov/global-locale';\nlocale.setRegion('CN'); \n\n```\n\n#### setLang\n设置语言, 语言编码见[https://yuque.antfin-inc.com/ioc-1/specification/language](https://yuque.antfin-inc.com/ioc-1/specification/language)\n\n```js\nimport locale from '@aligov/global-locale';\nlocale.setLang('zh-CN');\n```\n\n#### setCurrency\n设置货币, 货币编码见[https://yuque.antfin-inc.com/ioc-1/specification/currency](https://yuque.antfin-inc.com/ioc-1/specification/currency)\n\n```js\nimport locale from '@aligov/global-locale';\nlocale.setCurrency('CNY');\n```\n#### setTimeZone\n设置时区, 时区编码见[https://yuque.antfin-inc.com/ioc-1/specification/time-zone](https://yuque.antfin-inc.com/ioc-1/specification/time-zone)\n```\n```js\nimport locale from '@aligov/global-locale';\nlocale.setTimeZone('CNY');\n```\n#### setLocale \n设置自定义的 locale 信息\n\n```js\nimport locale from '@aligov/global-locale';\nlocale.setLocale('site', 'rus');\n\nconst localeInfo = locale.getLocale();\nconsole.log(localeInfo.site); // rus\n```\n\n#### 提供标准的cookie读写函数\n\n```js\nimport { Cookie } from '@aligov/global-locale';\n\n/**\n * 获取 cookie 的值\n * @param {string} key , the key of cookie , if not set, will return all the cookie\n */\nCookie.get('x-hng')  ==> //region=CN&lang=zh-CN&currency=CNY\n\n/**\n * 设置 cookie 的值\n * @param {string} key\n * @param {string} value\n * @param {object} attributes \n */\nCookie.set('x-hng','region=CN&lang=zh-CN&currency=CNY', {\n  maxAge: 24*30*60*60, //最好设置 cookie 的过期时间, 不然 cookie 的过期时间就是 session 时间, 也就是关闭窗口的时间\n  path: '/', // domain 为当前页面 domain\n}) \n\n/**\n * 移除 cookie \n * @param {string} key\n */ \nCookie.remove('x-hng')\n\n```\n\n### 自定义 Locale 信息, \n我们提供用户自定义的方式来处理 locale 信息.\n\n```js\nconst myLocale = locale.create({\n  key: 'my-name', // lolale 存储的 cookie 的 key 或者 在 windvane / weex 等环境下 locale 存放的位置, 默认为 x-hng\n  domain: '.lazada.vn', // cookie domain, 默认为  location.hostname \n  path: '/' , // cookie path, 默认为'/', \n  maxAge: 30*24*60*60 // cookie 过期时间, 秒为单位, 默认时长为 180 天.\n})\n```","readmeFilename":"readme.md"}