ForHosting KIT · Saúde e esporte

Calculadora de eficiência do sono

Divida os minutos que você dormiu pelos minutos que passou na cama: 390 dormindo de 480 na cama dão 81,25% de eficiência do sono e 90 minutos acordado na cama. É o número padrão dos diários de sono. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Tempo dormindo: 390
Tempo na cama: 480

Você obtém

Minutos acordado: 90 percent
Eficiência do sono: 81,25

A eficiência do sono é a fração do tempo na cama que você passa de fato dormindo, expressa como porcentagem. Clínicos, coaches do sono e aplicativos de diário usam esse índice como sinal compacto de qualidade: eficiência alta significa que a maior parte da noite foi sono, enquanto eficiência baixa costuma refletir latência longa, despertares frequentes ou vigília após o início do sono. Esta calculadora de eficiência do sono aceita o tempo total de sono e o tempo na cama em minutos, divide o tempo dormindo pelo tempo na cama, multiplica por cem e devolve uma porcentagem estável mais os minutos de vigília ainda passados na cama.

O que a eficiência do sono significa e como a porcentagem é definida

A eficiência do sono, muitas vezes abreviada SE, define-se como o tempo total de sono dividido pelo tempo na cama, depois escalado para porcentagem. O tempo total de sono (TST) são os minutos em que você esteve realmente dormindo: o sono noturno após subtrair a latência de início e qualquer vigília após o início que ainda conta como tempo na cama. O tempo na cama (TIB) é o intervalo desde quando você pretende dormir (luzes apagadas ou deitar-se para a noite) até levantar-se de vez para o dia.

Se você passou oito horas na cama e dormiu seis horas e meia delas, a eficiência é trezentos e noventa minutos sobre quatrocentos e oitenta minutos vezes cem, cerca de oitenta e um por cento. Esse único quociente não diagnostica um transtorno por si só, mas é um resumo padrão em diários de sono e em muitos protocolos de pesquisa porque captura o tempo de cama desperdiçado sem exigir polissonografia.

Metas comuns de coaching costumam visar cerca de oitenta e cinco por cento ou mais ao consolidar uma janela de sono, embora objetivos individuais devam vir de um clínico qualificado. Ela não estima estágios, risco de apneia nem fase circadiana. Minutos são a unidade natural para linhas de diário e exportações de wearables; converta horas em minutos antes de chamar se a sua fonte registrar horas decimais.

Os minutos de vigília devolvidos junto com a eficiência são simplesmente o tempo na cama menos o tempo dormindo, para que você possa mostrar quanto da noite foi passado acordado ainda na cama.

Contrato de entrada, forma da resposta e comportamento de erro

Ambos os valores devem ser estritamente maiores que zero. Campos ausentes, cadeias vazias, NaN, Infinity e valores não positivos também falham com mensagens que nomeiam o campo. Essas falhas de validação não são cobradas.

Exemplo: trezentos e noventa minutos dormindo e quatrocentos e oitenta minutos na cama produzem oitenta e um ponto vinte e cinco por cento de eficiência e noventa minutos de vigília. Combine o número com as suas próprias faixas ou textos de coaching se precisar de cortes clínicos; este extremo calcula apenas o quociente e não emite gráficos de estágios, integração de dispositivos nem conselho médico.

Quem usa a eficiência do sono e para quê

Aplicativos de diário de sono e rastreadores de lição CBT-I precisam de um oráculo determinístico para que cada cliente — celular, web ou importação de planilha — concorde na porcentagem para os mesmos dois contadores de minutos. Plataformas de coaching pontuam em lote diários semanais sem levantar uma pilha completa de analítica do sono.

Assistentes de pesquisa que limpam exportações de actigrafia ou de autorrelato podem chamar um extremo parse minúsculo em vez de reimplementar os casos-limite de tempo na cama zero ou de tempo dormindo maior que o tempo na cama. A falha de validação não consome saldo. Mantenha as requisições pequenas, fixe a porcentagem arredondada nos testes e você terá eficiência do sono reproduzível para diários, módulos LMS e workers de borda sem hospedar uma infraestrutura própria de pontuação.

Casos de uso

Diário de sono e lição de casa CBT-I

Converta os minutos noturnos de tempo dormindo e tempo na cama em uma porcentagem estável de eficiência do sono para planilhas e revisões semanais.

Pesquisa e limpeza de exportações

Valide exportações de actigrafia ou de autorrelato rejeitando linhas impossíveis em que os minutos dormindo superam o tempo na cama.

Perguntas frequentes

Quais unidades devo usar?

Converta primeiro as horas em minutos (por exemplo, 7.5 horas são 450 minutos).

E se o tempo dormindo for maior que o tempo na cama?

A eficiência clássica do sono exige que o tempo total de sono seja menor ou igual ao tempo na cama; valores acima de 100% não são devolvidos.

Isto diagnostica um transtorno do sono?

Não. Apenas calcula o quociente aritmético usado em diários de sono. A interpretação clínica cabe a um profissional qualificado.

Qual porcentagem de eficiência do sono é considerada boa?

Programas de orientação do sono costumam mirar cerca de 85% ou mais ao consolidar a janela de sono. Use isso como referência geral: a sua meta pessoal deve vir de um profissional de saúde qualificado.

O que conta como tempo na cama e como tempo dormindo?

O tempo na cama vai de quando você apaga a luz ou se deita para a noite até quando se levanta de vez. O tempo dormindo é o que sobra depois de descontar quanto demorou para pegar no sono e os despertares.

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

POSThttps://api.kit.forhosting.com/health/sleep-efficiency

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/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)

Exemplo de requisição

{
  "time_asleep": 390,
  "time_in_bed": 480
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "health.sleep_efficiency",
  "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

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

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

Valores inválidos — campos ausentes, durações não positivas ou minutos dormindo maiores que os minutos na cama — falham com um erro invalid_input claro em vez de inventar uma porcentagem acima de cem.

O que a eficiência do sono significa e como a porcentagem é definida

Esta calculadora implementa apenas a definição aritmética: SE é igual a time_asleep sobre time_in_bed vezes cem.

Contrato de entrada, forma da resposta e comportamento de erro

Envie por POST um corpo JSON com dois números finitos obrigatórios em minutos: time_asleep (tempo total de sono) e time_in_bed (tempo na cama desde apagar as luzes ou deitar-se até o levantar final). Cada campo pode chegar como número JSON ou como cadeia numérica; o gerenciador aceita alias como tst, total_sleep_time, asleep_minutes para o tempo de sono e tib, in_bed_minutes, bed_minutes para o tempo na cama. Se time_asleep for maior que time_in_bed, a requisição falha com invalid_input, porque a definição clássica não permite mais sono do que tempo na cama e porcentagens acima de cem por cento enganariam os resumos de diário. No sucesso o corpo ecoa time_asleep e time_in_bed já limpos, wake_minutes como a diferença, sleep_efficiency como a porcentagem arredondada para comparação estável entre ambientes de execução, unit igual a percent, a cadeia de fórmula SE (%) igual a time_asleep sobre time_in_bed vezes cem, e o método sleep_efficiency.

Onde uma API de eficiência do sono justifica o custo

Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.

Casos de integração

Painéis de coaching e bem-estar

Pontue em lote as linhas do diário do cliente com o mesmo quociente que o widget gratuito do navegador usa, sem reimplementar os casos-limite de validação.

Perguntas técnicas

Como a eficiência do sono é calculada?

A eficiência do sono SE (%) = (time_asleep / time_in_bed) × 100. Envie ambos os valores em minutos; a API devolve a porcentagem, os minutos de vigília na cama e a cadeia da fórmula.

Quanto custa a calculadora de eficiência do sono?

A ferramenta do navegador é gratuita. As requisições API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que a eficiência do sono significa e como a porcentagem é definida

Contrato de entrada, forma da resposta e comportamento de erro

Quem usa a eficiência do sono e para quê

Casos de uso

Diário de sono e lição de casa CBT-I

Pesquisa e limpeza de exportações

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

O que a eficiência do sono significa e como a porcentagem é definida

Contrato de entrada, forma da resposta e comportamento de erro

Onde uma API de eficiência do sono justifica o custo

Casos de integração

Painéis de coaching e bem-estar

Perguntas técnicas

obrigado