yii框架的格式化输出数据

格式化时间/日期数据

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

• 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: 前缀即可。

格式化数字

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::$numberFormatterTextOptions，NumberFormatter class 来进行格式化。

举个例子，为了调整小数部分的最大值和最小值，你可以配置 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 。

空值

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

本地日期格式化

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