Porcentajes de gráfico circular
Las cantidades 1, 1 y 2 suman 4, así que ocupan un cuarto, un cuarto y la mitad del círculo. Pegue los valores de cada categoría y obtenga porcentajes de sector que siempre suman exactamente 100, nunca 99,99. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Valores
- 1, 1, 2
- Total
- 4
- N
- 3
- Porcentajes
- 25, 25, 50
- Acciones
- 0,25, 0,25, 0,5
Un gráfico circular solo es honesto cuando cada porción es un porcentaje de un mismo total compartido y esos porcentajes suman exactamente cien. Esta calculadora de porcentajes de gráfico circular acepta una lista de valores de categoría — ventas regionales, conteos de encuesta, partidas de presupuesto, recuentos de votos o cualquier peso no negativo —, los suma una sola vez y convierte cada entrada en cien veces ese valor dividido entre el total. La última porción distinta de cero absorbe el residuo microscópico del redondeo para que los porcentajes devueltos sumen siempre 100 en lugar de 99.99 o 100.01.
Qué es un porcentaje de gráfico circular y por qué las porciones deben sumar 100
Un gráfico circular codifica una composición: cada porción es la participación de una categoría en un todo, y ese todo es la suma de los valores de categoría que usted suministró. El porcentaje de la categoría i es cien veces ese valor dividido entre la suma de todos los valores. Esa identidad es la misma tanto si las cifras brutas son conteos, importes monetarios, minutos o pesos sin unidad, porque las unidades se cancelan en el cociente.
Se recurre a esta conversión cuando ya se tiene una columna de importes y se necesitan las etiquetas que van sobre el gráfico, la leyenda o la barra apilada gemela de la misma composición. En geometría a menudo se piden las mismas participaciones como ángulos centrales en grados; esta calculadora responde la forma porcentual de esa pregunta, que es lo que paneles, diapositivas e informes de encuesta imprimen junto a cada porción. Dos restricciones duras mantienen honesta la figura.
Primera: cada valor debe ser un número finito mayor o igual que cero; una porción negativa no tiene sentido en un gráfico circular y se rechaza en vez de dibujarse al revés. Segunda: el total debe ser estrictamente positivo. Si todas las categorías son cero, no hay un todo del que tomar un porcentaje, y la respuesta correcta es un error, no un anillo de porciones iguales inventadas.
Tras formar los cocientes exactos, el redondeo en coma flotante puede dejar un último dígito que hace que la lista impresa sume 99.99 o 100.01. Esta implementación asigna ese residuo a la última categoría distinta de cero para que los porcentajes publicados sumen exactamente 100, que es el contrato que un gráfico circular, una barra apilada y una tabla de composición exigen antes de fiarse de la figura.
Contrato de entrada, fórmula, redondeo y el error de total nulo
Tras la validación el motor suma la lista una vez para obtener el total. Si ese total no es estrictamente mayor que cero, la petición falla con un mensaje de que el total de todos los valores es cero, porque cada porcentaje es cien veces el valor dividido entre el total y esa división no está definida cuando el denominador es cero. En caso contrario cada porcentaje es cien veces el valor dividido entre el total, redondeado a diez decimales para un contrato estable entre runtimes.
La última porción distinta de cero se reescribe entonces como cien menos la suma de las demás, de modo que el vector de porcentajes sume 100 incluso cuando un tercio periódico dejaría un dígito residual minúsculo. Las categorías individuales nulas se permiten y permanecen en cero por ciento; nunca reciben el residuo del redondeo.
Qué puede hacer con ella
Tareas y problemas de composición
Los estudiantes convierten una lista breve de conteos de categoría en porcentajes de gráfico circular que suman 100, incluida la regla dura de que un total nulo no es válido.
Paneles e informes de encuesta
Los equipos de producto e investigación transforman ventas, votos o partidas de presupuesto en porcentajes de leyenda sin hoja de cálculo y sin un 99.99 por ciento sobrante.
Scripts y anclajes de integración continua
Los pipelines invocan un contrato determinista de porcentajes en lugar de reimplementar el redondeo valor-sobre-total en cada lenguaje.
Preguntas frecuentes
¿Cuál es la fórmula del porcentaje de gráfico circular?
Cada porcentaje es 100 veces el valor de esa categoría dividido entre la suma de todos los valores. La última porción distinta de cero se ajusta para que los porcentajes publicados sumen exactamente 100.
¿Los porcentajes suman siempre 100?
Sí, cuando hay éxito. Las porciones nulas se quedan en 0 por ciento.
¿La calculadora de porcentajes de gráfico circular es gratuita?
La herramienta del navegador se ejecuta gratis en su dispositivo.
¿Qué pasa si todos mis valores son cero?
Recibirá un aviso de error en lugar de un gráfico. Con un total de cero no hay un todo del que sacar partes, así que la calculadora no inventa sectores iguales.
¿Puedo usar importes de dinero o minutos en lugar de recuentos?
Sí. Cada parte es el valor dividido entre el total, de modo que las unidades se anulan: recuentos, importes, minutos o simples pesos dan el mismo tipo de porcentaje.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
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)Ejemplo de solicitud
{
"values": [
1,
1,
2
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "stat.pie_chart_percentage",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_values | 1000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Cuando todos los valores son cero el total es cero y la petición falla con invalid_input, porque un gráfico sin masa no tiene participaciones definidas. La misma función pura alimenta la herramienta gratuita del navegador y la ruta API a $0.002 por petición exitosa.
Contrato de entrada, fórmula, redondeo y el error de total nulo
Llame a la capacidad con el campo obligatorio values: un array no vacío de números finitos no negativos. Los scripts que ya hablan en otros términos pueden enviar la misma lista bajo los alias numbers, data, counts o list. Un campo ausente, un no-array, un array vacío, una lista más larga que el máximo publicado de mil entradas, cualquier entrada que no sea un número finito y cualquier entrada negativa fallan con invalid_input y no consumen saldo. La respuesta repite n y values, informa total, percentages, las participaciones unitarias correspondientes (cada valor sobre el total), sum_percent (siempre 100 si hay éxito) y una cadena breve de formula.
Uso práctico, límites, precio y cómo leer el resultado
Use la herramienta del navegador cuando quiera un porcentaje de gráfico circular inmediato al armar una diapositiva, comprobar un problema de composición o convertir una columna breve de conteos en etiquetas de leyenda sin abrir una hoja de cálculo. Use la API cuando un panel, una plataforma de encuestas, un cuaderno de presupuestos o un generador de lecciones necesite JSON estable para muchas listas de categorías bajo un solo contrato. Cada petición exitosa es un ítem facturable a $0.002; la validación fallida no consume saldo. Las listas aceptadas se acotan para aislados Worker: hasta mil categorías cubren cualquier gráfico que un humano aún pueda leer, y las listas mayores pertenecen a una tabla, no a un diagrama circular. Los resultados son totalmente deterministas: los mismos valores siempre producen el mismo total, los mismos percentages, las mismas participaciones y el mismo sum_percent de cien. Conecte el endpoint a constructores de informes que ya tienen importes y necesitan porcentajes, a oráculos de aula que puntúan el reparto veinticinco / veinticinco / cincuenta a partir de los valores uno, uno y dos, o a un paso previo que rechaza una columna toda nula antes de que un renderizador intente dibujar un gráfico vacío. Lea percentages para las etiquetas que imprime en el gráfico, shares si necesita una fracción de cero a uno para más matemática, y sum_percent como comprobación rápida de que el ajuste de redondeo se aplicó.
Preguntas técnicas
¿Cómo se calculan los porcentajes de gráfico circular con esta herramienta?
Envíe JSON con values (un array no vacío de números no negativos cuyo total sea mayor que cero) a stat.pie_chart_percentage. La respuesta devuelve n, values, total, percentages, shares, sum_percent y formula.
¿Qué ocurre si el total de todos los valores es cero?
La petición falla con invalid_input porque los porcentajes no están definidos cuando la suma es cero. Los fallos de validación no se cobran.