ForHosting KIT · Outils pour développeurs

Soustraire des minutes à une date et heure

Ce calculateur recule une date-heure ISO 8601 explicite du nombre de minutes indiqué et renvoie une valeur unique normalisée en UTC.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il accepte un Z final ou un décalage UTC numérique : le calcul désigne donc un instant précis sans dépendre du fuseau local de l’ordinateur. Secondes, millisecondes, fractions de minute et changements de jour, de mois, d’année ou d’année bissextile sont traités de façon déterministe. L’heure actuelle n’est jamais consultée, si bien qu’une même entrée produit toujours la même sortie.

Saisissez un instant accompagné de son fuseau horaire

Commencez par une date-heure ISO 8601 désignant un instant réel, par exemple 2026-07-25T12:30:00Z, ou par une valeur terminée par un décalage tel que +05:30. L’indication du fuseau est obligatoire, car une heure seule reste ambiguë : midi à Londres et midi à Tokyo ne correspondent pas au même instant. Le calculateur valide toute la date, notamment le nombre de jours de chaque mois et les règles des années bissextiles. Il vérifie aussi les heures, minutes, secondes, millisecondes et le décalage numérique. Vous pouvez omettre les secondes lorsqu’elles valent zéro, mais la valeur renvoyée présente toujours une écriture UTC complète. Indiquez dans le champ prévu le nombre de minutes à soustraire. Les entiers conviennent aux horaires habituels, tandis qu’une valeur comme 1.5 représente quatre-vingt-dix secondes. Une quantité négative est également admise et avance alors l’instant. Les deux champs sont obligatoires et le nombre de minutes doit être fini.

Comprenez le calcul UTC et la valeur renvoyée

Le décalage saisi est d’abord appliqué afin de convertir la date-heure en un instant UTC. L’algorithme soustrait ensuite la durée exacte, puis reconstruit la date du calendrier grégorien. Cet ordre est important lorsque la source possède un décalage non nul. Ainsi, une heure peu après minuit assortie d’un décalage positif peut déjà appartenir au jour UTC précédent avant toute soustraction. Le résultat se termine par Z, signe de l’UTC, et comporte toujours les secondes et trois chiffres de millisecondes. Cette normalisation simplifie la comparaison, le stockage, le tri et la transmission à une autre API, sans conserver plusieurs écritures équivalentes. Le calcul franchit automatiquement les limites d’heure, de jour, de mois, d’année bissextile et d’année. Il n’applique aucune règle d’heure d’été et ne devine aucun fuseau nommé, puisque le décalage explicite définit déjà l’instant. Il ne consulte ni l’horloge actuelle ni le fuseau de la machine hôte.

Exploitez le résultat de manière sûre

Utilisez cette capacité si votre système possède déjà un horodatage et doit déterminer une échéance, un rappel, une limite, un début de fenêtre ou une position de journal antérieurs. Envoyez la date-heure initiale et la durée à retirer, puis utilisez le champ datetime renvoyé comme résultat normalisé. Veillez à distinguer les minutes écoulées des opérations calendaires. Soustraire 1,440 minutes retire exactement vingt-quatre heures ; cela ne signifie pas conserver la même heure locale la veille lors d’un changement d’heure. Si ce comportement est nécessaire, résolvez auparavant le fuseau nommé et ses règles. Les valeurs impossibles, comme le 30 février ou l’heure 25, provoquent une erreur de saisie au lieu d’être corrigées silencieusement. Les décalages démesurés et les précisions inférieures à la milliseconde sont aussi refusés. L’outil du navigateur convient aux calculs ponctuels ; les appels automatisés coûtent $0.002 par requête et s’intègrent aux traitements de planification et de normalisation.

Calculer l’heure d’un rappel

Reculez un horodatage d’un délai fixe et conservez l’instant UTC obtenu pour déclencher le rappel.

Définir une limite de traitement

Soustrayez des minutes à une échéance pour savoir quand un flux automatisé doit cesser d’accepter du travail.

Normaliser des horodatages décalés

Convertissez en UTC des dates assorties d’un décalage tout en appliquant un ajustement reproductible aux données.

Le calcul utilise-t-il l’heure actuelle ?

Non. Il repose uniquement sur la date-heure et le nombre de minutes fournis ; des entrées identiques donnent donc toujours le même résultat.

Quels formats de fuseau horaire sont acceptés ?

Utilisez Z pour l’UTC ou un décalage numérique explicite tel que +05:30 ou -04:00. Une date sans indication de fuseau est refusée car elle est ambiguë.

Puis-je soustraire des fractions de minute ?

Oui. Les fractions correspondant exactement à un nombre entier de millisecondes sont admises ; 1.5 minute retire par exemple quatre-vingt-dix secondes.

Sous quel format le résultat est-il renvoyé ?

Le résultat est une date-heure ISO normalisée en UTC, terminée par Z et comprenant les secondes ainsi que trois chiffres de millisecondes.

Combien coûte une requête API ?

Chaque requête API coûte $0.002. Vous pouvez aussi exécuter le même calcul déterministe dans le navigateur.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

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

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

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}'
{
  "datetime": "2026-07-25T12:30:00Z",
  "minutes": 45
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.subtract_minutes",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →