要以可读格式来显示数据，可以使用 格式化(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');
?>