格式化輸出數(shù)據(jù)

使用 formatter application component 來(lái)格式化數(shù)據(jù)炬太。默認(rèn) fomatter 由 yii\i18n\Formatter 來(lái)實(shí)現(xiàn),這個(gè)組件提供了一系列關(guān)于日期/時(shí)間,數(shù)字卡骂,貨幣等的格式化方法

$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(),這個(gè) Xzy 就是所支持的格式化類型形入。 也可以使用類方法 format() 來(lái)進(jìn)行格式化全跨,通過(guò)這個(gè)類方法,你可以更自由地控制格式化的數(shù)據(jù)唯笙,這時(shí)候螟蒸,類方法通常配合 yii\grid\GridView 或者 yii\widgets\DetailView 來(lái)使用盒使。

例子:

// output: January 1, 2014

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

// 你可以在第二個(gè)參數(shù)指定一個(gè)數(shù)組崩掘,這個(gè)數(shù)組提供了一些配置的參數(shù)

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

// output: 12.50%

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

Note: formatter 組件用來(lái)格式化最終展示給用戶的數(shù)據(jù). 如果你想要將用戶的輸入進(jìn)行格式化或者只是將一些別的日期數(shù)據(jù)進(jìn)行格式化(這里的格式化說(shuō)的是機(jī)器可讀的格式化),不要使用這個(gè)組件少办, 而應(yīng)該使用 yii\validators\DateValidator 和 yii\validators\NumberValidator 進(jìn)行用戶輸入格式化 關(guān)于日期格式化苞慢,戳這里 date()

配置 Formatter

可以對(duì) formatter 組件在 application configuration 中進(jìn)行配置

return [

???? 'components' => [

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

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

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

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

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

???? ? ? ? ],

?? ? ? ],

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


格式化時(shí)間/日期數(shù)據(jù)

默認(rèn)支持一下幾種格式化格式

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

*? time: 這個(gè)變量將被格式化為時(shí)間 14:23.

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

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

*? relativeTime: 這個(gè)變量將被格式化為人類可讀的當(dāng)前相對(duì)時(shí)間 1 hour ago.

*? duration: 這個(gè)變量將被格式化為人類可讀的時(shí)長(zhǎng) 1 day, 2 minutes.

時(shí)間/日期數(shù)據(jù)默認(rèn)使用 date, time, datetime 方法進(jìn)行格式化,? 可以對(duì)他們進(jìn)行一些自己的配置英妓,只需在配置文件里配置 dateFormat, timeFormat, 和 datetimeFormat 即可挽放。

同時(shí),還可以配置它使用 ICU syntax蔓纠,同時(shí)也可以配置它使用 PHP date() 語(yǔ)法辑畦,只需要加上 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

時(shí)區(qū)

格式化時(shí)間/日期數(shù)據(jù)時(shí)? 將他們轉(zhuǎn)換成 time zone 這個(gè)時(shí)候腿倚,默認(rèn)的時(shí)區(qū)為 UTC纯出,除非另外指定 yii\i18n\Formatter::$defaultTimeZone。

下面使用 Europe/Berlin 作為默認(rèn) 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

不同的政府和地區(qū)政策決定不同的時(shí)區(qū), 在你的時(shí)區(qū)數(shù)據(jù)庫(kù)中可能拿不到最新的數(shù)據(jù)。 這時(shí)你可以戳 ICU manual 來(lái)查看如何更新時(shí)區(qū)暂筝。 同時(shí)箩言,這篇也可以作為參考 Setting up your PHP environment for internationalization

格式化數(shù)字

formatter 支持如下的方法

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

*? decimal: 這個(gè)變量將被格式化為帶著逗號(hào)的指定精度的浮點(diǎn)型 e.g. 2,542.123 or 2.542,123.

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

*? scientific: 這個(gè)變量將被格式化為科學(xué)計(jì)數(shù)法 e.g. 4.2E4.

*? currency: 這個(gè)變量將被格式化為貨幣 £420.00. 使用這個(gè)方法前請(qǐng)確認(rèn)是否已經(jīng)正確配置 locale

*? size: 這個(gè)變量將被格式化為人類可讀的字節(jié)數(shù) e.g. 410 kibibytes.

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

可以使用 decimalSeparator 和 thousandSeparator 來(lái)進(jìn)行調(diào)整。 他們都會(huì)根據(jù)當(dāng)前的 locale 來(lái)進(jìn)行格式化.

如果想要進(jìn)行更高級(jí)的配置, 可以使用 yii\i18n\Formatter::$numberFormatterOptions 和 yii\i18n\Formatter::$numberFormatterTextOptions焕襟,NumberFormatter class 來(lái)進(jìn)行格式化陨收。

舉個(gè)例子,為了調(diào)整小數(shù)部分的最大值和最小值鸵赖,可以配置 yii\i18n\Formatter::$numberFormatterOptions 如下:

'numberFormatterOptions' => [

NumberFormatter::MIN_FRACTION_DIGITS => 0,

NumberFormatter::MAX_FRACTION_DIGITS => 2,

]

其他的格式化

除了時(shí)間/日期和數(shù)字的格式化务漩,Yii 還支持如下的常用格式化

raw: 除了 null 會(huì)被 nullDisplay 格式化外,原樣輸出它褪。

text: 編碼為 HTML 格式菲饼。同時(shí)這也是 GridView DataColumn 默認(rèn)使用的方法。

ntext: 編碼為 HTML 格式列赎,換行也將被轉(zhuǎn)換宏悦。

paragraphs: 編碼為 HTML 格式,以

標(biāo)簽包裹包吝。

html: 這個(gè)數(shù)值將會(huì)被 HtmlPurifier 來(lái)進(jìn)行過(guò)濾來(lái)防御 XSS 攻擊饼煞,可以添加一些配置例如 ['html', ['Attr.AllowedFrameTargets' => ['_blank']]]。

email: 這個(gè)數(shù)值將被轉(zhuǎn)換為 mailto 鏈接诗越。

boolean: true => Yes, false => No砖瞧,可以進(jìn)行另外的配置: yii\i18n\Formatter::$booleanFormat 。


空值

空值(null)會(huì)被特殊格式化. fommater 默認(rèn)會(huì)將空值格式化為 (not set) 對(duì)應(yīng)的當(dāng)前的語(yǔ)言. 可以配置 nullDisplay 屬性來(lái)進(jìn)行個(gè)性化.

本地日期格式化

formatter 會(huì)使用當(dāng)前的 locale 來(lái)決定格式化的內(nèi)容嚷狞。 對(duì)于同樣的日期块促,不同的時(shí)區(qū)配置會(huì)有不同的輸出:

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 г.

默認(rèn)配置下,當(dāng)前 locale 決定于 yii\base\Application::$language. 可以覆蓋 yii\i18n\Formatter::$locale 屬性來(lái)滿足不同的需要床未。

Note: Yii formatter 依賴 PHP intl extension 來(lái)進(jìn)行本地?cái)?shù)據(jù)格式化 因?yàn)椴煌?ICU 庫(kù)可能會(huì)導(dǎo)致不同的輸出竭翠,所以請(qǐng)?jiān)谟玫乃袡C(jī)器上保持 ICU 庫(kù)的一致性. 請(qǐng)戳 Setting up your PHP environment for internationalization.

如果 intl 擴(kuò)展沒(méi)有被安裝,數(shù)據(jù)格式化不會(huì)考慮本地化.

在 32 位系統(tǒng)中薇搁,1901 年前或者 2038 年后的日期數(shù)據(jù)將不會(huì)被本地化斋扰,因?yàn)?ICU 使用的是 32 位的 UNIX 時(shí)間戳。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末啃洋,一起剝皮案震驚了整個(gè)濱河市传货,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌宏娄,老刑警劉巖问裕,帶你破解...
    沈念sama閱讀 212,884評(píng)論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異孵坚,居然都是意外死亡粮宛,警方通過(guò)查閱死者的電腦和手機(jī)貌踏,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,755評(píng)論 3 385
  • 文/潘曉璐 我一進(jìn)店門(mén)放吩,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)蚀之,“玉大人,你說(shuō)我怎么就攤上這事力喷”酰” “怎么了眷昆?”我有些...
    開(kāi)封第一講書(shū)人閱讀 158,369評(píng)論 0 348
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)汁咏。 經(jīng)常有香客問(wèn)我亚斋,道長(zhǎng),這世上最難降的妖魔是什么攘滩? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 56,799評(píng)論 1 285
  • 正文 為了忘掉前任帅刊,我火速辦了婚禮,結(jié)果婚禮上漂问,老公的妹妹穿的比我還像新娘赖瞒。我一直安慰自己,他們只是感情好蚤假,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,910評(píng)論 6 386
  • 文/花漫 我一把揭開(kāi)白布栏饮。 她就那樣靜靜地躺著,像睡著了一般磷仰。 火紅的嫁衣襯著肌膚如雪袍嬉。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 50,096評(píng)論 1 291
  • 那天灶平,我揣著相機(jī)與錄音伺通,去河邊找鬼。 笑死逢享,一個(gè)胖子當(dāng)著我的面吹牛罐监,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播拼苍,決...
    沈念sama閱讀 39,159評(píng)論 3 411
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼笑诅,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼调缨!你這毒婦竟也來(lái)了疮鲫?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 37,917評(píng)論 0 268
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤弦叶,失蹤者是張志新(化名)和其女友劉穎俊犯,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體伤哺,經(jīng)...
    沈念sama閱讀 44,360評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡燕侠,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,673評(píng)論 2 327
  • 正文 我和宋清朗相戀三年者祖,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片绢彤。...
    茶點(diǎn)故事閱讀 38,814評(píng)論 1 341
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡七问,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出茫舶,到底是詐尸還是另有隱情械巡,我是刑警寧澤,帶...
    沈念sama閱讀 34,509評(píng)論 4 334
  • 正文 年R本政府宣布饶氏,位于F島的核電站讥耗,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏疹启。R本人自食惡果不足惜古程,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 40,156評(píng)論 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望喊崖。 院中可真熱鬧挣磨,春花似錦、人聲如沸荤懂。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,882評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)势誊。三九已至呜达,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間粟耻,已是汗流浹背查近。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 32,123評(píng)論 1 267
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留挤忙,地道東北人霜威。 一個(gè)月前我還...
    沈念sama閱讀 46,641評(píng)論 2 362
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像册烈,于是被迫代替她去往敵國(guó)和親戈泼。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,728評(píng)論 2 351

推薦閱讀更多精彩內(nèi)容

  • 2. NSLog常用的幾種輸出 %@ 對(duì)象 %d, %i 整數(shù) %u 無(wú)符整形 %f 浮點(diǎn)...
    Damen_9527閱讀 1,399評(píng)論 0 1
  • Spring Cloud為開(kāi)發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見(jiàn)模式的工具(例如配置管理赏僧,服務(wù)發(fā)現(xiàn)大猛,斷路器,智...
    卡卡羅2017閱讀 134,638評(píng)論 18 139
  • 中文翻譯 ng help ng build 構(gòu)建您的應(yīng)用程序并將其放入輸出路徑(dist /默認(rèn)情況下)淀零。 別名:...
    4ea0af17fd67閱讀 2,022評(píng)論 0 0
  • 在JavaSe5中挽绩,推出了C語(yǔ)言中printf()風(fēng)格的格式化輸出。這不僅使得控制輸出的代碼更加簡(jiǎn)單驾中,同時(shí)也給與J...
    三藏君閱讀 771評(píng)論 0 0
  • 世界上最遙遠(yuǎn)的距離唉堪, 是我在你的面前模聋, 你卻不知道我愛(ài)你。 世界上最遙遠(yuǎn)的距離唠亚, 是有愛(ài)不能說(shuō)链方, 卻一直愛(ài)到癡迷。...
    琢玉書(shū)生閱讀 510評(píng)論 3 5