格式化輸出數據

使用 formatter application component 來格式化數據。默認 fomatter 由 yii\i18n\Formatter 來實現,這個組件提供了一系列關于日期/時間,數字,貨幣等的格式化方法

$formatter = \Yii::$app->formatter;

// output: January 1, 2014

echo $formatter->asDate('2014-01-01', 'long');

// output: 12.50%

echo $formatter->asPercent(0.125, 2);

// output:cebe@example.com

echo $formatter->asEmail('cebe@example.com');?????

// output: Yes

echo $formatter->asBoolean(true);

// it also handles display of null values:

// output: (Not set)

echo $formatter->asDate(null);

所有的方法都形似 asXyz(),這個 Xzy 就是所支持的格式化類型。 也可以使用類方法 format() 來進行格式化,通過這個類方法,你可以更自由地控制格式化的數據,這時候,類方法通常配合 yii\grid\GridView 或者 yii\widgets\DetailView 來使用。

例子:

// output: January 1, 2014

echo Yii::$app->formatter->format('2014-01-01', 'date');

// 你可以在第二個參數指定一個數組,這個數組提供了一些配置的參數

// 例如這個 2 就是 asPercent() 方法的 $decimals 參數

// output: 12.50%

echo Yii::$app->formatter->format(0.125, ['percent', 2]);

Note: formatter 組件用來格式化最終展示給用戶的數據. 如果你想要將用戶的輸入進行格式化或者只是將一些別的日期數據進行格式化(這里的格式化說的是機器可讀的格式化),不要使用這個組件, 而應該使用 yii\validators\DateValidator 和 yii\validators\NumberValidator 進行用戶輸入格式化 關于日期格式化,戳這里 date()

配置 Formatter

可以對 formatter 組件在 application configuration 中進行配置

return [

???? 'components' => [

??????? 'formatter' => [

??????????? 'dateFormat' => 'dd.MM.yyyy',

??????????? 'decimalSeparator' => ',',

??????????? 'thousandSeparator' => ' ',

??????????? 'currencyCode' => 'EUR',

???? ? ? ? ],

?? ? ? ],

];? ? ? ? ? //可以參考 yii\i18n\Formatter 的配置


格式化時間/日期數據

默認支持一下幾種格式化格式

*? date: 這個變量將被格式化為日期 January 01, 2014.

*? time: 這個變量將被格式化為時間 14:23.

*? datetime: 這個變量將被格式化為日期+時間 January 01, 2014 14:23.

*? timestamp: 這個變量將被格式化為 UNIX 時間戳 unix timestamp, 例如 1412609982.

*? relativeTime: 這個變量將被格式化為人類可讀的當前相對時間 1 hour ago.

*? duration: 這個變量將被格式化為人類可讀的時長 1 day, 2 minutes.

時間/日期數據默認使用 date, time, datetime 方法進行格式化,? 可以對他們進行一些自己的配置,只需在配置文件里配置 dateFormat, timeFormat, 和 datetimeFormat 即可。

同時,還可以配置它使用 ICU syntax,同時也可以配置它使用 PHP date() 語法,只需要加上 php: 前綴即可。

// ICU format

echo Yii::$app->formatter->asDate('now', 'yyyy-MM-dd'); // 2014-10-06

// PHP date()-format

echo Yii::$app->formatter->asDate('now', 'php:Y-m-d'); // 2014-10-06

時區

格式化時間/日期數據時? 將他們轉換成 time zone 這個時候,默認的時區為 UTC,除非另外指定 yii\i18n\Formatter::$defaultTimeZone。

下面使用 Europe/Berlin 作為默認 time zone

// formatting a UNIX timestamp as a time

echo Yii::$app->formatter->asTime(1412599260); // 14:41:00

// formatting a datetime string (in UTC) as a time

echo Yii::$app->formatter->asTime('2014-10-06 12:41:00'); // 14:41:00

// formatting a datetime string (in CEST) as a time

echo Yii::$app->formatter->asTime('2014-10-06 14:41:00 CEST'); // 14:41:00

不同的政府和地區政策決定不同的時區, 在你的時區數據庫中可能拿不到最新的數據。 這時你可以戳 ICU manual 來查看如何更新時區。 同時,這篇也可以作為參考 Setting up your PHP environment for internationalization

格式化數字

formatter 支持如下的方法

*? integer: 這個變量將被格式化為整形 e.g. 42.

*? decimal: 這個變量將被格式化為帶著逗號的指定精度的浮點型 e.g. 2,542.123 or 2.542,123.

*? percent: 這個變量將被格式化為百分比 e.g. 42%.

*? scientific: 這個變量將被格式化為科學計數法 e.g. 4.2E4.

*? currency: 這個變量將被格式化為貨幣 £420.00. 使用這個方法前請確認是否已經正確配置 locale

*? size: 這個變量將被格式化為人類可讀的字節數 e.g. 410 kibibytes.

*? shortSize: 這個變量將被格式化為人類可讀的字節數(縮寫) size, e.g. 410 KiB.

可以使用 decimalSeparator 和 thousandSeparator 來進行調整。 他們都會根據當前的 locale 來進行格式化.

如果想要進行更高級的配置, 可以使用 yii\i18n\Formatter::$numberFormatterOptions 和 yii\i18n\Formatter::$numberFormatterTextOptions,NumberFormatter class 來進行格式化。

舉個例子,為了調整小數部分的最大值和最小值,可以配置 yii\i18n\Formatter::$numberFormatterOptions 如下:

'numberFormatterOptions' => [

NumberFormatter::MIN_FRACTION_DIGITS => 0,

NumberFormatter::MAX_FRACTION_DIGITS => 2,

]

其他的格式化

除了時間/日期和數字的格式化,Yii 還支持如下的常用格式化

raw: 除了 null 會被 nullDisplay 格式化外,原樣輸出。

text: 編碼為 HTML 格式。同時這也是 GridView DataColumn 默認使用的方法。

ntext: 編碼為 HTML 格式,換行也將被轉換。

paragraphs: 編碼為 HTML 格式,以

標簽包裹。

html: 這個數值將會被 HtmlPurifier 來進行過濾來防御 XSS 攻擊,可以添加一些配置例如 ['html', ['Attr.AllowedFrameTargets' => ['_blank']]]。

email: 這個數值將被轉換為 mailto 鏈接。

boolean: true => Yes, false => No,可以進行另外的配置: yii\i18n\Formatter::$booleanFormat 。


空值

空值(null)會被特殊格式化. fommater 默認會將空值格式化為 (not set) 對應的當前的語言. 可以配置 nullDisplay 屬性來進行個性化.

本地日期格式化

formatter 會使用當前的 locale 來決定格式化的內容。 對于同樣的日期,不同的時區配置會有不同的輸出:

Yii::$app->formatter->locale = 'en-US';

echo Yii::$app->formatter->asDate('2014-01-01'); // output: January 1, 2014

Yii::$app->formatter->locale = 'de-DE';

echo Yii::$app->formatter->asDate('2014-01-01'); // output: 1. Januar 2014

Yii::$app->formatter->locale = 'ru-RU';

echo Yii::$app->formatter->asDate('2014-01-01'); // output: 1 января 2014 г.

默認配置下,當前 locale 決定于 yii\base\Application::$language. 可以覆蓋 yii\i18n\Formatter::$locale 屬性來滿足不同的需要。

Note: Yii formatter 依賴 PHP intl extension 來進行本地數據格式化 因為不同的 ICU 庫可能會導致不同的輸出,所以請在用的所有機器上保持 ICU 庫的一致性. 請戳 Setting up your PHP environment for internationalization.

如果 intl 擴展沒有被安裝,數據格式化不會考慮本地化.

在 32 位系統中,1901 年前或者 2038 年后的日期數據將不會被本地化,因為 ICU 使用的是 32 位的 UNIX 時間戳。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,836評論 6 540
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,275評論 3 428
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,904評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,633評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,368評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,736評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,740評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,919評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,481評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,235評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,427評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,968評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,656評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,055評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,348評論 1 294
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,160評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,380評論 2 379

推薦閱讀更多精彩內容

  • 2. NSLog常用的幾種輸出 %@ 對象 %d, %i 整數 %u 無符整形 %f 浮點...
    Damen_9527閱讀 1,423評論 0 1
  • Spring Cloud為開發人員提供了快速構建分布式系統中一些常見模式的工具(例如配置管理,服務發現,斷路器,智...
    卡卡羅2017閱讀 134,818評論 18 139
  • 中文翻譯 ng help ng build 構建您的應用程序并將其放入輸出路徑(dist /默認情況下)。 別名:...
    4ea0af17fd67閱讀 2,051評論 0 0
  • 在JavaSe5中,推出了C語言中printf()風格的格式化輸出。這不僅使得控制輸出的代碼更加簡單,同時也給與J...
    三藏君閱讀 785評論 0 0
  • 世界上最遙遠的距離, 是我在你的面前, 你卻不知道我愛你。 世界上最遙遠的距離, 是有愛不能說, 卻一直愛到癡迷。...
    琢玉書生閱讀 520評論 3 5