格式化输出数据

使用 formatter application component 来格式化数据。默认 fomatter 由 yii\i18n\Formatter 来实现,这个组件提供了一系列关于日期/时间,数字,货币等的格式化方法

$formatter = \Yii::$app->formatter;

// output: January 1, 2014

echo $formatter->asDate('2014-01-01', 'long');

// output: 12.50%

echo $formatter->asPercent(0.125, 2);

// output:cebe@example.com

echo $formatter->asEmail('cebe@example.com');     

// output: Yes

echo $formatter->asBoolean(true);

// it also handles display of null values:

// output: (Not set)

echo $formatter->asDate(null);

所有的方法都形似 asXyz(),这个 Xzy 就是所支持的格式化类型。 也可以使用类方法 format() 来进行格式化,通过这个类方法,你可以更自由地控制格式化的数据,这时候,类方法通常配合 yii\grid\GridView 或者 yii\widgets\DetailView 来使用。

例子:

// output: January 1, 2014

echo Yii::$app->formatter->format('2014-01-01', 'date');

// 你可以在第二个参数指定一个数组,这个数组提供了一些配置的参数

// 例如这个 2 就是 asPercent() 方法的 $decimals 参数

// output: 12.50%

echo Yii::$app->formatter->format(0.125, ['percent', 2]);

Note: formatter 组件用来格式化最终展示给用户的数据. 如果你想要将用户的输入进行格式化或者只是将一些别的日期数据进行格式化(这里的格式化说的是机器可读的格式化),不要使用这个组件, 而应该使用 yii\validators\DateValidator 和 yii\validators\NumberValidator 进行用户输入格式化 关于日期格式化,戳这里 date()

配置 Formatter

可以对 formatter 组件在 application configuration 中进行配置

return [

     'components' => [

        'formatter' => [

            'dateFormat' => 'dd.MM.yyyy',

            'decimalSeparator' => ',',

            'thousandSeparator' => ' ',

            'currencyCode' => 'EUR',

           ],

       ],

];          //可以参考 yii\i18n\Formatter 的配置


格式化时间/日期数据

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

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

// ICU format

echo Yii::$app->formatter->asDate('now', 'yyyy-MM-dd'); // 2014-10-06

// PHP date()-format

echo Yii::$app->formatter->asDate('now', 'php:Y-m-d'); // 2014-10-06

时区

格式化时间/日期数据时  将他们转换成 time zone 这个时候,默认的时区为 UTC,除非另外指定 yii\i18n\Formatter::$defaultTimeZone。

下面使用 Europe/Berlin 作为默认 time zone

// formatting a UNIX timestamp as a time

echo Yii::$app->formatter->asTime(1412599260); // 14:41:00

// formatting a datetime string (in UTC) as a time

echo Yii::$app->formatter->asTime('2014-10-06 12:41:00'); // 14:41:00

// formatting a datetime string (in CEST) as a time

echo Yii::$app->formatter->asTime('2014-10-06 14:41:00 CEST'); // 14:41:00

不同的政府和地区政策决定不同的时区, 在你的时区数据库中可能拿不到最新的数据。 这时你可以戳 ICU manual 来查看如何更新时区。 同时,这篇也可以作为参考 Setting up your PHP environment for internationalization

格式化数字

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 格式,以

标签包裹。

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 来决定格式化的内容。 对于同样的日期,不同的时区配置会有不同的输出:

Yii::$app->formatter->locale = 'en-US';

echo Yii::$app->formatter->asDate('2014-01-01'); // output: January 1, 2014

Yii::$app->formatter->locale = 'de-DE';

echo Yii::$app->formatter->asDate('2014-01-01'); // output: 1. Januar 2014

Yii::$app->formatter->locale = 'ru-RU';

echo Yii::$app->formatter->asDate('2014-01-01'); // output: 1 января 2014 г.

默认配置下,当前 locale 决定于 yii\base\Application::$language. 可以覆盖 yii\i18n\Formatter::$locale 属性来满足不同的需要。

Note: Yii formatter 依赖 PHP intl extension 来进行本地数据格式化 因为不同的 ICU 库可能会导致不同的输出,所以请在用的所有机器上保持 ICU 库的一致性. 请戳 Setting up your PHP environment for internationalization.

如果 intl 扩展没有被安装,数据格式化不会考虑本地化.

在 32 位系统中,1901 年前或者 2038 年后的日期数据将不会被本地化,因为 ICU 使用的是 32 位的 UNIX 时间戳。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,636评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,890评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,680评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,766评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,665评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,045评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,515评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,182评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,334评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,274评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,319评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,002评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,599评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,675评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,917评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,309评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,885评论 2 341

推荐阅读更多精彩内容

  • 2. NSLog常用的几种输出 %@ 对象 %d, %i 整数 %u 无符整形 %f 浮点...
    Damen_9527阅读 1,392评论 0 1
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,562评论 18 139
  • 中文翻译 ng help ng build 构建您的应用程序并将其放入输出路径(dist /默认情况下)。 别名:...
    4ea0af17fd67阅读 1,993评论 0 0
  • 在JavaSe5中,推出了C语言中printf()风格的格式化输出。这不仅使得控制输出的代码更加简单,同时也给与J...
    三藏君阅读 761评论 0 0
  • 世界上最遥远的距离, 是我在你的面前, 你却不知道我爱你。 世界上最遥远的距离, 是有爱不能说, 却一直爱到痴迷。...
    琢玉书生阅读 509评论 3 5