# **LEFT**

从字符串的第一个字符开始返回指定个数的字符。

## 语法{#grammar}

LEFT(**str**, **num**)

- **str**：给定的字符串对象
- **num**：非负整数，指定返回的字符数量。它的合法取值是1到字符串长度
  - 如果num小于或等于0或者为NaN类型时，返回空字符串
  - 如果num大于字符串长度，返回整个字符串

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

## 示例{#example}

1. `LEFT("qwer",2)` 返回字符串前两位字母`qw`
2. `LEFT("210502198412020944",6)` 返回身份证的地区码`210502`
3. `LEFT("zhangming@qq.com",FIND("zhangming@qq.com","@"))` 返回邮件的用户名`zhangming` [FIND](./FIND.md)函数
4. `CONCAT(LEFT("这件商品现在卖的很火",4),"......")` 描述只显示部分信息`这件商品......` [CONCAT](./CONCAT.md)函数
5. `IF(LEFT("湖北省武汉市江岸区建设大道",FIND("湖北省武汉市江岸区建设大道","省"))="湖北","属于","不属于")` 判断地址是不是属于湖北省`属于` [IF](../logic/IF.md)函数
6. `CONCAT(LEFT(E14,4),"-",MID(E14,4,4),"-",MID(E14,8,4),"-",RIGHT(E14,4))` 银行卡号分段显示`6226-0902-1929-8748`
7. `LEFT("湖北省武汉市",3)` 字符串为汉字返回`湖北省`
8. `LEFT(A1,4)` 返回单元格A1的前四位，即生产季节的年份`2016`
9. `LEFT([门店销售明细表].[生产季节],4)` 参数值返回生产季节的年份`2016`