格式化输出数据(Data Formatting).pdfVIP

格式化输出数据 （Data Formatting ） 数据格式器 Yii提供⼀个格式化类来格式化输出，以使输出数据对终端⽤户更友好易读， yii\i 18n\Formatter 是⼀个助⼿类，作为 ⽤组件 使⽤，默认名为formatter。 它提供⼀些⽅法⽤来格式化数据，如⽇期/ 时间、数字或其他常⽤的本地化格式， 两 种⽅式使⽤格式器： 1. 直接使⽤格式化⽅法(所有的格式器⽅法以 as做前缀): echo Yii::$app-formatter-asDate(2014-01-01, long); 输 echo Yii::$app-formatter-asPercent(0.125, 2); 输出: 12.50 echo Yii::$app-formatter-asEmail(cebe@); 输 echo Yii::$app-formatter-asBoolean(true); 输出: Yes 也可处理null值的输出显示: echo Yii::$app-formatter-asDate(null); 输出: (Not set) 2. 使⽤ yii\i 18n\Formatter::format() ⽅法和格式化名， 该⽅法也被⼀些⼩部件如 yii\grid\GridView 和 yii\widgets\DetailView使⽤，在⼩部件配置中可以指定列的 数据格式。 echo Yii::$app-formatter-format(2014-01-01, date); 输 可使⽤数组来指定格式化⽅法的参数： `2` 是asPercent()⽅法的参数$decimals的值 echo Yii::$app-formatter-format(0.125, [percent, 2]); 当P P intl extension安装时，格式器的输出会本地化， 为此可配置格式器的 yii\i 18n\Formatter::locale 属性，如果没有配置， ⽤配置 yii\base\Application::language 作为当前区域，更多详情参考 国际化⼀节。 然后格式器根据当前区域为⽇期和数字 选择正确的格式，包括⽉份和星期也会转换到当前语⾔， ⽇期格式也会被 yii\i 18n\Formatter::timeZone 参数影响， 该参数如果没有明确配置会使⽤ ⽤的 yii\base\Application::timeZone 参数。 ⽇期格式根据不同区域输出不同的结果，如下例所⽰： For example the date format call will output different results for different locales: Yii::$app-formatter-locale = en-US; echo Yii::$app-formatter-asDate(2014-01-01); 输出: January 1 Yii::$app-formatter-locale = de-DE; echo Yii::$app-formatter-asDate(2014-01-01); 输出: 1\ . Janua Yii::$app-formatter-locale = ru-RU; echo Yii::$app-formatter-asDate(2014-01-01); 输出: 1 января 注意不管P P intl extension有没有安装，P P编译的ICU库不同，格式化 结果可能不同， 所以为确保不同环境下得到相同的输出，推荐在每个环 境下安装P P intl扩展以及相同的ICU库， 可参考： 为国际化设置P P环 境. 配置格式器 可配置yii\i 18n\Formatter 的属性来调整格式器⽅法的默认格式， 可以在 ⽤主体配 置 中配置 formatter 组件 ⽤到整个项⽬， 配置样例如下所⽰， 更多关于可⽤属 性的详情请参考 yii\i 18n\Format