拼音首字母

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

功能描述

获取文本中每个汉字的拼音首字母并组合返回。非汉字字符（字母、数字、符号等）保持原样输出。基于 NPinyin 库实现拼音转换。

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

语法

=str_FirstPinyin(中文文本)

参数

参数名	类型	必填	默认值	说明
中文文本	String	是	无	要转换的中文文本，可含非汉字字符

返回值

String - 每个汉字对应拼音首字母（大写）的组合字符串，非汉字字符原样保留。

使用示例

中文转拼音首字母

公式：

=str_FirstPinyin("中华人民共和国")

结果：

ZHRMGHG

中英文混合

公式：

=str_FirstPinyin("Excel函数2025")

结果：

ExcelHS2025

单个汉字

公式：

=str_FirstPinyin("中")

结果：

Z

技术说明

• 逐字符遍历输入文本，使用 IsChineseCharacter 方法判断字符是否为汉字（CJK 统一汉字范围 0x4E00-0x9FFF）
• 汉字字符通过 NPinyin 库的 Pinyin.GetPinyin(c) 获取完整拼音，再取拼音首字母并转为大写
• 非汉字字符直接追加到结果中，保持原样不变
• 若拼音库未收录某汉字（返回空拼音），该位置输出 ? 作为占位符
• 空字符串或 null 输入原样返回

错误处理

错误场景	返回值
输入为空或 null	原样返回（空字符串或 null）
汉字未被拼音库收录	该字符输出 ?
处理过程中发生异常	"错误: {异常信息}"