A collection of formatters for the Yii PHP framework.
In order to start using the formatters you need to configure it for your application.
'components' => array(
'format' => array(
'class' => 'path.to.Formatter',
'formatters' => array(), // global formatter configurations (name=>config)
),
),Once you have configured the formatted you can use it by calling the format component.
Yii::app()->format->boolean($published);
Yii::app()->format->currency($price, array('currency' => 'EUR'));
Yii::app()->format->dateTime($updatedAt, array('dateWidth' => 'short', 'timeWidth' => 'short');
Yii::app()->format->runFormatter('path.to.MyFormatter', 'foo');
Yii::app()->format->inline(array($this, 'myFormattingMethod'), 'bar');To allow for formatting model attributes easily you can attach the formatter behavior to your model.
function behaviors() {
return array(
'formatter' => array(
'class' => 'path.to.FormatterBehavior',
'formatters' => array(), // component formatter configurations (name=>config)
),
);
}When the behavior is attached you can call it to format any attribute value using a formatter.
$model->formatAttribute('boolean', 'published');
$model->formatAttribute('currency', 'price', array('price' => 'EUR'));
$model->formatAttribute('dateTime', 'updatedAt', array('dateWidth' => 'short', 'timeWidth' => 'short'));
$model->formatAttribute('path.to.MyFormatter', 'foo');
$model->formatAttribute('myFormattingMethod', 'bar');You can also write your own formatters or use inline methods for formatting attribute values if necessary.