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.
Lancer gratuitement
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.
Cas d’usage
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.
Questions fréquentes
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.
Pour les développeurs — accès API
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.
Endpoint
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é.
Appeler depuis votre stack
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}'const res = await fetch("https://api.kit.forhosting.com/date/add-minutes", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"datetime": "2026-07-25T23:45:30Z",
"minutes": 30
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/add-minutes",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"datetime": "2026-07-25T23:45:30Z",
"minutes": 30
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/add-minutes", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"datetime":"2026-07-25T23:45:30Z","minutes":30}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"datetime":"2026-07-25T23:45:30Z","minutes":30}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/add-minutes", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"datetime": "2026-07-25T23:45:30Z",
"minutes": 30
}Exemple de réponse
{
"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.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |