str_FirstPinyin函数

函数名：wb_拼音首字母 / str_FirstPinyin

函数功能

将文本中的每个汉字转换为其对应拼音的首字母（大写），保留非汉字字符原样，用于中文索引、简写生成、拼音排序等场景。

参数规范

参数名	类型	必填	示例	特殊说明
input	String	是	"中文AB"	支持直接文本或单元格引用，非中文字符保留原样

使用案例

· 生成拼音简写

问题描述：提取中文名称的拼音首字母作为缩写 公式演示：

=str_FirstPinyin("张三")

输出效果：

ZS

· 混合文本处理

问题描述：保留非汉字字符，仅提取汉字拼音首字母 公式演示：

=str_FirstPinyin("你好ABC")

输出效果：

NHABC

· 处理多字词组

问题描述：为地名或公司名生成拼音首字母缩写 公式演示：

=str_FirstPinyin("中国银行")

输出效果：

ZGYH

技术说明

· 汉字识别规则

• 使用 IsChineseCharacter(char) 方法判断字符是否为汉字（通常基于 Unicode 范围）

· 拼音提取逻辑

• 借助 Pinyin.GetPinyin(c) 获取单个汉字的全拼（如 "zhōng"）
• 提取拼音首字母，并转换为大写（如 Z）
• 若拼音无法识别，则返回 ? 作为占位符

· 非汉字处理

• 字母、数字、符号等非汉字字符原样保留，不参与拼音转换

异常处理

错误场景	返回值
输入为空或Null	空字符串
转换异常	错误: [异常信息]

· 多列生成助记符

结合姓氏与名字首拼生成用户代码：

=str_FirstPinyin(A2) & str_FirstPinyin(B2)

当A2为“张”，B2为“三”，输出：

ZS

注：本函数在WPS 2019+和Excel 365中测试通过，依赖拼音库支持完整拼音解析。