docs(stdlib): edit Number/toLocalString()

ruanyf · ruanyf · commit b8523bcffed3 · 2019-10-07T00:05:25.000+08:00
diff --git a/docs/stdlib/number.md b/docs/stdlib/number.md
@@ -144,7 +144,7 @@ Number.MIN_SAFE_INTEGER // -9007199254740991
 
 ### Number.prototype.toPrecision()
 
-`toPrecision`方法用于将一个数转为指定位数的有效数字。
+`Number.prototype.toPrecision()`方法用于将一个数转为指定位数的有效数字。
 
 ```javascript
 (12.34).toPrecision(1) // "1e+1"
@@ -154,9 +154,9 @@ Number.MIN_SAFE_INTEGER // -9007199254740991
 (12.34).toPrecision(5) // "12.340"
 ```
 
-`toPrecision`方法的参数为有效数字的位数，范围是1到21，超出这个范围会抛出 RangeError 错误。
+该方法的参数为有效数字的位数，范围是1到21，超出这个范围会抛出 RangeError 错误。
 
-`toPrecision`方法用于四舍五入时不太可靠，跟浮点数不是精确储存有关。
+该方法用于四舍五入时不太可靠，跟浮点数不是精确储存有关。
 
 ```javascript
 (12.35).toPrecision(3) // "12.3"
@@ -165,6 +165,41 @@ Number.MIN_SAFE_INTEGER // -9007199254740991
 (12.45).toPrecision(3) // "12.4"
 ```
 
+### Number.prototype.toLocaleString()
+
+`Number.prototype.toLocaleString()`方法接受一个地区码作为参数，返回一个字符串，表示当前数字在该地区的当地书写形式。
+
+```javascript
+(123).toLocaleString('zh-Hans-CN-u-nu-hanidec')
+// "一二三"
+```
+
+该方法还可以接受第二个参数配置对象，用来定制指定用途的返回字符串。该对象的`style`属性指定输出样式，默认值是`decimal`，表示输出十进制形式。如果值为`percent`，表示输出百分数。
+
+```javascript
+(123).toLocaleString('zh-Hans-CN', { style: 'persent' })
+// "12,300%"
+```
+
+如果`style`属性的值为`currency`，则可以搭配`currency`属性，输出指定格式的货币字符串形式。
+
+```javascript
+(123).toLocaleString('zh-Hans-CN', { style: 'currency', currency: 'CNY' })
+// "￥123.00"
+
+(123).toLocaleString('de-DE', { style: 'currency', currency: 'EUR' })
+// "123,00 €"
+
+(123).toLocaleString('en-US', { style: 'currency', currency: 'USD' })
+// "$123.00"
+```
+
+如果`Number.prototype.toLocaleString()`省略了参数，则由浏览器自行决定如何处理，通常会使用操作系统的地区设定。注意，该方法如果使用浏览器不认识的地区码，会抛出一个错误。
+
+```javascript
+(123).toLocaleString('123') // 出错
+```
+
 ## 自定义方法
 
 与其他对象一样，`Number.prototype`对象上面可以自定义方法，被`Number`的实例继承。
