nl_langinfo() 獲取AM/PM 時間標識的用法示例

gitbox 2025-05-27

在PHP 中， nl_langinfo()函數用於獲取當前環境的本地化信息，如日期、時間格式等。這個函數依賴於系統的區域設置（locale），可以返回諸如星期名稱、月份名稱、日期格式等多種本地化字符串。

然而，對於獲取AM/PM 標識（即上午/下午的本地化字符串）， nl_langinfo()並沒有提供一個直接的常量。很多開發者會疑惑，怎樣才能用nl_langinfo()來獲取AM/PM 的本地化標識？

為什麼nl_langinfo() 沒有直接的AM/PM 選項？

nl_langinfo()的參數常量定義來自底層系統的C 庫，標準的nl_langinfo常量中沒有包含AM/PM 標識的直接枚舉。常見的常量例如：

ABDAY_1到ABDAY_7 ：縮寫的星期名稱
DAY_1到DAY_7 ：完整的星期名稱
ABMON_1到ABMON_12 ：縮寫的月份名稱
MON_1到MON_12 ：完整的月份名稱
AM_STR和PM_STR ：有些系統支持這兩個常量，但並不是所有系統都支持

因此，如果系統的C 庫和區域設置支持， AM_STR和PM_STR常量可以用來獲取AM 和PM 標識；否則就不能用nl_langinfo()獲取。

PHP 中的AM_STR 和PM_STR

PHP 的nl_langinfo()支持傳入AM_STR和PM_STR常量的前提是底層系統的本地化庫支持它們。可以用defined()判斷：

 if (defined('AM_STR') && defined('PM_STR')) {
    echo "AM 標識: " . nl_langinfo(AM_STR) . PHP_EOL;
    echo "PM 標識: " . nl_langinfo(PM_STR) . PHP_EOL;
} else {
    echo "當前系統不支持 AM_STR 或 PM_STR 常量。";
}

如果系統支持，會輸出本地化的上午和下午標識，比如英文系統會顯示“AM” 和“PM”，中文系統可能顯示“上午” 和“下午”。

代碼示例

下面的示例演示如何設置區域，獲取並輸出AM/PM 標識：

 <?php
// 設置區域（根據需要修改為合適的locale）
setlocale(LC_TIME, 'zh_CN.UTF-8');

// 判斷是否支持 AM_STR 和 PM_STR
if (defined('AM_STR') && defined('PM_STR')) {
    $am = nl_langinfo(AM_STR);
    $pm = nl_langinfo(PM_STR);

    echo "AM 標識: " . $am . PHP_EOL;
    echo "PM 標識: " . $pm . PHP_EOL;
} else {
    echo "當前系統不支持 AM_STR 或 PM_STR 常量，無法獲取 AM/PM 標識。" . PHP_EOL;
}

你可以根據自己的服務器環境嘗試修改setlocale的參數，比如en_US.UTF-8 、 zh_CN.UTF-8 ，來獲取對應語言環境下的AM/PM 標識。

注意事項

setlocale()會影響整個腳本的本地化環境，確保環境已經正確安裝相應的locale。
並非所有系統都支持AM_STR和PM_STR ，尤其是在Windows 平台上可能無法使用。
如果系統不支持，可以考慮用手動定義方式替代AM/PM 標識。

如果你需要更詳細的區域設置和時間格式處理，也可以結合IntlDateFormatter或第三方庫，獲得更靈活的本地化時間格式支持。