ForHosting KIT · Outils pour développeurs

Ajouter des minutes à une date et heure

Ajoutez des minutes à une date et une heure lorsqu’un planning, un journal, une expiration, un transfert ou un scénario de test exige un instant décalé avec précision.

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

Indiquez une date-heure ISO complète avec Z ou un décalage horaire numérique, ainsi qu’un nombre entier de minutes positif, négatif ou nul. Le calculateur valide le calendrier et le décalage, convertit l’instant indiqué en UTC, effectue une arithmétique déterministe et renvoie une date-heure UTC canonique. Il ne consulte jamais l’heure actuelle, ne devine aucun fuseau et ne dépend pas de la machine d’exécution.

Fournissez un instant initial complet et sans ambiguïté

Saisissez la valeur initiale sous forme de date-heure ISO comprenant une date calendaire, le séparateur T, les heures, les minutes, les secondes et un indicateur explicite de fuseau. Une valeur terminée par Z représente déjà UTC. Une valeur terminée par un décalage tel que +02:00 ou -05:30 décrit les champs de l’heure locale et leur différence exacte par rapport à UTC. Ce suffixe obligatoire évite une cause fréquente d’erreurs de planification : une heure locale isolée dont le sens varie selon l’ordinateur, le navigateur ou le serveur qui l’analyse. La partie calendaire est contrôlée selon les règles grégoriennes des années bissextiles et de la longueur des mois ; les dates impossibles sont donc refusées au lieu d’être normalisées silencieusement. Les heures vont de 00 à 23, et les minutes et secondes de 00 à 59. Les fractions de seconde facultatives peuvent comporter un à trois chiffres. Les noms tels que Europe/London ne sont pas acceptés, car ils nécessitent des règles historiques et peuvent rendre l’heure d’été ambiguë. Utilisez plutôt un décalage qui désigne explicitement l’instant voulu.

Comprenez l’ajout de minutes et la conversion UTC

L’opération interprète d’abord la date, l’heure et le décalage numérique fournis comme un seul instant absolu. Elle convertit cet instant en UTC par arithmétique calendaire, puis ajoute le nombre signé de minutes entières demandé. Une valeur positive avance, une valeur négative recule et zéro effectue uniquement la normalisation UTC. Les retenues franchissent toutes les limites : heure, jour, mois, jour bissextile, année ou siècle ; la soustraction les traverse en sens inverse. Le résultat se termine toujours par Z, ce qui rend son fuseau explicite et cohérent pour le stockage ou la comparaison. Les secondes et leurs fractions restent inchangées puisque le décalage ajouté est un multiple exact d’une minute. L’implémentation n’appelle pas le constructeur Date de JavaScript et ne consulte aucune horloge système. Elle compte les jours grégoriens, applique le décalage et les minutes sous forme d’entiers, puis reconstruit les champs UTC. La même entrée donne ainsi la même sortie dans un navigateur, un worker, un test automatisé ou un serveur, quels que soient les paramètres régionaux et le fuseau de l’hôte.

Exploitez le résultat sans risque en automatisation et en test

Cette capacité convient aux processus qui connaissent déjà leur instant initial et ont besoin d’un horodatage dérivé reproductible. Vous pouvez, par exemple, créer un rappel trente minutes après un événement, calculer l’échéance d’un délai de grâce fixe, convertir en UTC des enregistrements importés avec leur décalage déclaré ou construire des scénarios autour de minuit et des jours bissextiles. L’objet renvoyé contient la date-heure originale élaguée, le nombre entier normalisé de minutes, le résultat décalé et une mention UTC explicite. Enregistrez ou comparez le champ de résultat lorsqu’un autre système attend un horodatage canonique. Il s’agit d’arithmétique de minutes écoulées, et non de planification civile selon une région nommée. Ajouter soixante minutes ajoute toujours exactement 3,600 secondes, sans consulter les changements d’heure ni les calendriers ouvrés. Si un rendez-vous doit conserver la même heure murale après un changement régional, déterminez auparavant la région et le décalage voulus. Une entrée incorrecte renvoie une erreur typée. L’exécution par API coûte $0.002 par élément et le navigateur emploie le même calcul pur.

Fixer une expiration précise

Ajoutez un délai de grâce fixe à l’horodatage d’un jeton, d’une réservation ou d’un dépôt, puis stockez l’échéance UTC.

Normaliser les horodatages décalés

Appliquez zéro minute à une date-heure avec décalage afin d’obtenir sa représentation UTC canonique équivalente.

Construire des tests aux limites

Générez des cas déterministes qui franchissent minuit, une fin de mois, un jour bissextile ou une fin d’année sans lire l’horloge.

Quel est le prix d’un appel API ?

Chaque élément coûte $0.002. La version navigateur exécute localement le même calcul déterministe.

La date ou l’heure actuelle est-elle utilisée ?

Non. Seules la date-heure explicite et la quantité de minutes fournies dans la requête sont utilisées.

Les nombres de minutes négatifs sont-ils acceptés ?

Oui. Un entier négatif soustrait des minutes écoulées, tandis que zéro normalise seulement l’instant en UTC.

Pourquoi faut-il inclure Z ou un décalage numérique ?

Sans cette indication, une heure locale ne désigne pas un instant unique et peut varier selon le fuseau de l’hôte.

Le changement d’heure est-il géré ?

Le décalage numérique explicite est respecté, mais aucune règle régionale n’est déduite d’un nom de fuseau.

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/add-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/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"
  }
}

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 →