str_Substr函数

函数名：wb_文本截取 / str_Substr

函数功能

从原始文本中按指定起始位置与长度提取子字符串，支持默认提取到末尾，用于字符串裁剪、字段提取等场景。

参数规范

参数名	类型	必填	示例	特殊说明
input	String	是	"Excel函数库"	需要截取的原始文本
startIndex	Int	是	2	起始索引位置（从0开始）
length	Int	否	3	截取的长度，默认-1表示截取到末尾

使用案例

· 截取指定长度

问题描述：从文本第2个字符开始截取3个字符 公式演示：

=str_Substr("Excel函数库", 1, 3)

输出效果：

xce

· 仅指定起始位置，默认截到末尾

问题描述：从第3个字符开始提取所有后续内容 公式演示：

=str_Substr("函数大全", 2)

输出效果：

大全

· 起始位置超出文本范围

问题描述：从无效位置开始截取，返回错误提示 公式演示：

=str_Substr("Hello", 10, 2)

输出效果：

错误: 起始位置超出范围

技术说明

• 字符索引从 0 开始，即第一个字符索引为0
• length = -1 时自动延伸到字符串结尾
• 若 startIndex + length 超出字符串长度，将自动截取到末尾

异常处理

错误场景	返回值
原文本为空或null	空字符串或原样返回
起始位置超出有效范围	"错误: 起始位置超出范围"
运行异常	错误: [异常信息]

扩展应用

· 提取日期、编码片段

=str_Substr("2025-07-18", 5, 2)  // 提取月份

输出效果：

07

· 与其他函数组合提取

=VALUE(str_Substr(A2, 0, 4))  // 将前四位截取后转为数值

注：本函数在WPS 2019+ 和 Excel 365 中测试通过，支持中英文与多字节字符截取。