Funções PHP

. Glossários      Funções PHP - money_format ( )

Menu Guias e Glossários ▼


Com o nosso glossário PHP, você poderá localizar todos os comandos e funções do PHP, facilitando a construção da sua home-page.

» Para ver scripts em PHP, clique aqui.
 

Função: money_format ( )

(PHP 4 >= 4.3.0, PHP 5)

money_format -- Formata um número como uma string de moeda

string money_format ( string formato, float numero)

money_format() retorna uma versão formatada de um numero. Esta função engloba a biblioteca de função do C strfmon(), com a diferença que esta implementação converte apenas um número por vez.

Nota: A função money_format() é apenas definida se o sistema tem capacidades de strfmon. Por exemplo, o Windows não tem, então money_format() está indefinida o Windows.

A especificação do formato consistem da seguinte sequência:

a % character
flags opcionais
largura de campo opcional
precisão da esquerda opcional
precisão da direita opcional
conversão de caractere requerida
Flags. Uma ou mais, das flags opcionais abaixo podem ser usadas:

=f
O caracter = seguido por um caractere (byte simples) f para ser usado como o caracter númerico de preenchimento. O caractere de preenchimento padrão é o espaço.

^
Desabilite o uso de agrupamento de caractere (como definido pela localidade atual).

+ ou (
Especifique o estilo de formatação para números positivos e negativos. Se + é usado, o equivalente da localidade para + e - será usado. Se ( é usado, quantias negativas são fechadas em parêntesis. se nenhuma especificação é dada, o padrão será +.

!
Suprima o simbolo atual da string de saída.

-
Se presente, isso fará todos os campos esquerda-justificados (arrumados para a direita), em oposição ao padrão que é para campos serem direita-justificados (arrumados para a esquerda).

Largura de campo.

w
Uma string de dígito decimal especificando uma largura de campo mínima. O campo será direita-justificado a menos que o flag - seja usado. Valor padrão é 0 (zero) por definição.

Precisão de esquerda.

#n
O número máximo de dígitos (n) esperado para a esquerda do caracatere decimal(ex. ponto decimal). Isso é usado normalmente para manter a saída formatada alinhada nas mesmas colunas, usando o caractere de preenchimento se o número de dígitos é menor do que n. Se o número de dígitos atual é maior do que n, então esta especificação é ignorada.

Se agrupamento foi suprimido usando a flag ^, separatores de agrupamento serão inseridos antes dos caracteres de preenchimento (se algum) são adicionados, mesmo se o caractere de preenchimento é um dígito.

Para garantir alinhamento, quaisquer caracteres aparecendo, antes ou depois do número em saída formatada, como moeda ou simbolos de sinal, são arrumado conforme necessário, com caracteres de espaço para fazer seus formatos positivos e negativos num comprimento igual.

Precisão de direita.

.p
Um período seguido por um número de dígitos (p) depois do caractere decimal. Se o valor de p é 0 (zero), o caractere decimal e os digitos à sua direita serão omitidos. Se nenhuma precisão de direita é incluida, o padrão será ditado pela localidade atual em uso. A quantia sendo formatada é arredondada para o número de dígitos especificados a priori para ser formatado.

Caracteres de conversão.

i
O número é formatado de acordo com o formato de moeda internacional da localidade (ex para a localidade de EUA: USD 1,234.56).

n
O número é formatado de acordo com o formato de moeda nacional da localidade (ex: para a localidade de_DE: DM1.234,56).

%
Retorna o caractere %.

Nota: A categoria LC_MONETARY de configurações de localidade, afeta o comportamento desta função. Utilize setlocale() para definir a localidade padrão apropriadamente antes de usar esta função.

Os caracteres antes e depois da string de formatação serão retornados sem modificação.

Exemplo:

Uso do . money_format()

Nós usaremos localidades diferentes e especificações de formatos e localidades para ilustrar o uso desta função.

<?php
$number = 1234.56;

// Vamos exibir o formato internacional para a localidade en_US
setlocale(LC_MONETARY, 'en_US');
echo money_format('%i', $number)."\n";
// USD 1,234.56

// Formato nacional italiano com 2 decimais
setlocale(LC_MONETARY, 'it_IT');
echo money_format('%.2n', $number)."\n";
// L. 1.234,56

// Usando um número negativo
$number = -1234.5672;

// Formato nacional de US, usando () para números negativos
// e 10 dígitos para precisão de esquerda
setlocale(LC_MONETARY, 'en_US');
echo money_format('%(#10n', $number)."\n";
// ($ 1,234.57)

// Similar ao formato acima, adicionando o uso de dois dígitos de precisão de direita
// e '*' como caractere de preenchimento
echo money_format('%=*(#10.2n', $number)."\n";
// ($********1,234.57)

// Vamos justificar para a direita, usando largura de 14 posições, 8 digitos de
// precisão de esquerda, 2 precisão de direita, sem caractere de agrupamento
// e usando o formato internacional para a localiade de_DE.
setlocale(LC_MONETARY, 'de_DE');
echo money_format('%=*^-14#8.2i', 1234.56)."\n";
// DEM 1234,56****

// Vamos adicionar alguns dizeres antes e depois da especificação de conversão
setlocale(LC_MONETARY, 'en_GB');
$fmt = 'O valor final é %i (depois de um desconto de 10%%)';
echo money_format($fmt, 1234.56)."\n";
// O valor final é GBP 1,234.56 (depois de um desconto de 10%)
?>

Veja também: setlocale(), number_format(),sprintf(), printf() e sscanf().

As funçoes estão dividas em 4 listagens:
- Funções de A - D
- Funções de E - H
- Funções de I - M
- Funções de N - Z

Clique no menu ao lado para ter acesso às funções ou para trocar de listagens.

■ Veja também:
APLICAÇÕES PRONTAS DE JAVA APPLET: Os Applets são muito utilizados em menus, jogos e pequenas animações dentro de home-pages. Vale a pena conferir!


 

 
 

    Página Inicial | Mapa do site | Termos de Uso | Política de Privacidade | Hospedagem de sites
    © 2002-09 SuperTráfego.com - 1906 usuários online - O SuperTráfego é mantido por Spacic Interactive