Enrich instructions for string functions FORMAT() and FROM_BASE64()

functions-and-operators/string-functions.md

@@ -140,11 +140,100 @@ SELECT BIN("123q123");
 
 ### [`FORMAT()`](https://dev.mysql.com/doc/refman/8.0/en/string-functions.html#function_format)
 
-返回指定小数位数格式的数字
+`FORMAT(X,D[,locale])` 函数用于将数字 `X` 格式化为类似于 `“#,###,###.##”` 的格式，四舍五入保留 `D` 位小数，并将结果作为字符串返回。
+
+参数：
+
+- `X`：要格式化的数字。可以是直接的数字值、数字字符串、或科学记数法格式的数字。
+- `D`：指定返回值的小数位数。该函数根据 `D` 对 `X` 进行四舍五入。如果 `D` 大于 `X` 的实际小数位数，则会在结果中填充相应长度的零。
+- `[locale]`：指定一个区域设置，用于结果中数字的小数点、千位分隔符和分隔符之间的分组。合法的区域设置值与 [`lc_time_names`](https://dev.mysql.com/doc/refman/8.3/en/server-system-variables.html#sysvar_lc_time_names) 系统变量的合法值相同。如果未指定或者设置为 `NULL`，则默认使用 `'en_US'` 区域设置。该参数可选。
+
+行为细节：
+
+- 如果输入的第一个参数为字符串，且该字符串中只包含数字时，该函数将按照该数字返回结果。例如，`FORMAT('12.36', 1)` 与 `FORMAT(12.36, 1)` 的返回结果相同。
+- 如果输入的第一个参数为科学计数法（`E/e`）表示的数字时，该函数将按照该数字返回结果。例如，`FORMAT('1E2', 3)`），函数返回 `100.000`。
+- 如果输入的第一个参数为非数字开头的字符串时，该函数除了返回零值外，还返回一个警告 `(Code 1292)`。例如，`FORMAT('q12.36', 5)` 函数返回 `0.00000`，还会包含一个警告 `Warning (Code 1292): Truncated incorrect DOUBLE value: 'q12.36'`。
+- 如果输入的第一个参数为数字和非数字混合的字符串时，该函数将基于该参数中开头连续的数字部分返回结果，还返回一个警告 `(Code 1292)`。例如，`FORMAT('12.36q56.78', 1)` 与 `FORMAT('12.36', 1)` 的返回的数字结果相同，但 `FORMAT('12.36q56.78', 1)` 还会包含一个警告 `Warning (Code 1292): Truncated incorrect DOUBLE value: '12.36q56.78'`。
+- 如果输入的第二个参数为零或负数，该函数将四舍五入小数部分并返回整数。
+- 如果输入的任意参数为 `NULL`，函数将返回 `NULL`。
+
+示例：
+
+格式化数字 12.36 到不同的小数位数：
+
+```sql
+mysql> SELECT FORMAT(12.36, 1);
++------------------+
+| FORMAT(12.36, 1) |
++------------------+
+| 12.4             |
++------------------+
+```
+
+```sql
+mysql> SELECT FORMAT(12.36, 5);
++------------------+
+| FORMAT(12.36, 5) |
++------------------+
+| 12.36000         |
++------------------+
+```
+
+```sql
+mysql> SELECT FORMAT(1234.56, 1, 'en_US');
++-----------------------------+
+| FORMAT(1234.56, 1, 'en_US') |
++-----------------------------+
+| 1,234.6                     |
++-----------------------------+
+```
 
 ### [`FROM_BASE64()`](https://dev.mysql.com/doc/refman/8.0/en/string-functions.html#function_from-base64)
 
-解码 base-64 表示的字符串，并返回结果
+`FROM_BASE64(str)` 函数用于对 [Base64](https://datatracker.ietf.org/doc/html/rfc4648) 编码的字符串进行解码，并将解码结果以十六进制字符串的形式返回。
+
+- 此函数接受一个单一参数，即需要解码的 Base64 编码字符串。
+- 如果输入参数为 `NULL` 或无效的 Base64 编码字符串，`FROM_BASE64()` 函数将返回 `NULL`。
+
+示例：
+
+以下示例解码 Base64 编码的字符串 `'SGVsbG8gVGlEQg=='`，该字符串是 `'Hello TiDB'` 经过 [`TO_BASE64()`](#to_base64) 函数编码的结果。
+
+```sql
+mysql> SELECT TO_BASE64('Hello TiDB');
++-------------------------+
+| TO_BASE64('Hello TiDB') |
++-------------------------+
+| SGVsbG8gVGlEQg==        |
++-------------------------+
+
+mysql> SELECT FROM_BASE64('SGVsbG8gVGlEQg==');
++------------------------------------------------------------------+
+| FROM_BASE64('SGVsbG8gVGlEQg==')                                  |
++------------------------------------------------------------------+
+| 0x48656C6C6F2054694442                                           |
++------------------------------------------------------------------+
+```
+
+```sql
+mysql> SELECT CONVERT(FROM_BASE64('SGVsbG8gVGlEQg==') USING utf8mb4);
++--------------------------------------------------------+
+| CONVERT(FROM_BASE64('SGVsbG8gVGlEQg==') USING utf8mb4) |
++--------------------------------------------------------+
+| Hello TiDB                                             |
++--------------------------------------------------------+
+```
+
+以下示例解码 Base64 编码的数字 `MTIzNDU2`，该字符串是 `123456` 经过 [`TO_BASE64()`](#to_base64) 函数编码的结果。
+
+```sql
+mysql> SELECT FROM_BASE64('MTIzNDU2');
++--------------------------------------------------+
+| FROM_BASE64('MTIzNDU2')                          |
++--------------------------------------------------+
+| 0x313233343536                                   |
++--------------------------------------------------+
+```
 
 ### [`HEX()`](https://dev.mysql.com/doc/refman/8.0/en/string-functions.html#function_hex)