Noites e dias de viagem
Com check-in na sexta, 12 de julho de 2024, e check-out na segunda, dia 15, você paga 3 noites e a viagem cobre 4 dias. Informe as duas datas e receba as noites para a conta do hotel e os dias para aluguéis e passes. 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
- Check-in
- 2024-07-12
- Check-out
- 2024-07-15
- Noites
- 3
- Dias
- 4
- Estadia
- 3 nights / 4 days
- Ano de entrada
- 2.024
Esta calculadora de noites e dias de viagem transforma a data de check-in do hotel e a data de check-out nos dois números que os mecanismos de reserva realmente usam: as noites que você paga e os dias de calendário que a estadia cobre. Hotéis cobram por noite, então uma chegada na sexta e uma partida na segunda são três noites mesmo que você ocupe quatro dias de calendário — sexta, sábado, domingo e segunda. O mecanismo valida as duas datas como dias gregorianos reais, converte cada uma em uma contagem serial sem o relógio do host, subtrai o check-out menos o check-in para as noites e soma um para os dias.
O que significam noites de hotel e dias de viagem, e o que a resposta contém
Noites de hotel e dias de calendário respondem a duas perguntas de planejamento diferentes que as pessoas costumam comprimir em uma só. Noites são a unidade de cobrança: cada noite em que você dorme no quarto, da tarde do check-in até a manhã do check-out, é um lançamento na fatura. Dias são o intervalo inclusivo de calendário da viagem: o dia da semana do check-in mais cada dia de calendário até incluir o dia do check-out.
Por isso um fim de semana clássico de check-in na sexta e check-out no domingo são duas noites e três dias, e por isso a sexta doze de julho de dois mil e vinte e quatro até a segunda quinze são três noites e quatro dias. Aluguéis de carro, planos de refeição, passes de cidade e pedidos de folga costumam seguir a contagem de dias, enquanto a fatura do hotel segue a contagem de noites, então um único número não basta para orçar.
Esta calculadora devolve os dois, mais um rótulo curto de estadia como três noites barra quatro dias, as strings normalizadas de check-in e check-out, os campos de ano, mês e dia para encadear em outras ferramentas, e um lembrete da fórmula. Check-in e check-out no mesmo dia é uma estadia diurna válida de zero noites e um dia, alinhada a salas de conferência e quartos de dia.
Como o check-in e o check-out são lidos, e como a contagem permanece reproduzível
Cada string deve coincidir com quatro dígitos, um hífen, dois dígitos, outro hífen e dois dígitos; espaços no início ou no fim são recortados, mas nomes de mês, barras, o dia ordinal do ano sozinho e horários embutidos não são expandidos aqui.
Depois da análise, cada ano deve ficar entre um e nove mil novecentos e noventa e nove, cada mês entre um e doze, e cada dia entre um e o comprimento verdadeiro daquele mês naquele ano, com anos bissextos seguindo a regra gregoriana de divisível por quatro exceto anos seculares não divisíveis por quatrocentos.
Cruzar 29 de fevereiro em um ano bissexto é contado corretamente: 28 de fevereiro de dois mil e vinte e quatro até 1 de março são duas noites e três dias, enquanto o mesmo par em um ano comum é rejeitado se você inventar um dia 29. Cruzar um limite de ano, como a véspera de Ano-Novo até 2 de janeiro, é uma subtração inteira igualmente ordinária.
Onde a aritmética da duração da estadia cabe em reservas, orçamentos e software
Viajantes encontram este cálculo quando um anúncio mostra uma diária e eles precisam do total da fatura antes de tocar em reservar: noites vezes a tarifa anunciada é a linha do quarto, enquanto dias vezes uma estimativa diária de refeição ou estacionamento preenche o restante do orçamento da viagem.
Famílias que comparam uma escapada de quinta a domingo com uma de sexta a segunda veem tanto a noite extra quanto o dia de calendário extra, o que importa quando um passe de museu é vendido por dia de calendário e o hotel é vendido por noite. Gestores de propriedade, gestores de canal e mecanismos de reserva chamam o mesmo contrato a partir de scripts para que um formulário que só coletou duas datas ISO nunca discorde do e-mail de confirmação sobre quantas noites foram reservadas.
Ferramentas de finanças e despesas usam noites como multiplicador da hospedagem e dias como multiplicador das diárias de alimentação, alinhadas a muitas políticas corporativas de viagem. Professores e consultores de finanças pessoais usam o exemplo de sexta a segunda para mostrar por que subtrair duas datas em uma planilha e chamar o resultado de «dias da viagem» subconta em um o intervalo de calendário.
Combine-a com ajudantes de custo total de viagem quando você já souber a hospedagem por noite e a comida diária, e com outras ferramentas de viagem determinísticas e gratuitas quando estiver montando um pequeno laboratório de calculadoras de estadia, custo e roteiro.
Casos de uso
Cotação de hotel antes de reservar
Transforme um par de check-in e check-out em noites cobradas para que a diária vezes as noites bata com a fatura, e em dias para que refeições e passes cubram cada dia de calendário da estadia.
Planejamento de estadias de fim de semana e feriado
Compare sexta a domingo com sexta a segunda (ou um fim de semana bissexto que cruza 29 de fevereiro) sem erros de um a mais ou a menos entre noites cobradas e dias no destino.
Perguntas frequentes
Quantas noites tem uma estadia de hotel do check-in ao check-out?
As noites equivalem aos dias de calendário inteiros do check-in ao check-out (serial do check-out menos serial do check-in). Sexta a segunda são três noites. Os dias equivalem às noites mais um, então essa estadia são quatro dias de calendário.
Por que noites e dias são números diferentes?
Hotéis cobram as noites em que você dorme no quarto. A viagem ainda ocupa o dia da chegada e o dia da partida no calendário. Um fim de semana de duas noites são três dias no destino; uma estadia no mesmo dia são zero noites e um dia.
E se o check-out for anterior ao check-in?
Uma estadia de hotel não pode ter contagem negativa de noites; troque as datas ou corrija o par. Dias de calendário inválidos como 2023-02-29 são rejeitados da mesma forma.
A calculadora trata anos bissextos e viradas de ano?
Sim. As duas datas são validadas como dias gregorianos reais, incluindo 29 de fevereiro somente em anos bissextos. Cruzar 31 de dezembro para janeiro é uma subtração serial ordinária. Horários do dia e fusos horários não são interpretados.
Posso fazer check-in e check-out no mesmo dia?
Sim. Entrar e sair na mesma data é uma estadia de uso diurno: zero noites e um dia, do mesmo jeito que se vendem quartos de day use e salas de reunião.
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/travel/trip-nights-days \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"check_in":"2024-07-12","check_out":"2024-07-15"}'const res = await fetch("https://api.kit.forhosting.com/travel/trip-nights-days", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"check_in": "2024-07-12",
"check_out": "2024-07-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/travel/trip-nights-days",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"check_in": "2024-07-12",
"check_out": "2024-07-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/trip-nights-days", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"check_in":"2024-07-12","check_out":"2024-07-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"check_in":"2024-07-12","check_out":"2024-07-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/trip-nights-days", 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
{
"check_in": "2024-07-12",
"check_out": "2024-07-15"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.trip_nights_days",
"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
year_min | 1 |
year_max | 9999 |
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
Check-out no mesmo dia é uma estadia de uso diurno de zero noites e um dia; um check-out anterior ao check-in é rejeitado com invalid_input. Use-a gratuitamente no navegador para orçamentos de fim de semana e de viagem, ou chame a API a US$ 0,002 por solicitação bem-sucedida quando um formulário de reserva, um montador de roteiros ou uma suíte de testes precisar de uma duração de estadia reproduzível.
O que significam noites de hotel e dias de viagem, e o que a resposta contém
Uma data de check-out anterior ao check-in não é uma estadia: a solicitação falha com invalid_input em vez de inventar uma contagem negativa de noites que quebraria o produto tarifa vezes noites.
Como o check-in e o check-out são lidos, e como a contagem permanece reproduzível
O primeiro campo preferido é check_in, mas os aliases checkin, start, from, arrival e arrive são aceitos para que formulários de reserva, planilhas e query strings reutilizem o mesmo contrato sem renomear colunas. O segundo campo preferido é check_out, com os aliases checkout, end, to, departure e depart pela mesma razão. Internamente o mecanismo converte cada tripla civil em uma contagem serial gregoriana proléptica usando o mapeamento conhecido days_from_civil, subtrai o serial do check-in do serial do check-out para obter as noites e soma um para os dias — aritmética inteira pura, estável bit a bit entre runtimes.
Onde a aritmética da duração da estadia cabe em reservas, orçamentos e software
Nesta página o trabalho roda inteiramente no seu navegador; pela API cada consulta bem-sucedida custa US$ 0,002, a validação com falha não é cobrada e nada é armazenado depois que a resposta retorna. Essa divisão — exploração interativa gratuita e uma API cobrada idêntica — combina com o restante do catálogo KIT de nível A e permite passar de uma verificação pontual de fim de semana a um fluxo de reservas sem mudar o resultado matemático.
Casos de integração
Formulários de reserva e fixtures de teste
Dê a montadores de roteiro e suítes de CI um contrato determinístico de noites e dias que rejeita check-out antes do check-in e nunca depende do relógio do host.
Perguntas técnicas
Quanto custa a calculadora de noites e dias de viagem?
A ferramenta do navegador é gratuita. Solicitações à API usam saldo pré-pago do KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.