<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>CakePHP Brasil &#187; helper</title>
	<atom:link href="http://blog.cakephp-brasil.org/tag/helper/feed/" rel="self" type="application/rss+xml" />
	<link>http://blog.cakephp-brasil.org</link>
	<description>O blog público para desenvolvedores CakePHP.</description>
	<lastBuildDate>Tue, 06 Sep 2011 04:29:49 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.2</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>Formatação no estilo brasileiro</title>
		<link>http://blog.cakephp-brasil.org/2009/04/22/formatacao-no-estilo-brasileiro/</link>
		<comments>http://blog.cakephp-brasil.org/2009/04/22/formatacao-no-estilo-brasileiro/#comments</comments>
		<pubDate>Wed, 22 Apr 2009 23:41:31 +0000</pubDate>
		<dc:creator>Juan Basso</dc:creator>
				<category><![CDATA[CakePHP]]></category>
		<category><![CDATA[Tutoriais]]></category>
		<category><![CDATA[cakebr]]></category>
		<category><![CDATA[data]]></category>
		<category><![CDATA[formatacao]]></category>
		<category><![CDATA[helper]]></category>
		<category><![CDATA[hora]]></category>
		<category><![CDATA[numero]]></category>

		<guid isPermaLink="false">http://blog.cakephp-brasil.org/?p=103</guid>
		<description><![CDATA[Cansado de chamar várias funções com diversos parâmetros para formatar os valores de data, número, etc nos padrões brasileiros? Então seu problemas acabaram!
Agora no plugin CakeBr há o helper chamado Formatacao para facilitar a formatação de datas e números. Os seguintes métodos podem ser utilizados:

data($data = null) Formata uma data timestamp no formato dd/mm/YYYY. Se [...]]]></description>
			<content:encoded><![CDATA[<p>Cansado de chamar várias funções com diversos parâmetros para formatar os valores de data, número, etc nos padrões brasileiros? Então seu problemas acabaram!</p>
<p>Agora no <a href="https://github.com/jrbasso/cake_ptbr/tree">plugin CakeBr</a> há o helper chamado Formatacao para facilitar a formatação de datas e números. Os seguintes métodos podem ser utilizados:</p>
<ul>
<li><strong>data($data = null)</strong> Formata uma data timestamp no formato dd/mm/YYYY. Se não for informada a data, será utilizada a data atual</li>
<li><strong>dataHora($dataHora = null, $segundos = true)</strong> Idem anterior, porém com a informação da hora junto.</li>
<li><strong>dataCompleta($dataHora = null)</strong> Mostra a data completa. Exemplo: &#8216;terça-feira, 21 de abril de 2009, 10:00:00&#8242;.</li>
<li><strong>precisao($numero, $casasDecimais = 3)</strong> Similar ao método precision do helper Time, mostrando os números no formato brasileiro.</li>
<li><strong>porcentagem($numero, $casasDecimais = 2)</strong> Mostra o valor em porcentos, similar ao toPorcentage do TimeHelper.</li>
<li><strong>moeda($valor, $opcoes = array())</strong> Mostra o valor em reais. Exemplo: R$ 10,20.</li>
<li><strong>moedaPorExtenso($numero)</strong> Escreve o valor por extenso, em reais.</li>
</ul>
<p>Caso alguém tenha mais algum método para incluir, basta informar ou criar um fork no projeto.</p>
]]></content:encoded>
			<wfw:commentRss>http://blog.cakephp-brasil.org/2009/04/22/formatacao-no-estilo-brasileiro/feed/</wfw:commentRss>
		<slash:comments>10</slash:comments>
		</item>
		<item>
		<title>Usando o helper Number</title>
		<link>http://blog.cakephp-brasil.org/2008/05/24/usando-o-helper-number/</link>
		<comments>http://blog.cakephp-brasil.org/2008/05/24/usando-o-helper-number/#comments</comments>
		<pubDate>Sat, 24 May 2008 05:00:07 +0000</pubDate>
		<dc:creator>Juan Basso</dc:creator>
				<category><![CDATA[CakePHP]]></category>
		<category><![CDATA[format]]></category>
		<category><![CDATA[helper]]></category>
		<category><![CDATA[number]]></category>

		<guid isPermaLink="false">http://blog.cakephp-brasil.org/?p=17</guid>
		<description><![CDATA[Acredito que na maioria dos sites é necessário a formatação de números, incluindo valores. Por isso, vou explicar as funções que o helper Number pode nos proporcionar para que nossos sistemas fiquem mais ágeis ainda.
Ele possui 5 métodos, são eles:
precision: você passa um número de parâmetro e ele vai retornar este número com uma certa [...]]]></description>
			<content:encoded><![CDATA[<p>Acredito que na maioria dos sites é necessário a formatação de números, incluindo valores. Por isso, vou explicar as funções que o helper Number pode nos proporcionar para que nossos sistemas fiquem mais ágeis ainda.</p>
<p>Ele possui 5 métodos, são eles:</p>
<p><strong>precision</strong>: você passa um número de parâmetro e ele vai retornar este número com uma certa quantidade de casas decimais. A quantidade de casas que você quer é definido no segundo parâmetro. Este segundo parâmetro é opcional, sendo o padrão 3. Exemplos:</p>

<div class="wp_codebox_msgheader"><span class="right"><sup><a href="http://www.ericbess.com/ericblog/2008/03/03/wp-codebox/#examples" target="_blank" title="WP-CodeBox HowTo?"><span style="color: #99cc00">?</span></a></sup></span><span class="left"><a href="javascript:;" onclick="javascript:showCodeTxt('p17code6'); return false;">View Code</a> PHP</span><div class="codebox_clear"></div></div><div class="wp_codebox"><table><tr id="p176"><td class="line_numbers"><pre>1
2
3
</pre></td><td class="code" id="p17code6"><pre class="php" style="font-family:monospace;"><span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">precision</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">50.37243682</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará 50.372</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">precision</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">50.37243682</span><span style="color: #339933;">,</span> <span style="color: #cc66cc;">2</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará 50.37</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">precision</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">50.3</span><span style="color: #339933;">,</span> <span style="color: #cc66cc;">3</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará 50.300</span></pre></td></tr></table></div>

<p><strong>toReadableSize</strong>: você passa uma quantidade de bytes e ele retorna de uma forma legível o tamanho. Por exemplo, 1024 bytes correspondem a 1 KB, portanto ele vai te retornar &#8216;1 KB&#8217;. Exemplos:</p>

<div class="wp_codebox_msgheader"><span class="right"><sup><a href="http://www.ericbess.com/ericblog/2008/03/03/wp-codebox/#examples" target="_blank" title="WP-CodeBox HowTo?"><span style="color: #99cc00">?</span></a></sup></span><span class="left"><a href="javascript:;" onclick="javascript:showCodeTxt('p17code7'); return false;">View Code</a> PHP</span><div class="codebox_clear"></div></div><div class="wp_codebox"><table><tr id="p177"><td class="line_numbers"><pre>1
2
3
4
</pre></td><td class="code" id="p17code7"><pre class="php" style="font-family:monospace;"><span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">toReadableSize</span><span style="color: #009900;">&#40;</span><span style="color: #cc66cc;">0</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '0 Bytes'</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">toReadableSize</span><span style="color: #009900;">&#40;</span><span style="color: #cc66cc;">1</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '1 Byte'</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">toReadableSize</span><span style="color: #009900;">&#40;</span><span style="color: #cc66cc;">10240</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '10 KB'</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">toReadableSize</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">21411921.92</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '20.42 MB'</span></pre></td></tr></table></div>

<p><strong>toPercentage</strong>: simplesmente coloca o sinal % no final. É opcional informar a precisão como segundo parâmetro. Exemplos:</p>

<div class="wp_codebox_msgheader"><span class="right"><sup><a href="http://www.ericbess.com/ericblog/2008/03/03/wp-codebox/#examples" target="_blank" title="WP-CodeBox HowTo?"><span style="color: #99cc00">?</span></a></sup></span><span class="left"><a href="javascript:;" onclick="javascript:showCodeTxt('p17code8'); return false;">View Code</a> PHP</span><div class="codebox_clear"></div></div><div class="wp_codebox"><table><tr id="p178"><td class="line_numbers"><pre>1
2
</pre></td><td class="code" id="p17code8"><pre class="php" style="font-family:monospace;"><span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">toPercentage</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">50.4563</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará 50.456%</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">toPercentage</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">50.421</span><span style="color: #339933;">,</span> <span style="color: #cc66cc;">2</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará 50.42%</span></pre></td></tr></table></div>

<p><strong>format</strong>: O primeiro parâmetro corresponde ao número. O segundo, opcional, corresponde as opções que você deseja para formatar o número. Neste parâmetro você passa um array com as opções, onde você pode configurar o seguinte:<br />
 - before: texto que vai na frente do número. O padrão é &#8216;$&#8217;;<br />
 - places: número de casas decimais. O padrão é 2;<br />
 - thousands: símbolo de separação de milhares. O padrão é &#8216;,&#8217;;<br />
 - decimals: símbolo de separação de decimais. O padrão é &#8216;.&#8217;.<br />
 - after: texto que vai atrás do número. O padrão é vazio;<br />
Exemplos:</p>

<div class="wp_codebox_msgheader"><span class="right"><sup><a href="http://www.ericbess.com/ericblog/2008/03/03/wp-codebox/#examples" target="_blank" title="WP-CodeBox HowTo?"><span style="color: #99cc00">?</span></a></sup></span><span class="left"><a href="javascript:;" onclick="javascript:showCodeTxt('p17code9'); return false;">View Code</a> PHP</span><div class="codebox_clear"></div></div><div class="wp_codebox"><table><tr id="p179"><td class="line_numbers"><pre>1
2
3
4
</pre></td><td class="code" id="p17code9"><pre class="php" style="font-family:monospace;"><span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">format</span><span style="color: #009900;">&#40;</span><span style="color: #cc66cc;">50</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '$50.00'</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">format</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">50.25</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '$50.25'</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">format</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">50.25</span><span style="color: #339933;">,</span> <span style="color: #990000;">array</span><span style="color: #009900;">&#40;</span><span style="color: #0000ff;">'decimal'</span><span style="color: #339933;">=&gt;</span><span style="color: #0000ff;">','</span><span style="color: #009900;">&#41;</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '$50,25'</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">format</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">2050.25</span><span style="color: #339933;">,</span> <span style="color: #990000;">array</span><span style="color: #009900;">&#40;</span><span style="color: #0000ff;">'after'</span><span style="color: #339933;">=&gt;</span><span style="color: #0000ff;">''</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">'before'</span><span style="color: #339933;">=&gt;</span><span style="color: #0000ff;">''</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">'thousands'</span><span style="color: #339933;">=&gt;</span><span style="color: #0000ff;">'.'</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">'decimal'</span><span style="color: #339933;">=&gt;</span><span style="color: #0000ff;">','</span><span style="color: #009900;">&#41;</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '2.050,25'</span></pre></td></tr></table></div>

<p><strong>currency</strong>: transforma um número em valor monetário. Como segundo parâmetro, é opcional informar a unidade monetária. Atualmente, o CakePHP suporta apenas 3: USD (Dólar americano), GBP (Libra esterlina) e EUR (Euro). Já fiz o pedido para o pessoal de desenvolvido para incluírem o BRL (Real Brasileiro), mas acredito que só entre na versão 2.0. Mesmo não tendo a moeda brasileira ali, é possível usar o terceiro parâmetro, que então você pode definir as mesmas configurações de format e mais:<br />
 - zero: valor neutro da moeda. O padrão é &#8216;0&#8242;;<br />
 - negative: como será apresentado valores negativo. Caso seja configurado &#8216;()&#8217;, ele irá colocar o número entre os parênteses, caso contrário irá colocar o valor na frente do número (por exemplo &#8216;-&#8217; acarreta em &#8216;-R$100,00&#8242;). O padrão é &#8216;()&#8217;;<br />
 - escape: ignorar códigos HTML. O padrão é verdadeiro (true).<br />
Além disso, o padrão de &#8216;before&#8217; aqui é vazio e não &#8216;$&#8217;. Valores entre -1 e 1 serão colocados em centavos, portanto é necessário definir o valor de &#8216;after&#8217;. Exemplos:</p>

<div class="wp_codebox_msgheader"><span class="right"><sup><a href="http://www.ericbess.com/ericblog/2008/03/03/wp-codebox/#examples" target="_blank" title="WP-CodeBox HowTo?"><span style="color: #99cc00">?</span></a></sup></span><span class="left"><a href="javascript:;" onclick="javascript:showCodeTxt('p17code10'); return false;">View Code</a> PHP</span><div class="codebox_clear"></div></div><div class="wp_codebox"><table><tr id="p1710"><td class="line_numbers"><pre>1
2
3
4
</pre></td><td class="code" id="p17code10"><pre class="php" style="font-family:monospace;"><span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">currency</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">10.20</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '10.20'</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">currency</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">10.20</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">'USD'</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '$10.20'</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">currency</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">0.56</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">'USD'</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará '56c'</span>
<span style="color: #000088;">$number</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">currency</span><span style="color: #009900;">&#40;</span><span style="color:#800080;">345323.234</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">''</span><span style="color: #339933;">,</span> <span style="color: #990000;">array</span><span style="color: #009900;">&#40;</span><span style="color: #0000ff;">'after'</span><span style="color: #339933;">=&gt;</span><span style="color: #0000ff;">'R$'</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">'thousands'</span><span style="color: #339933;">=&gt;</span><span style="color: #0000ff;">'.'</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">'decimals'</span><span style="color: #339933;">=&gt;</span><span style="color: #0000ff;">','</span><span style="color: #009900;">&#41;</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span> <span style="color: #666666; font-style: italic;">// Retornará 'R$345.323,23'</span></pre></td></tr></table></div>

<p>É isso aí&#8230; Qualquer coisa é só perguntar.</p>
]]></content:encoded>
			<wfw:commentRss>http://blog.cakephp-brasil.org/2008/05/24/usando-o-helper-number/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>

