要以可讀格式來顯示數據，可以使用 格式化(formatter)應用程式組件。
第1步 - 將 actionFormatter() 方法添加到 SiteController。
public function actionFormatter(){
return $this->render('formatter');
}
在上面的代碼中，我們只呈現格式化視圖。
第2步 - 現在，在 views/site 檔夾內創建 formatter.php 視圖檔。
<?php
$formatter = \Yii::$app->formatter;
// output: January 1, 2016
echo $formatter->asDate('2019-10-01', 'long'),"<br>";
// output: 51.50%
echo $formatter->asPercent(0.515, 2),"<br>";
// output: <a href = "mailto:xuhuhu.com@gmail.com">xuhuhu.com@gmail.com</a>
echo $formatter->asEmail('yiiibai.com@gmail.com'),"<br>";
// output: Yes
echo $formatter->asBoolean(true),"<br>";
// output: (Not set)
echo $formatter->asDate(null),"<br>";
?>
格式化組件支持日期和時間相關的格式如下 -
| 輸出格式 | 示例 |
|---|---|
| date | January 01, 2016 |
| time | 16:06 |
| datetime | January 01, 2016 16:06 |
| timestamp | 1512609983 |
| relativeTime | 1 hour ago |
| duration | 5 minutes |
第4步 - 使用以下這種方式修改 formatter.php 視圖。
<?php
$formatter = \Yii::$app->formatter;
echo $formatter->asDate(date('Y-m-d'), 'long'),"<br>";
echo $formatter->asTime(date("Y-m-d")),"<br>";
echo $formatter->asDatetime(date("Y-m-d")),"<br>";
echo $formatter->asTimestamp(date("Y-m-d")),"<br>";
echo $formatter->asRelativeTime(date("Y-m-d")),"<br>";
?>
日期格式
另外還有四個日期格式的快捷方式：short, medium, long 和 full
第1步 - 使用以下這種方式修改 formatter 視圖檔。
<?php
$formatter = \Yii::$app->formatter;
echo $formatter->asDate(date('Y-m-d'), 'short'),"<br>";
echo $formatter->asDate(date('Y-m-d'), 'medium'),"<br>";
echo $formatter->asDate(date('Y-m-d'), 'long'),"<br>";
echo $formatter->asDate(date('Y-m-d'), 'full'),"<br>";
?>
數字格式
格式化組件支持數字有關下列格式-
| 輸出格式 | 示例 |
|---|---|
| integer | 51 |
| decimal | 105.51 |
| percent | 51% |
| scientific | 1.050000E+2 |
| currency | $105 |
| size | 105 bytes |
| shortSize | 105 B |
第1步 - 使用以下這種方式修改 formatter 視圖。
<?php $formatter = \Yii::$app->formatter; echo Yii::$app->formatter->asInteger(105),"<br>"; echo Yii::$app->formatter->asDecimal(105.41),"<br>"; echo Yii::$app->formatter->asPercent(0.51),"<br>"; echo Yii::$app->formatter->asScientific(105),"<br>"; echo Yii::$app->formatter->asCurrency(105),"<br>"; echo Yii::$app->formatter->asSize(105),"<br>"; echo Yii::$app->formatter->asShortSize(105),"<br>"; ?>
其他格式
Yii也可以支持其他格式 -
-
text − 值是HTML編碼
-
raw − 值是被輸出的
-
paragraphs − 值被格式化為HTML文本段落，並包裹成p標籤
-
ntext − 值被格式化為一個HTML純文本換行,新行的地方被轉換成換行符
-
html − 值是使用 HtmlPurifier 純化避免 XSS 攻擊
-
image − 值被格式化為圖像標記
-
boolean − 值被格式化為一個布爾值
-
url − 值被格式化為一個鏈接
-
email − 值被格式化為一個 mailto 鏈接
格式化可以使用當前活動的語言環境來確定如何格式化指定國家格式的值。
下麵的例子說明如何在不同的語言環境格式化日期。
<?php
Yii::$app->formatter->locale = 'ru-RU';
echo Yii::$app->formatter->asDate('2020-01-01'); // output: 1 января 2020 г.
Yii::$app->formatter->locale = 'de-DE';
// output: 1. Januar 2016
echo Yii::$app->formatter->asDate('2018-01-01');
Yii::$app->formatter->locale = 'en-US';
// output: January 1, 2016
echo Yii::$app->formatter->asDate('2018-01-01');
?>