Python 庫手冊：locale 地區(qū)設(shè)置

locale 是 Python 標準庫，用于處理與地區(qū)設(shè)置（Locale）相關(guān)的問題，例如：數(shù)字格式、貨幣格式、日期格式、字符串比較規(guī)則等。它使程序能夠根據(jù)不同國家與地區(qū)的習慣展示內(nèi)容，是國際化（i18n）與本地化（l10n）的基礎(chǔ)工具之一。

locale 封裝了底層 C 庫的本地化接口，可以在 Python 中輕松設(shè)置區(qū)域環(huán)境，從而影響數(shù)值解析、文本排序、貨幣顯示等行為。

常見應用場景：

（1）數(shù)字和貨幣格式化

根據(jù)用戶地區(qū)自動將數(shù)值顯示為本地格式，例如 1,234.50（美國）或 1.234,50（德國）。

（2）日期與時間本地化

將日期顯示成當?shù)亓晳T格式，如 2025-12-26、26/12/2025、12/26/2025 等。

（3）國際化應用開發(fā)（i18n）

系統(tǒng)工具、桌面軟件、Web 服務中根據(jù)用戶語言環(huán)境調(diào)整顯示格式。

（4）文本排序（Collation）

按本地區(qū)習慣進行字符串比較，例如中文拼音排序、法文重音符排序。

（5）從字符串解析數(shù)值

按本地規(guī)則解析帶千分位的數(shù)字等。

◆ ◆ ◆

核心概念

1、Locale（地區(qū)設(shè)置）

Locale 本質(zhì)上是一組配置，包括語言、國家、字符編碼等，例如：

? "en_US.UTF-8"：美國英語

? "zh_CN.UTF-8"：簡體中文

? "de_DE"：德語（德國）

設(shè)置 locale 后，數(shù)值格式、貨幣格式等解析方式都會隨之改變。

2、類別（Category）

locale 不一定一次性修改所有設(shè)置，可以按類別調(diào)整：

? LC_NUMERIC：數(shù)字格式

? LC_TIME：時間格式

? LC_MONETARY：貨幣格式

? LC_COLLATE：字符串排序

? LC_ALL：設(shè)置所有類別（常用）

3、當前區(qū)域（Current Locale）

使用 getlocale() 和 setlocale() 操作當前生效的區(qū)域環(huán)境。

4、格式化函數(shù)（format_string、currency 等）

根據(jù)地區(qū)規(guī)則格式化數(shù)字、日期、貨幣等。

◆ ◆ ◆

應用舉例

例 1：設(shè)置區(qū)域環(huán)境

print(locale.getlocale())

例 2：數(shù)字格式化

# 輸出：12,345.68

例 3：貨幣格式化

# 輸出：$1,999.99

例 4：解析數(shù)字（字符串 → 數(shù)字）

print(num)   # 輸出：1234.56

例 5：按本地規(guī)則排序

print(sorted(words, key=locale.strxfrm))

◆ ◆ ◆

常用函數(shù)與類速覽

setlocale(category, locale=None)

設(shè)置當前程序的地區(qū)環(huán)境。

參數(shù)：

category：類別（LC_ALL、LC_NUMERIC 等）。

locale：字符串形式的區(qū)域（如 "en_US.UTF-8"），不傳則查詢當前值。

返回：當前生效的地區(qū)設(shè)置字符串。

getlocale(category=LC_CTYPE)

獲取當前地區(qū)設(shè)置。

參數(shù)：類別。

返回：(language, encoding) 元組。

localeconv()

獲取當前地區(qū)的數(shù)字與貨幣格式信息。

返回：字典，包含小數(shù)點、千分位、貨幣符號等設(shè)置。

format_string(format, val, grouping=False)

按地區(qū)規(guī)則格式化數(shù)字與字符串。

參數(shù)：

format：格式化樣式。

val：值。

grouping：是否啟用千分位。

返回：格式化字符串。

currency(val, symbol=True, grouping=False)

格式化貨幣數(shù)據(jù)。

參數(shù)：

val：數(shù)值。

symbol：是否包含貨幣符號。

grouping：是否包含千分位。

返回：格式化字符串。

atof(string)

按本地規(guī)則將字符串解析為浮點數(shù)。

參數(shù)：數(shù)字字符串。

返回：浮點數(shù)。

atoi(string)

按本地規(guī)則解析整數(shù)。

參數(shù)：數(shù)字字符串。

返回：整數(shù)。

strxfrm(string)

用于按地區(qū)排序時的轉(zhuǎn)化函數(shù)。

參數(shù)：字符串。

返回：可用于排序的轉(zhuǎn)換結(jié)果。

◆ ◆ ◆

補充說明

（1）Windows 與 Linux 的可用 locale 不完全一致，例如 Windows 風格通常是："Chinese_China.936"。

（2）必須確保系統(tǒng)本身支持該地區(qū)設(shè)置，否則 setlocale() 會報錯。

（3）locale 會影響全局狀態(tài)，因此在大型應用中請謹慎使用。

（4）若用于多線程環(huán)境，建議避免頻繁切換地區(qū)設(shè)置。

（5）locale 不負責字符串翻譯（i18n 文本翻譯由 gettext 或 Babel 完成）。

小結(jié)

locale 庫是 Python 進行本地化處理的核心工具，能讓程序根據(jù)用戶地區(qū)自動調(diào)整數(shù)字、貨幣、日期與排序方式。通過設(shè)置 Locale 并使用格式化函數(shù)，可以輕松實現(xiàn)國際化應用的本地化展示。它適用于桌面軟件、后端服務以及需要針對不同地區(qū)用戶展示內(nèi)容的系統(tǒng)場景，是國際化開發(fā)中不可或缺的基礎(chǔ)模塊。

“點贊有美意，贊賞是鼓勵”