谨慎使用toLocaleString!!!

¿

美丽的API都是带刺的玫瑰

1. toLocaleString相关背景

掘金 - 想偷懒的话，toLocaleString 了解一下？

MDN - Date​.prototype​.toLocale​String()

MDN - Number​.prototype​.toLocale​String()

其实就是在说: 这个API能够省不少事儿, 方便的对时间/数字按照必定格式进行转换, 不用你写正则, 不用你拖库

1.1 经常使用时间转换

以经常使用时间格式: YYYY-MM-DD HH:mm:ss为例, 一般用库day.js或者moment.js来完成

format('YYYY-MM-DD HH:mm:ss')
复制代码

使用toLocaleString的话

new Date()
  .toLocaleString('zh', { hour12: false }) // "2019/4/21 13:00:09"
  .replace(/\//g, '-') // "2019-4-21 13:00:23"
复制代码

1.2 经常使用数字转换

例如: 整数部分每三位加一个逗号, 一般用正则完成

const number = 123456789
number.toString().replace(/\B(?=(\d{3})+\b)/g, ',') // "12,345,678"
复制代码

使用toLocaleString的话

const number = 123456789
number.toLocaleString() // "12,345,678"
复制代码

2. 坑

上面的一切看着都很美好, 虽然它有浏览器兼容问题, 可是我以为在node.js中使用的话, 应该是能够把这份美好延续下去的

可是在一次提交中, 升级了node版本, 涉及到toLocaleString的地方都出现了不少问题

FROM node:8.9-alpine

// 更改成
FROM node:lts-alpine
复制代码

打破了这份美好, 测试代码以下

// index.js 
console.log("en: " + new Date().toLocaleString('en', { hour12: false }))
console.log("zh: " + new Date().toLocaleString('zh', { hour12: false }))


// Dockerfile
FROM node:8.9-alpine
COPY . /app
CMD ["node", "/app/index.js"]

复制代码

镜像node:8.9-alpine输出

en:   4/21/2019, 06:42:03
zh:   2019-4-21 06:42:03  (预期)
复制代码

镜像node:10.15-alpine输出

en:   4/21/2019, 06:43:13
zh:   4/21/2019, 06:43:13
复制代码

镜像node:11.14-alpine输出

en:   4/21/2019, 06:43:59
zh:   4/21/2019, 06:43:59
复制代码

镜像node:11.14输出

en:   4/21/2019, 06:46:54
zh:   4/21/2019, 06:46:54
复制代码

本地node.js 11.13输出, 怪不得本地调试是好的....

en:   4/21/2019, 14:49:27
zh:   2019-4-21 14:49:27
复制代码

Chrome浏览器

en:   4/21/2019, 14:51:33
zh:   2019/4/21 14:51:33
复制代码

3. 具体缘由: 国际化支持

Node.js / JavaScript的许多功能是提供国际化支持的, 例如

• String.prototype.normalize()

• String.prototype.toLowerCase()

• Date.prototype.toLocaleString()

• require('buffer').transcode()

• ...略

Node.js(及其底层V8引擎)使用ICU实现这些功能

可是要支持世界上全部的语言环境须要一份很是大的ICU数据文件, 而大多数用户仅会使用ICU功能的一小部分, 所以默认状况下Node.js仅提供完整ICU数据集的子集

3.1 构建Node.js的ICU选项

• --with-intl=none/--without-intl: 禁用全部国际化功能

• --with-intl=system-icu: 取决于系统, 大多数linux发行版都安装了ICU

• --with-intl=small-icu(默认): 完整ICU的一部分, 基本等价于: 仅限英文

• --with-intl=full-icu: 完整的支持

3.2 在运行时提供ICU数据

1. npm模块: full-icu: 安装完整的ICU数据

• 经过npm i full-icu, 数据文件将会拷贝在./node_modules/full-icu,

2. 经过设置环境变量NODE_ICU_DATA指定运行时的ICU选项

• env NODE_ICU_DATA=/some/directory node

3.3 测试

• npm install full-icu, 确保package.json中有full-icu

• 编写以下的Dockerfile

FROM node:lts-alpine

WORKDIR /app

COPY package.json /app

RUN yarn --registry=https://registry.npm.taobao.org

COPY . /app

ENV NODE_ICU_DATA /app/node_modules/full-icu

CMD ["node", "/app/index.js"]
复制代码

输出

en:   4/21/2019, 09:13:13
zh:   2019/4/21 09:13:13
复制代码

虽然和预期2019-4-21 09:13:13有点区别... 仍是能说明有效吧- -

4. 小结

1. 对于toLocaleString这个API, 浏览器环境下不兼容问题更多, Node环境下也会出现不一致的问题, 但能够经过设置ICU来解决

2. 从开发角度来讲: API 虽然酷炫, 可是相比之下仍是day.js / momemnt.js更稳定

3. 涉及Node国际化支持的相关知识, 这部分能够参考官方文档Internationalization Support