PHP开发教程

Yii格式化

要以可读格式来显示数据,可以使用 格式化(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:yiibai.com@gmail.com">yiibai.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>";
?>

第3步 - 访问URL:http://localhost:8080/index.php?r=site/formatter, 就会看到下面的输出:

11.png

格式化组件支持日期和时间相关的格式如下 - 

输出格式 示例
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>";
?>

第5步 - 在Web浏览器访问:http://localhost:8080/index.php?r=site/formatter ,就会看到下面的输出。

11.png

日期格式

另外还有四个日期格式的快捷方式: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>";
?>

第2步 - 打开Web浏览器输入:http://localhost:8080/index.php?r=site/formatter,,将会看到下面的输出。

11.png

数字格式

格式化组件支持数字有关下列格式-

输出格式 示例
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>";
?>

第2步 - 访问 http://localhost:8080/index.php?r=site/formatter, 会看到下面的输出结果:

11.png

其他格式

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');
?>


Powered by PHP二次开发 ©2008-2017