Calculadora de eficiencia del sueño
Divida los minutos que durmió entre los minutos que pasó en la cama: 390 dormido sobre 480 en cama dan un 81,25 % de eficiencia del sueño y 90 minutos despierto en la cama. Es la cifra habitual de los diarios de sueño. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Tiempo dormido
- 390
- Tiempo en la cama
- 480
- Minutos despierto
- 90 percent
- Eficiencia del sueño
- 81,25
La eficiencia del sueño es la fracción del tiempo en cama que usted pasa realmente dormido, expresada como porcentaje. Clínicos, coaches del sueño y aplicaciones de diario la emplean como señal compacta de calidad: una eficiencia alta significa que la mayor parte de la noche fue sueño, mientras que una eficiencia baja suele reflejar una latencia larga, despertares frecuentes o vigilia tras el inicio del sueño. Esta calculadora de eficiencia del sueño acepta el tiempo total de sueño y el tiempo en cama en minutos, divide el tiempo dormido entre el tiempo en cama, multiplica por cien y devuelve un porcentaje estable más los minutos de vigilia aún pasados en cama.
Qué significa la eficiencia del sueño y cómo se define el porcentaje
La eficiencia del sueño, a menudo abreviada SE, se define como el tiempo total de sueño dividido por el tiempo en cama, y luego escalado a porcentaje. El tiempo total de sueño (TST) son los minutos en que usted estuvo realmente dormido: el sueño nocturno tras restar la latencia de inicio y cualquier vigilia posterior al inicio que aún cuenta como tiempo en cama.
El tiempo en cama (TIB) es el intervalo desde que usted pretende dormir (luces apagadas o meterse en la cama para la noche) hasta que se levanta definitivamente para el día. Si usted pasó ocho horas en cama y durmió seis horas y media de ellas, la eficiencia es trescientos noventa minutos sobre cuatrocientos ochenta minutos por cien, es decir, unos ochenta y uno por ciento.
Ese único cociente no diagnostica un trastorno por sí solo, pero es un resumen estándar en diarios de sueño y en muchos protocolos de investigación porque captura el tiempo de cama desperdiciado sin exigir polisomnografía. Las metas habituales de coaching suelen apuntar a unos ochenta y cinco por ciento o más al consolidar una ventana de sueño, aunque los objetivos individuales deben venir de un clínico cualificado. No estima fases, riesgo de apnea ni fase circadiana.
Los minutos son la unidad natural para filas de diario y exportaciones de wearables; convierta horas a minutos antes de llamar si su fuente registra horas decimales. Los minutos de vigilia devueltos junto a la eficiencia son simplemente el tiempo en cama menos el tiempo dormido, de modo que usted puede mostrar cuánto de la noche se pasó despierto aún en cama.
Contrato de entrada, forma de la respuesta y comportamiento ante errores
Ambos valores deben ser estrictamente mayores que cero. Los campos ausentes, las cadenas vacías, NaN, Infinity y los valores no positivos también fallan con mensajes que nombran el campo. Esos fallos de validación no se facturan.
Ejemplo: trescientos noventa minutos dormido y cuatrocientos ochenta minutos en cama producen ochenta y uno punto veinticinco por ciento de eficiencia y noventa minutos de vigilia. Combine el número con sus propias bandas o textos de coaching si necesita umbrales clínicos; este extremo calcula solo el cociente y no emite gráficos de fases, integración de dispositivos ni consejo médico.
Quién usa la eficiencia del sueño y para qué
Las aplicaciones de diario de sueño y los rastreadores de deberes CBT-I necesitan un oráculo determinista para que cada cliente —móvil, web o importación de hoja de cálculo— concuerde en el porcentaje para los mismos dos recuentos de minutos. Las plataformas de coaching puntúan por lotes diarios semanales sin levantar una pila completa de analítica del sueño.
Los ayudantes de investigación que limpian exportaciones de actigrafía o de autoinforme pueden llamar a un extremo parse diminuto en lugar de reimplementar los casos límite de tiempo en cama cero o de tiempo dormido mayor que el tiempo en cama. La validación fallida no consume saldo. Mantenga las peticiones pequeñas, fije el porcentaje redondeado en las pruebas y obtendrá eficiencia del sueño reproducible para diarios, módulos LMS y workers de borde sin alojar una infraestructura de puntuación propia.
Qué puede hacer con ella
Diario de sueño y deberes CBT-I
Convierta los minutos nocturnos de tiempo dormido y tiempo en cama en un porcentaje estable de eficiencia del sueño para hojas de trabajo y revisiones semanales.
Investigación y limpieza de exportaciones
Valide exportaciones de actigrafía o de autoinforme rechazando filas imposibles en las que los minutos dormidos superan el tiempo en cama.
Preguntas frecuentes
¿Qué unidades debo usar?
Convierta primero las horas a minutos (por ejemplo, 7.5 horas son 450 minutos).
¿Qué ocurre si el tiempo dormido es mayor que el tiempo en cama?
La eficiencia clásica del sueño exige que el tiempo total de sueño sea menor o igual que el tiempo en cama; no se devuelven valores por encima del 100%.
¿Esto diagnostica un trastorno del sueño?
No. Solo calcula el cociente aritmético usado en los diarios de sueño. La interpretación clínica corresponde a un profesional cualificado.
¿Qué porcentaje de eficiencia del sueño se considera bueno?
En el acompañamiento del sueño se suele apuntar a un 85 % o más al consolidar el horario de descanso. Tómelo como referencia general: su objetivo personal debe fijarlo un profesional de la salud cualificado.
¿Qué cuenta como tiempo en cama y qué como tiempo dormido?
El tiempo en cama va desde que apaga la luz o se acuesta para la noche hasta que se levanta definitivamente. El tiempo dormido es lo que queda al restar lo que tardó en dormirse y los despertares nocturnos.
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/health/sleep-efficiency \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"time_asleep":390,"time_in_bed":480}'const res = await fetch("https://api.kit.forhosting.com/health/sleep-efficiency", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"time_asleep": 390,
"time_in_bed": 480
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/health/sleep-efficiency",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"time_asleep": 390,
"time_in_bed": 480
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/health/sleep-efficiency", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"time_asleep":390,"time_in_bed":480}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"time_asleep":390,"time_in_bed":480}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/sleep-efficiency", 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
{
"time_asleep": 390,
"time_in_bed": 480
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "health.sleep_efficiency",
"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.
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
Los valores inválidos —campos ausentes, duraciones no positivas o minutos dormidos mayores que los minutos en cama— fallan con un error invalid_input claro en lugar de inventar un porcentaje por encima de cien.
Qué significa la eficiencia del sueño y cómo se define el porcentaje
Esta calculadora implementa solo la definición aritmética: SE es igual a time_asleep sobre time_in_bed por cien.
Contrato de entrada, forma de la respuesta y comportamiento ante errores
Envíe por POST un cuerpo JSON con dos números finitos obligatorios en minutos: time_asleep (tiempo total de sueño) y time_in_bed (tiempo en cama desde apagar las luces o meterse en la cama hasta el levantarse final). Cada campo puede llegar como número JSON o como cadena numérica; el manejador acepta alias como tst, total_sleep_time, asleep_minutes para el tiempo de sueño y tib, in_bed_minutes, bed_minutes para el tiempo en cama. Si time_asleep es mayor que time_in_bed, la petición falla con invalid_input, porque la definición clásica no permite más sueño que tiempo en cama y los porcentajes por encima de cien por ciento falsearían los resúmenes de diario. En el éxito el cuerpo repite time_asleep y time_in_bed ya limpios, wake_minutes como su diferencia, sleep_efficiency como el porcentaje redondeado para una comparación estable entre entornos de ejecución, unit igual a percent, la cadena de fórmula SE (%) igual a time_asleep sobre time_in_bed por cien, y el método sleep_efficiency.
Dónde una API de eficiencia del sueño justifica su coste
Como la implementación es parse pura de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo y sin red de salida.
Casos de integración
Cuadros de mando de coaching y bienestar
Puntúe por lotes las filas del diario del cliente con el mismo cociente que usa el widget gratuito del navegador, sin reimplementar los casos límite de validación.
Preguntas técnicas
¿Cómo se calcula la eficiencia del sueño?
La eficiencia del sueño SE (%) = (time_asleep / time_in_bed) × 100. Envíe ambos valores en minutos; la API devuelve el porcentaje, los minutos de vigilia en cama y la cadena de fórmula.
¿Cuánto cuesta la calculadora de eficiencia del sueño?
La herramienta del navegador es gratuita. Las peticiones API usan saldo prepago de KIT a $0.002 por llamada exitosa; la entrada inválida no se factura.