# **ENCODEURI**

编码URI。该方法的目的是对URI进行完整的编码，如下情况不会编码：

- ASCII字母和数字
- ASCII标点符号，包括：`-_.!~*'()`
- 具有特殊含义的ASCII标点符号，包括：`;/?:@&=+$,#`

## 语法{#grammar}

ENCODEURI(**uri**)

- **uri**：必需。一个含有URI或其他要编码的字符串，其他对象将转为字符串对象

**示例地址：** [ENCODEURI](https://demo.succbi.com/v5/bi/encodeuri)

## 示例{#example}

1. `ENCODEURI("http://www.w3school.com.cn")` 参数含有数字字母，返回字符串`http://www.w3school.com.cn`，不转义URI分隔符`:`、`/`
2. `ENCODEURI("http://www.w3school.com.cn/My first/")` 参数含有数字字母和空格，返回字符串`http://www.w3school.com.cn/My%20first/`，不转义URI分隔符`:`、`/`
3. `ENCODEURI("search=中文")` 参数含有中文，返回字符串`search=%E4%B8%AD%E6%96%87`
4. `ENCODEURI("/?:@&=+$#")` 参数含有`/?:@&=+$#`特殊字符，返回字符串`/?:@&=+$#`，不转义URI分割符
5. `ENCODEURI("- _ . ! ~ * ' ( )")` 参数含有ASCII标点符号，返回字符串`-%20_%20.%20!%20~%20*%20'%20(%20)`
6. `ENCODEURI("")` 参数为空字符串，返回空字符串
7. `ENCODEURI(NULL)` 参数为NULL，返回`null`
8. `ENCODEURI(NOW())` 参数为函数返回值，返回`20220509`，转为字符串运算
9. `ENCODEURI(FALSE)` 参数为布尔型，返回`false`
10. `ENCODEURI(A1)` 引用单元格，对`A1`表示的网址进行编码