yii框架的格式化输出数据

女爷i 2022-05-29 08:12 254阅读 0赞

## 格式化时间/日期数据 ##

默认支持一下几种格式化格式

*  [date][]: 这个变量将被格式化为日期 `January 01, 2014`.
 *  [time][]: 这个变量将被格式化为时间 `14:23`.
 *  [datetime][]: 这个变量将被格式化为日期+时间 `January 01, 2014 14:23`.
 *  [timestamp][]: 这个变量将被格式化为 UNIX 时间戳 [unix timestamp][], 例如 `1412609982`.
 *  [relativeTime][]: 这个变量将被格式化为人类可读的当前相对时间 `1 hour ago`.
 *  [duration][]: 这个变量将被格式化为人类可读的时长 `1 day, 2 minutes`.

时间/日期数据默认使用 [date][], [time][]， [datetime][] 方法进行格式化, 你可以对他们进行一些自己的配置，只需在配置文件里配置 [dateFormat][],[timeFormat][], 和 [datetimeFormat][] 即可。

同时，你还可以配置它使用 [ICU syntax][]，同时你也可以配置它使用 [PHP date() 语法][PHP date_]，只需要加上 `php:` 前缀即可。

## 格式化数字 ##

`formatter` 支持如下的方法

*  [integer][]: 这个变量将被格式化为整形 e.g. `42`.
 *  [decimal][]: 这个变量将被格式化为带着逗号的指定精度的浮点型 e.g. `2,542.123` or `2.542,123`.
 *  [percent][]: 这个变量将被格式化为百分比 e.g. `42%`.
 *  [scientific][]: 这个变量将被格式化为科学计数法 e.g. `4.2E4`.
 *  [currency][]: 这个变量将被格式化为货币 `?420.00`. 使用这个方法前请确认是否已经正确配置 [locale][]
 *  [size][]: 这个变量将被格式化为人类可读的字节数 e.g. `410 kibibytes`.
 *  [shortSize][]: 这个变量将被格式化为人类可读的字节数（缩写） [size][], e.g. `410 KiB`.

你可以使用 [decimalSeparator][] 和 [thousandSeparator][] 来进行调整。 他们都会根据当前的 [locale][] 来进行格式化.

如果你想要进行更高级的配置, 可以使用 [yii\\i18n\\Formatter::$numberFormatterOptions][yii_i18n_Formatter_numberFormatterOptions] 和[yii\\i18n\\Formatter::$numberFormatterTextOptions][yii_i18n_Formatter_numberFormatterTextOptions]，[NumberFormatter class][] 来进行格式化。

举个例子，为了调整小数部分的最大值和最小值，你可以配置 [yii\\i18n\\Formatter::$numberFormatterOptions][yii_i18n_Formatter_numberFormatterOptions] 如下：

'numberFormatterOptions' => \[ NumberFormatter::MIN\_FRACTION\_DIGITS => 0, NumberFormatter::MAX\_FRACTION\_DIGITS => 2,\]

## 其他的格式化 ##

除了时间/日期和数字的格式化，Yii 还支持如下的常用格式化

*  [raw][]: 除了 `null` 会被 nullDisplay 格式化外，原样输出。
 *  [text][]: 编码为 HTML 格式。同时这也是 [GridView DataColumn][] 默认使用的方法。
 *  [ntext][]: 编码为 HTML 格式，换行也将被转换。
 *  [paragraphs][]: 编码为 HTML 格式，以 `<p>` 标签包裹。
 *  [html][]: 这个数值将会被 HtmlPurifier 来进行过滤来防御 XSS 攻击，你可以添加一些配置例如 `['html', ['Attr.AllowedFrameTargets' => ['_blank']]]`。
 *  [email][]: 这个数值将被转换为 `mailto` 链接。
 *    
    
 *    
    
 *  [boolean][]: `true` => `Yes`, `false` => `No`，可以进行另外的配置： [yii\\i18n\\Formatter::$booleanFormat][yii_i18n_Formatter_booleanFormat] 。

## 空值 ##

空值（`null`）会被特殊格式化. `fommater` 默认会将空值格式化为 `(not set)` 对应的当前的语言. 你可以配置 [nullDisplay][] 属性来进行个性化.

## 本地日期格式化 ##

`formatter` 会使用当前的 [locale][] 来决定格式化的内容。 对于同样的日期，不同的时区配置会有不同的输出

[date]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asDate%28%29-detail
[time]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asTime%28%29-detail
[datetime]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asDatetime%28%29-detail
[timestamp]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asTimestamp%28%29-detail
[unix timestamp]: http://en.wikipedia.org/wiki/Unix_time
[relativeTime]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asRelativeTime%28%29-detail
[duration]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asDuration%28%29-detail
[dateFormat]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$dateFormat-detail
[timeFormat]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$timeFormat-detail
[datetimeFormat]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$datetimeFormat-detail
[ICU syntax]: http://userguide.icu-project.org/formatparse/datetime
[PHP date_]: http://php.net/manual/en/function.date.php
[integer]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asInteger%28%29-detail
[decimal]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asDecimal%28%29-detail
[percent]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asPercent%28%29-detail
[scientific]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asScientific%28%29-detail
[currency]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asCurrency%28%29-detail
[locale]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$locale-detail
[size]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asSize%28%29-detail
[shortSize]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asShortSize%28%29-detail
[decimalSeparator]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$decimalSeparator-detail
[thousandSeparator]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$thousandSeparator-detail
[yii_i18n_Formatter_numberFormatterOptions]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$numberFormatterOptions-detail
[yii_i18n_Formatter_numberFormatterTextOptions]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$numberFormatterTextOptions-detail
[NumberFormatter class]: http://php.net/manual/en/class.numberformatter.php
[raw]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asRaw%28%29-detail
[text]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asText%28%29-detail
[GridView DataColumn]: http://www.yiichina.com/doc/guide/2.0/output-data-widgets#data-column
[ntext]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asNtext%28%29-detail
[paragraphs]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asParagraphs%28%29-detail
[html]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asHtml%28%29-detail
[email]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asEmail%28%29-detail
[boolean]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#asBoolean%28%29-detail
[yii_i18n_Formatter_booleanFormat]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$booleanFormat-detail
[nullDisplay]: http://www.yiichina.com/doc/api/2.0/yii-i18n-formatter#$nullDisplay-detail