GetLocaleStr - C++ Builder

C++ Builder 参考手册 ➙ System::Sysutils ➙ GetLocaleStr

---

获取日期时间、货币和数字的格式中，用字符串表示的格式或符号

头文件：#include
命名空间：System::Sysutils
函数原型：

System::UnicodeString __fastcall GetLocaleStr(int Locale, int LocaleType, const System::UnicodeString Default);

参数：

• Locale: 地区的 LCID，如果是 Windows 操作系统可以用 MAKELANGID 生成；
• LocaleType：获取格式的项目类型，常用的参数值为：
  • LOCALE_SCURRENCY：货币符号，例如 L"¥", L"$", L"NT$"
  • LOCALE_ICURRENCY：货币符号的位置，例如 等
  • LOCALE_INEGCURR：负数金额的格式
  • LOCALE_ICURRDIGITS：货币默认小数点后保留位数
  • LOCALE_S1159 ：上午的名称，例如 L"上午" 或 L"AM"
  • LOCALE_S2359：下午的名称，例如 L"下午" 或 L"PM"
  • LOCALE_SSHORTDATE：短日期格式，例如 L"yyyy/M/d"
  • LOCALE_SLONGDATE：长日期格式，例如 L"yyyy'年'M'月'd'日'"
  • LOCALE_STIMEFORMAT：长时间格式，例如 L"h:mm:ss"
  • LOCALE_SSHORTTIME：短时间格式，例如 L"h:mm"
  • 其他参数值请参考 Windows API 函数 GetLocaleInfo；
• Default：默认值，如果函数获取地区信息失败，用这个值代替；

返回值：

• 日期时间、货币和数字的格式中，参数 LocaleType 指定的用字符串表示的格式或符号；
• 如果函数执行失败，返回参数 Default 的值；
• 在 Windows 操作系统里面，通过调用 API 函数 GetLocaleInfo 实现；
• 这个函数是函数库内部调用的，应用程序一般只需要：
  • 通过 TFormatSettings fmt = TFormatSettings::Create(Locale); 获取地区 Locale 的格式；
  • 通过全局变量 FormatSettings 获取或修改应用程序默认的地区格式；
  • 通过调用 GetFormatSettings 函数让全局变量 FormatSettings 恢复为系统默认格式。

---

相关：

• System::Sysutils::FormatSettings
• System::Sysutils::TFormatSettings
• System::Sysutils::SysLocale
• System::Sysutils::TSysLocale
• System::Sysutils::GetFormatSettings
• System::Sysutils::GetLocaleFormatSettings
• System::Sysutils::TLocaleID
• System::Sysutils::TLocaleOptions
• System::Sysutils::GetLocaleChar
• System::Sysutils::GetLocaleDirectory
• System::Sysutils::GetLocaleFile
• System::Sysutils::GetLocaleStr
• System::Sysutils::LocaleDirectoryExists
• System::Sysutils::LocaleFileExists
• System::Sysutils::Languages
• System::Sysutils::TLanguages
• System::Sysutils::TLangRec
• System::Sysutils::ILanguageEnumerable
• System::Sysutils::ILanguageEnumerator
• System::Sysutils::GetDefaultFallbackLanguages
• System::Sysutils::SetDefaultFallbackLanguages
• System::Sysutils::PreferredUILanguageList
• System::Sysutils::PreferredUILanguages
• System::Sysutils::FloatToStr
• System::Sysutils::FloatToStrF
• System::Sysutils::FloatToText
• System::Sysutils::FloatToTextFmt
• System::Sysutils::FloatToDecimal
• System::Sysutils::TextToFloat
• System::Sysutils::StrToFloat
• System::Sysutils::StrToFloatDef
• System::Sysutils::TryStrToFloat
• System::Sysutils::StrToCurr
• System::Sysutils::StrToCurrDef
• System::Sysutils::TryStrToCurr
• System::Sysutils::CurrToStr
• System::Sysutils::CurrToStrF
• System::Sysutils::FormatFloat
• System::Sysutils::FormatCurr
• System::Sysutils::DateTimeToStr
• System::Sysutils::DateTimeToString
• System::Sysutils::DateToStr
• System::Sysutils::TimeToStr
• System::Sysutils

---

C++ Builder 参考手册 ➙ System::Sysutils ➙ GetLocaleStr