ForHosting KIT · Ferramentas para dev

Adicionar minutos a uma data e hora

Adicione minutos a uma data e hora quando uma agenda, registro, expiração, transferência ou teste exigir um instante deslocado exato.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe uma data e hora ISO completa com Z ou deslocamento numérico de fuso, além de uma quantidade inteira de minutos positiva, negativa ou zero. A calculadora valida o calendário e o deslocamento, converte o instante informado para UTC, executa aritmética determinística e devolve uma data e hora UTC canônica. Ela nunca consulta o horário atual, presume um fuso, usa dados de rede ou depende da máquina em que é executada.

Informe um instante inicial completo e inequívoco

Digite o valor inicial como uma data e hora ISO que contenha data do calendário, separador T, horas, minutos, segundos e um indicador explícito de fuso. Um valor terminado em Z já representa UTC. Um valor terminado em um deslocamento como +02:00 ou -05:30 descreve os campos do relógio local e sua diferença exata em relação a UTC. Exigir esse sufixo evita uma fonte comum de erros de agenda: um horário local isolado cujo significado muda conforme o computador, navegador ou servidor que o interpreta. A parte do calendário é validada pelas regras gregorianas de ano bissexto e duração dos meses, portanto datas impossíveis são recusadas em vez de normalizadas silenciosamente. As horas devem ficar entre 00 e 23; minutos e segundos, entre 00 e 59. Frações opcionais de segundo podem ter de um a três dígitos. A capacidade não aceita nomes como Europe/London, pois eles exigem regras históricas e podem gerar ambiguidade de horário de verão. Use um deslocamento que identifique explicitamente o instante pretendido.

Entenda a soma de minutos e a conversão para UTC

A operação interpreta primeiro a data, o horário e o deslocamento numérico fornecidos como um único instante absoluto. Ela converte esse instante para UTC por aritmética de calendário e depois adiciona a quantidade solicitada de minutos inteiros com sinal. Números positivos avançam, negativos retrocedem e zero apenas normaliza para UTC. O transporte atravessa qualquer limite: próxima hora, dia, mês, dia bissexto, ano ou século, e a subtração percorre os mesmos limites ao contrário. O resultado sempre termina em Z, deixando o fuso explícito e uniforme para armazenamento ou comparação. Segundos e frações não mudam porque o valor adicionado é múltiplo exato de um minuto. A implementação não chama o construtor Date do JavaScript nem consulta o relógio do sistema. Ela conta dias gregorianos, aplica deslocamento e minutos como inteiros e reconstrói os campos UTC. Assim, a mesma entrada produz a mesma saída no navegador, worker, teste automatizado ou servidor, independentemente da localidade e do fuso da máquina hospedeira.

Use o resultado com segurança em automações e testes

Esta capacidade atende fluxos que já conhecem o instante inicial e precisam de um timestamp derivado reproduzível. Por exemplo, você pode criar um lembrete trinta minutos após um evento, calcular um prazo fixo de tolerância, converter registros importados de seus deslocamentos declarados para UTC ou montar testes perto da meia-noite e de dias bissextos. O objeto devolvido inclui a data e hora original sem espaços externos, a quantidade inteira normalizada, o resultado deslocado e uma indicação UTC explícita. Armazene ou compare o campo de resultado quando outro sistema exigir um timestamp canônico. Lembre-se de que esta é uma aritmética de minutos decorridos, não um agendamento civil por região. Adicionar sessenta minutos soma sempre exatamente 3,600 segundos; não consulta transições de horário de verão nem calendários comerciais. Se um compromisso precisar manter o mesmo horário de parede após uma mudança regional, determine antes a região e o deslocamento pretendido. Entrada inválida retorna erro tipado, permitindo corrigir a solicitação. A execução via API custa US$ 0,002 por item, e o navegador usa o mesmo cálculo puro.

Definir uma expiração exata

Adicione um período fixo de tolerância ao timestamp de um token, reserva ou envio e armazene o prazo UTC resultante.

Normalizar timestamps com deslocamento

Desloque em zero minuto uma data e hora com offset para obter sua representação UTC canônica equivalente.

Criar testes de limites

Gere casos determinísticos que atravessem meia-noite, fim do mês, dia bissexto ou fim do ano sem consultar o relógio atual.

Quanto custa uma chamada de API?

Cada item custa US$ 0,002. A versão no navegador executa localmente o mesmo cálculo determinístico.

A data ou o horário atual é usado?

Não. Somente a data e hora explícita e a quantidade de minutos enviadas na solicitação são usadas.

Valores negativos de minutos são aceitos?

Sim. Um inteiro negativo subtrai minutos decorridos, enquanto zero apenas normaliza o instante para UTC.

Por que a data e hora deve incluir Z ou um deslocamento?

Sem isso, um horário local não identifica um instante único e pode variar conforme o fuso do ambiente.

O horário de verão é considerado?

O deslocamento numérico explícito é respeitado, mas regras regionais não são inferidas de nomes de fuso.

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.

POSThttps://api.kit.forhosting.com/date/add-minutes

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/date/add-minutes \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-07-25T23:45:30Z","minutes":30}'
{
  "datetime": "2026-07-25T23:45:30Z",
  "minutes": 30
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.add_minutes",
  "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.

por chamadaUS$ 0,002

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

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →