ForHosting KIT · Datas e tempo

Somar horas a um datetime

Desloque uma data e hora em um número de horas e leia o resultado em UTC: 10:00 UTC de 1º de março de 2024 mais 5 horas dá 15:00 UTC do mesmo dia. Horas negativas e fracionárias também funcionam. 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

Data e hora: 2024-03-01T10:00:00Z
Horas: 5

Você obtém

Resultado: 2024-03-01T15:00:00Z
Ano: 2.024
Mês: 3
Dia: 1

Esta ferramenta aceita um datetime ISO-8601 explícito —hora completa com Z ou deslocamento numérico, ou só data tratada como meia-noite UTC— mais um deslocamento finito de horas que pode ser positivo, negativo, fracionário ou zero. Converte a base em segundos de época UTC com matemática gregoriana pura, soma round(hours × 3600) segundos inteiros e reconstrói um resultado UTC normalizado como ano-mês-dia T hora-minuto-segundo Z. Dias de calendário impossíveis e cadeias malformadas falham com erro de validação claro em vez de enrolar para o mês seguinte.

Como a soma de horas em UTC funciona sem relógio do sistema

Comece com um datetime base explícito escrito na forma internacional ISO para que todo cliente concorde no mesmo ano, mês, dia e campos de relógio opcionais. Quando só uma data de calendário é fornecida, trate-a como meia-noite em Tempo Universal Coordenado. Quando há hora, aceite segundos fracionários opcionais (truncados a segundos inteiros) e uma Z final para UTC ou um deslocamento numérico de horas e minutos com sinal, subtraído ao converter para tempo absoluto.

Valide que o dia civil exista sob as regras de bissexto gregorianas —29 de fevereiro é legal só quando o ano é divisível por quatro, exceto séculos que também devem ser divisíveis por quatrocentos— e que hora, minuto e segundo estejam nos intervalos usuais. Converta o triplo civil em serial de dia com o algoritmo days-from-civil de Howard Hinnant, multiplique por oitenta e quatro mil e seiscentos segundos, some a hora local do dia e subtraia minutos de deslocamento vezes sessenta para obter segundos de época UTC.

Some o deslocamento de horas convertido como round(hours × 3600). Reconstrua a data civil com civil-from-days, separe hora, minuto e segundo do residual de segundos do dia e formate uma cadeia quatro-dois-dois T dois-dois-dois Z.

Onde calculadoras de somar horas a um datetime aparecem no trabalho real

Equipes de operações convertem horários de criação de tickets de suporte em prazos de primeira resposta somando janelas contratuais de horas sem inventar uma biblioteca de calendário completa. Engenheiros de dados materializam colunas de eventos atrasados para pipelines que disparam N horas após um carimbo de ingestão guardado como texto ISO. Gerentes de produto prototipam janelas de trial, prévias de TTL de cache e textos de expiração de sessão com os mesmos números que o backend enviará.

Se mais tarde você precisar de soma de dias de calendário sem relógio, agendas de dias úteis que pulam fins de semana, contagens regressivas entre dois instantes ou conversão pura entre horas e minutos, trate isso como intenções de busca e landings separadas em vez de sobrecarregar esta página de somar horas a um datetime — esses problemas resolvem consultas diferentes mesmo quando parte da aritmética parece similar por baixo.

Casos de uso

SLA e prazos de resposta

Some janelas contratuais de resposta (por exemplo quatro, oito ou vinte e quatro horas) a um carimbo ISO explícito do ticket e armazene um prazo UTC estável.

Colunas de atraso em pipelines

Materialize horários de eventos atrasados como datetime ISO base mais um deslocamento de horas configurado para jobs ETL, caches e retentativas agendadas.

Perguntas frequentes

O que significa somar horas a um datetime?

Significa pegar um carimbo ISO-8601 explícito, convertê-lo a UTC só a partir da string, avançar ou recuar um número finito de horas e devolver o datetime UTC deslocado.

Ele usa o fuso horário local do meu computador?

Não. Toda a matemática é UTC derivada apenas da string de entrada. Deslocamentos numéricos no input são aplicados uma vez ao converter para tempo absoluto; o resultado sempre é emitido com um Z final.

Posso usar horas fracionárias?

Sim. Valores como 1.5 tornam-se round(1.5 × 3600) = 5400 segundos inteiros. Valores não finitos e magnitudes absurdas são rejeitados.

Quais formatos de datetime são aceitos?

Só data YYYY-MM-DD (meia-noite UTC), ou datetime completo com segundos e fração opcionais, terminando em Z ou deslocamento numérico ±HH:mm. Formas soltas sem larguras de dígito fixas são rejeitadas.

Quanto custa?

A ferramenta no navegador é gratuita e roda localmente.

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/date/add-hours

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/date/add-hours \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2024-03-01T10:00:00Z","hours":5}'

const res = await fetch("https://api.kit.forhosting.com/date/add-hours", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2024-03-01T10:00:00Z",
    "hours": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/add-hours",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2024-03-01T10:00:00Z",
    "hours": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/add-hours", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2024-03-01T10:00:00Z","hours":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2024-03-01T10:00:00Z","hours":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/add-hours", 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

{
  "datetime": "2024-03-01T10:00:00Z",
  "hours": 5
}

Exemplo de resposta

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

Deslocar um carimbo de tempo por um número fixo de horas é tarefa diária em API, agendadores de jobs, relógios de SLA e importações de planilhas; ainda assim, fusos do host e horário de verão transformam uma soma aparentemente trivial em fonte de testes instáveis.

O que você envia e o que recebe de volta

Verificações clássicas incluem somar cinco horas às dez UTC para chegar às quinze no mesmo dia, somar vinte e quatro horas para cruzar um dia de calendário, subtrair três horas de um carimbo matinal, converter uma entrada com deslocamento mais-zero-dois em resultado puro Z após o cálculo, e rejeitar uma base como 29 de fevereiro em ano comum. Envie dois campos obrigatórios: datetime como string ISO-8601, por exemplo dois mil e vinte e quatro hífen zero três hífen zero um T dez dois-pontos zero zero dois-pontos zero zero Z, e hours como número finito como cinco, zero, menos três ou um ponto cinco. Os aliases date, dt, timestamp e ts são aceitos para a string base. Campos ausentes, datetime que não seja string, cadeias que não sigam a forma ISO, deslocamentos de horas não finitos, dias de calendário impossíveis e anos de resultado fora da faixa falham com invalid_input e não são cobrados. Em sucesso, a resposta ecoa o datetime base aparado, o deslocamento hours aplicado, a string ISO UTC resultante após a soma, o ano, mês, dia, hora, minuto e segundo numéricos do resultado, o epoch_seconds do resultado, o inteiro delta_seconds adicionado, hours_added e uma fórmula curta que documenta a reconstrução UTC. O preço de chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.

Onde calculadoras de somar horas a um datetime aparecem no trabalho real

Como a capacidade é um motor parse puro, o preço da API é a base publicada de US$ 0,002 por item bem-sucedido e validação falha não consome saldo.

Casos de integração

Fixtures de QA em torno da meia-noite

Gere carimbos de tempo esperados determinísticos que cruzam limites de dia e bissexto em testes de regressão sem depender do relógio do host.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Como a soma de horas em UTC funciona sem relógio do sistema

Onde calculadoras de somar horas a um datetime aparecem no trabalho real

Casos de uso

SLA e prazos de resposta

Colunas de atraso em pipelines

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 você envia e o que recebe de volta

Onde calculadoras de somar horas a um datetime aparecem no trabalho real

Casos de integração

Fixtures de QA em torno da meia-noite

obrigado