将 ICU4J 中的序数词字符串（如 "FOURTH"）安全转换为整数

在使用 ICU4J 做自然语言数字解析的时候，有一个坑特别容易踩到：很多人想当然地认为 RuleBasedNumberFormat.ORDINAL 既能“输出”序数词，也能反向把 "FOURTH" 这样的字符串“解析”成整数 4。但老实说，这个模式压根儿没有解析能力——它的唯一使命是把数字格式化成序数词（比如 4 → "4th"），而不是反过来。

真正能处理 "fourth"、"twenty-first" 这类拼写形式的，其实是 RuleBasedNumberFormat.SPELLOUT 模式。这个模式专为“把数字拼出来”而设计，既支持基数词也支持序数词。但它有一个隐蔽的前提：默认只接受小写输入。如果你扔进去一个大写的 "FOURTH"，解析器会直接罢工，给你返回 0——这可不是你想要的。

所以，推荐的做法如下：

import com.ibm.icu.text.RuleBasedNumberFormat;
import com.ibm.icu.text.ParseException;

public class OrdinalStringParser {
    public static int parseOrdinalString(String input, Locale locale) throws ParseException {
        if (input == null || input.trim().isEmpty()) {
            throw new IllegalArgumentException("Input string cannot be null or empty");
        }
        RuleBasedNumberFormat formatter = new RuleBasedNumberFormat(locale, RuleBasedNumberFormat.SPELLOUT);
        // 必须转为小写：SPELLOUT 解析器对大小写敏感，大写字符串（如 "FOURTH"）会解析失败并返回 0
        String normalized = input.trim().toLowerCase(Locale.ROOT);
        Number result = formatter.parse(normalized);
        return result.intValue();
    }

    // 示例调用
    public static void main(String[] args) {
        try {
            System.out.println(parseOrdinalString("FOURTH", Locale.US));   // 输出: 4
            System.out.println(parseOrdinalString("twenty-first", Locale.US)); // 输出: 21
            System.out.println(parseOrdinalString("SEVENTH", Locale.UK));  // 输出: 7
        } catch (ParseException e) {
            System.err.println("Failed to parse ordinal string: " + e.getMessage());
        }
    }
}

这里有几个关键点需要注意：

• ✅ 归一化时务必使用 toLowerCase(Locale.ROOT)，而不是简单的 toLowerCase()。为什么？因为某些语言环境（比如土耳其语）下字母 'I' 转小写会有特殊行为，用 ROOT 能保证跨平台一致性。
• ❌ 不要试图用 RuleBasedNumberFormat.ORDINAL 做解析——这个模式根本没有 parse() 的语义支持，强行用只会得到意想不到的结果。
• ? SPELLOUT 模式支持多种语言的基数词和序数词，比如英语的 "first"、德语的 "erste"，但记得要匹配对应的 Locale。
• ⚠️ 解析失败时 parse() 会返回 null 或抛出 ParseException（取决于 ICU 版本），千万别当没看见——如果不做异常处理也不校验返回值，代码会静默认为 0，这种隐蔽 bug 排查起来很费劲。

总结一下：正确的路线其实只有一条——选择 SPELLOUT 模式 + 强制小写归一化 + 显式异常处理。这是 ICU4J 里把序数词字符串安全转换为整数的标准做法，没有捷径可走。