Porcentagens do gráfico de pizza
Os valores 1, 1 e 2 somam 4, então viram um quarto, um quarto e metade da pizza. Cole os valores de cada categoria e receba porcentagens de fatia que sempre somam exatamente 100, nunca 99,99. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Valores
- 1, 1, 2
- Total
- 4
- N
- 3
- Porcentagens
- 25, 25, 50
- Ações
- 0,25, 0,25, 0,5
Um gráfico de pizza só é honesto quando cada fatia é uma porcentagem de um mesmo total compartilhado e essas porcentagens somam exatamente cem. Esta calculadora de porcentagem de gráfico de pizza aceita uma lista de valores de categoria — vendas regionais, contagens de pesquisa, linhas de orçamento, apuração de votos ou quaisquer pesos não negativos —, soma tudo uma vez e converte cada entrada em cem vezes aquele valor dividido pelo total. A última fatia diferente de zero absorve o resíduo microscópico do arredondamento para que as porcentagens devolvidas somem sempre 100 em vez de 99.99 ou 100.01.
O que é uma porcentagem de gráfico de pizza e por que as fatias devem somar 100
Um gráfico de pizza codifica uma composição: cada fatia é a participação de uma categoria em um todo, e esse todo é a soma dos valores de categoria que você informou. A porcentagem da categoria i é cem vezes aquele valor dividido pela soma de todos os valores. Essa identidade é a mesma quer os números brutos sejam contagens, importes monetários, minutos ou pesos sem unidade, porque as unidades se cancelam na razão.
As pessoas recorrem a esta conversão quando já têm uma coluna de importes e precisam dos rótulos que ficam na pizza, na legenda ou na barra empilhada gêmea da mesma composição. A aula de geometria muitas vezes pede as mesmas participações como ângulos centrais em graus; esta calculadora responde a forma percentual dessa pergunta, que é o que painéis, slides e relatórios de pesquisa de fato imprimem ao lado de cada fatia. Duas restrições rígidas mantêm a figura honesta.
Primeiro, cada valor deve ser um número finito maior ou igual a zero: uma fatia negativa não tem sentido numa pizza e é rejeitada em vez de desenhada ao contrário. Segundo, o total deve ser estritamente positivo. Se todas as categorias são zero, não há um todo do qual tirar uma porcentagem, e a resposta correta é um erro, não um anel de fatias iguais inventadas.
Depois de formar as razões exatas, o arredondamento em ponto flutuante pode deixar um último dígito que faz a lista impressa somar 99.99 ou 100.01. Esta implementação atribui esse resíduo à última categoria diferente de zero para que as porcentagens publicadas somem exatamente 100, que é o contrato que um gráfico de pizza, uma barra empilhada e uma tabela de composição exigem antes de alguém confiar na figura.
Contrato de entrada, fórmula, arredondamento e o erro de total zero
Após a validação o motor soma a lista uma vez para obter o total. Se esse total não for estritamente maior que zero, a requisição falha com uma mensagem de que o total de todos os valores é zero, porque cada porcentagem é cem vezes o valor dividido pelo total e essa divisão é indefinida quando o denominador é zero. Caso contrário cada porcentagem é cem vezes o valor dividido pelo total, arredondada a dez casas decimais para um contrato estável entre runtimes.
A última fatia diferente de zero é então reescrita como cem menos a soma das demais, de modo que o vetor de porcentagens some 100 mesmo quando um terço periódico deixaria um dígito residual minúsculo. Categorias individuais nulas são permitidas e permanecem em zero por cento; nunca recebem o resíduo do arredondamento.
Casos de uso
Tarefas e problemas de composição
Alunos convertem uma lista curta de contagens de categoria em porcentagens de gráfico de pizza que somam 100, inclusive a regra rígida de que um total zero é inválido.
Painéis e relatórios de pesquisa
Equipes de produto e pesquisa transformam vendas, votos ou linhas de orçamento em porcentagens de legenda sem planilha e sem um 99.99 por cento sobrando.
Perguntas frequentes
Qual é a fórmula da porcentagem de gráfico de pizza?
Cada porcentagem é 100 vezes o valor daquela categoria dividido pela soma de todos os valores. A última fatia diferente de zero é ajustada para que as porcentagens publicadas somem exatamente 100.
As porcentagens sempre somam 100?
Sim, em caso de sucesso. Fatias nulas ficam em 0 por cento.
A calculadora de porcentagem de gráfico de pizza é gratuita?
A ferramenta do navegador roda grátis no seu dispositivo.
O que acontece se todos os valores forem zero?
Você recebe um erro em vez de um gráfico. Com total zero não existe um todo do qual tirar partes, então a calculadora não inventa fatias iguais.
Posso usar valores em dinheiro ou minutos em vez de contagens?
Sim. Cada parte é o valor dividido pelo total, então as unidades se cancelam: contagens, quantias, minutos ou simples pesos geram o mesmo tipo de porcentagem.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/stat/pie-chart-percentage \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"values":[1,1,2]}'const res = await fetch("https://api.kit.forhosting.com/stat/pie-chart-percentage", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"values": [
1,
1,
2
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/stat/pie-chart-percentage",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"values": [
1,
1,
2
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/pie-chart-percentage", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"values":[1,1,2]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"values":[1,1,2]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/pie-chart-percentage", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"values": [
1,
1,
2
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "stat.pie_chart_percentage",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_values | 1000 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Quando todos os valores são zero o total é zero e a requisição falha com invalid_input, porque um gráfico sem massa não tem participações definidas. A mesma função pura alimenta a ferramenta gratuita do navegador e o caminho API a US$ 0,002 por requisição bem-sucedida.
Contrato de entrada, fórmula, arredondamento e o erro de total zero
Chame a capacidade com o campo obrigatório values: um array não vazio de números finitos não negativos. Scripts que já falam em outros termos podem enviar a mesma lista sob os aliases numbers, data, counts ou list. Um campo ausente, um não-array, um array vazio, uma lista maior que o máximo publicado de mil entradas, qualquer entrada que não seja um número finito e qualquer entrada negativa falham com invalid_input e não consomem saldo. A resposta ecoa n e values, informa total, percentages, as participações unitárias correspondentes (cada valor sobre o total), sum_percent (sempre 100 em caso de sucesso) e uma string curta de formula.
Uso prático, limites, preço e como ler o resultado
Use a ferramenta do navegador quando quiser uma porcentagem de gráfico de pizza imediata ao montar um slide, conferir um problema de composição ou transformar uma coluna curta de contagens em rótulos de legenda sem abrir uma planilha. Use a API quando um painel, uma plataforma de pesquisas, um caderno de orçamento ou um gerador de aulas precisar de JSON estável para muitas listas de categorias sob um único contrato. Cada requisição bem-sucedida é um item faturável a US$ 0,002; a validação falha não consome saldo. As listas aceitas ficam limitadas para isolados Worker: até mil categorias cobrem qualquer pizza que um humano ainda consiga ler, e listas maiores pertencem a uma tabela, não a um gráfico circular. Os resultados são totalmente determinísticos: os mesmos valores sempre produzem o mesmo total, as mesmas percentages, as mesmas participações e o mesmo sum_percent de cem. Conecte o endpoint a construtores de relatórios que já têm importes e precisam de porcentagens, a oráculos de sala que pontuam a divisão vinte e cinco / vinte e cinco / cinquenta a partir dos valores um, um e dois, ou a um passo prévio que rejeita uma coluna toda nula antes de um renderizador tentar desenhar uma pizza vazia. Leia percentages para os rótulos que você imprime no gráfico, shares se precisar de uma fração de zero a um para mais matemática, e sum_percent como checagem rápida de que o ajuste de arredondamento rodou.
Casos de integração
Scripts e fixtures de integração contínua
Pipelines chamam um contrato determinístico de porcentagens em vez de reimplementar o arredondamento valor-sobre-total em cada linguagem.
Perguntas técnicas
Como calcular porcentagens de gráfico de pizza com esta calculadora?
Envie JSON com values (um array não vazio de números não negativos cujo total seja maior que zero) para stat.pie_chart_percentage. A resposta devolve n, values, total, percentages, shares, sum_percent e formula.
O que acontece se o total de todos os valores for zero?
A requisição falha com invalid_input porque as porcentagens são indefinidas quando a soma é zero. Falhas de validação não são cobradas.