谨慎使用toLocaleString

[Caaalabash]

¿

美丽的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