ForHosting KIT · Ferramentas para dev

Subtrair minutos de uma data e hora

Esta calculadora desloca para trás uma data e hora ISO 8601 explícita pelo número de minutos informado e retorna um único valor normalizado em UTC.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Ela aceita Z no final ou um deslocamento UTC numérico, portanto o cálculo representa um instante e não depende do fuso horário local do computador. Segundos, milissegundos, minutos fracionários e mudanças de dia, mês, ano ou ano bissexto são tratados de forma determinística. O relógio atual nunca é consultado, e a mesma entrada sempre gera a mesma saída.

Informe um instante com o respectivo fuso horário

Comece com uma data e hora ISO 8601 que identifique um instante real, como 2026-07-25T12:30:00Z, ou com um valor terminado em um deslocamento como +05:30. O indicador de fuso é obrigatório porque um horário sem ele é ambíguo: meio-dia em Londres e meio-dia em Tóquio não representam o mesmo momento. A calculadora valida a data completa, inclusive a quantidade de dias de cada mês e as regras dos anos bissextos. Também verifica horas, minutos, segundos, milissegundos e o deslocamento numérico. Você pode omitir os segundos quando forem zero, mas o valor retornado sempre apresenta uma representação UTC completa. Digite no campo de minutos a quantidade a subtrair. Números inteiros atendem ao planejamento habitual; um decimal como 1.5 representa noventa segundos. Valores negativos também são aceitos e, na prática, movem o instante para a frente. Os dois campos são obrigatórios, e a quantidade de minutos deve ser um número finito.

Entenda o cálculo UTC e o formato da saída

Primeiro, o deslocamento informado é aplicado para converter a data e hora em um instante UTC. Em seguida, o algoritmo subtrai a duração exata e reconstrói a data no calendário gregoriano. Essa ordem faz diferença quando a origem usa um deslocamento diferente de zero. Por exemplo, um horário logo após a meia-noite com deslocamento positivo pode já pertencer ao dia UTC anterior antes mesmo da subtração. O resultado termina em Z, que indica UTC, e sempre inclui segundos e três dígitos de milissegundos. A normalização facilita comparar, armazenar, ordenar ou enviar valores para outra API sem manter grafias equivalentes de deslocamento. A operação atravessa automaticamente limites de hora, dia, mês, ano bissexto e ano. Ela não aplica horário de verão nem tenta descobrir um fuso por nome, pois o deslocamento explícito já define o instante. Além disso, não consulta o relógio atual nem o fuso da máquina, mantendo toda solicitação reproduzível.

Use o resultado com segurança em aplicações

Use esta capacidade quando seu sistema já tiver um carimbo de data e hora e precisar obter um prazo, lembrete, limite, início de janela ou ponto de log anterior. Envie a data e hora originais e a duração que deve ser removida; depois, consuma o campo datetime retornado como resultado normalizado. Preserve a diferença entre minutos decorridos e operações de calendário. Subtrair 1,440 minutos remove exatamente vinte e quatro horas; isso não significa manter o mesmo horário local do dia anterior durante uma mudança de horário de verão. Se esse comportamento for necessário, resolva previamente o fuso por nome e suas regras. Entradas impossíveis, como 30 de fevereiro ou hora 25, geram erros em vez de correções silenciosas. Deslocamentos enormes e precisão inferior a um milissegundo também são recusados. A ferramenta no navegador atende a cálculos pontuais; chamadas automatizadas custam US$ 0,002 por solicitação e funcionam bem em rotinas de agendamento, limpeza e normalização.

Casos de uso

Calcular o horário de um lembrete

Antecipe um carimbo de data e hora por um intervalo fixo e armazene o instante UTC resultante para o aviso.

Definir um limite de processamento

Subtraia minutos de um prazo para determinar quando um fluxo automatizado deve parar de aceitar trabalho.

Normalizar horários ajustados

Converta datas com deslocamento para UTC enquanto aplica um ajuste reproduzível na preparação dos dados.

Perguntas frequentes

O cálculo usa o horário atual?

Não. Ele usa somente a data e hora e a quantidade de minutos fornecidas, portanto entradas idênticas sempre produzem o mesmo resultado.

Quais formatos de fuso horário são aceitos?

Use Z para UTC ou um deslocamento numérico explícito, como +05:30 ou -04:00. Datas sem indicador de fuso são recusadas por serem ambíguas.

É possível subtrair minutos fracionários?

Sim. São aceitas frações que correspondam exatamente a milissegundos inteiros; por exemplo, 1.5 minuto subtrai noventa segundos.

Qual é o formato do resultado?

O resultado é uma data e hora ISO normalizada em UTC, terminada em Z e com segundos e três dígitos de milissegundos.

Quanto custa uma solicitação de API?

Cada solicitação de API custa US$ 0,002. O mesmo cálculo determinístico também pode ser executado no navegador.

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/subtract-minutes

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/subtract-minutes \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-07-25T12:30:00Z","minutes":45}'

const res = await fetch("https://api.kit.forhosting.com/date/subtract-minutes", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2026-07-25T12:30:00Z",
    "minutes": 45
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/subtract-minutes",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2026-07-25T12:30:00Z",
    "minutes": 45
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/subtract-minutes", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2026-07-25T12:30:00Z","minutes":45}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2026-07-25T12:30:00Z","minutes":45}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/subtract-minutes", 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": "2026-07-25T12:30:00Z",
  "minutes": 45
}

Exemplo de resposta

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

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.

Ver a documentação completa do KIT →