C++ Builder 参考手册 ➙ System::Sysutils ➙ GetLocaleStr
获取日期时间、货币和数字的格式中,用字符串表示的格式或符号
头文件:#include <System.SysUtils.hpp>
命名空间: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