文本截取

⚠️ 此函数已废弃：此函数在当前版本源代码中不再存在，请使用 Excel 内置函数 MID() 替代。

函数名：wb_文本截取 / str_Substr

功能描述

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

会员等级：🟢 免费版（Free）

语法

=str_Substr(文本, 起始位置, 长度)

参数

参数名	类型	必填	默认值	说明
文本	String	是	无	需要截取的原始文本
起始位置	Int	是	无	起始索引位置（从 0 开始）
长度	Int	否	-1	截取的长度，-1 表示截取到末尾

返回值

String - 截取出的子字符串。

使用示例

截取指定长度

公式：

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

结果：

xce

替代方案（推荐）

公式：

=MID("Excel函数库", 2, 3)

结果（注意 Excel 内置函数使用 1 基索引）：

xce

技术说明

• 原实现字符索引从 0 开始，即第一个字符索引为 0
• 长度 = -1 时自动延伸到字符串结尾
• 若 起始位置 + 长度 超出字符串长度，自动截取到末尾
• 注意：Excel 内置函数 MID 使用 1 基索引，迁移时需调整起始位置

错误处理

错误场景	返回值
函数已废弃，不可调用	#NAME?
原文本为空或 null	空字符串或原样返回（原实现行为）
起始位置超出有效范围	"错误: 起始位置超出范围"（原实现行为）