ForHosting KIT · Dates et temps

Ajouter des jours à une date

Ajoutez ou retirez des jours calendaires à une date et obtenez la date exacte qui en résulte : le 1er mars 2024 plus 10 jours donne le 11 mars 2024. Les années bissextiles et la durée de chaque mois sont prises en compte. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Date: 2024-03-01
Jours à ajouter: 10

Vous obtenez

Date obtenue: 2024-03-11
Année: 2 024
Mois: 3
Jour: 11

Ajouter un nombre fixe de jours calendaires à une date semble trivial jusqu’à ce que les années bissextiles, les longueurs de mois et les chaînes de base invalides entrent en jeu. Les chefs de projet planifient des relances trente jours après un lancement, les équipes financières calculent les échéances de facture, les bureaux d’assistance promettent une réponse sous sept jours et les pipelines de données décalent des horodatages d’événements par des décalages stockés en purs comptages de jours. Cet outil accepte une date de base ISO stricte sous forme année-mois-jour plus un décalage entier de jours positif, négatif ou nul, vérifie que le jour de base existe bien sur le calendrier grégorien — y compris les févriers bissextiles — et renvoie la date civile résultante sans jamais consulter l’horloge hôte ni un objet Date JavaScript. Les bases impossibles, comme le vingt-neuf février d’une année commune, échouent avec une erreur de validation claire au lieu de basculer en mars.

Comment l’addition de jours calendaires fonctionne sans horloge

Parte d’une date calendaire de base écrite en année, mois et jour selon la forme ISO internationale avec tirets et largeurs fixes afin que chaque client s’accorde sur les trois mêmes entiers. Vérifiez que l’année se situe dans une plage grégorienne pratique, que le mois est entre un et douze, et que le jour existe pour ce mois selon les règles bissextiles grégoriennes : une année est bissextile lorsqu’elle est divisible par quatre, sauf que les années séculaires ne le sont que si elles sont aussi divisibles par quatre cents.

Cette règle rend le vingt-neuf février légal en deux mille vingt-quatre et deux mille, et illégal en deux mille vingt-trois et mille neuf cents. Lorsque le triplet est valide, convertissez-le en ordinal de jour de l’année en sommant les longueurs des mois complets précédents et en ajoutant le jour du mois. Ajoutez le décalage entier à cet ordinal.

Tant que le total dépasse la longueur de l’année en cours, soustrayez cette longueur et avancez l’année ; tant qu’il tombe sous un, reculez l’année et ajoutez la longueur de l’année précédente. Enfin convertissez l’ordinal stabilisé en mois et jour et formatez le résultat en chaîne ISO quatre-deux-deux.

Où les calculateurs d’ajout de jours interviennent au travail

Les systèmes de facturation calculent les dates d’échéance comme date de facture plus trente jours nets calendaires sans charger une bibliothèque complète de planification. Les outils de succès client fixent des rappels sept ou quatorze jours après un événement d’onboarding. Les équipes juridiques et de conformité suivent des délais de préavis mesurés en jours calendaires plutôt qu’en jours ouvrés.

Les ingénieurs de données matérialisent des colonnes dérivées pour les fenêtres de rétention, les fins d’essai et les fins de campagne à partir d’une seule base ISO plus un décalage entier stocké en configuration.

Si vous avez ensuite besoin de comptages de jours ouvrés qui sautent week-ends et jours fériés, de la différence en jours entre deux dates, de l’âge à partir d’une naissance ou des seuls ordinaux de jour de l’année, traitez-les comme des intentions de recherche et des pages distinctes plutôt que de surcharger cette page d’ajout de jours à une date.

Cas d’usage

Échéances de factures et d’abonnements

Ajoutez quinze ou trente jours nets calendaires à une date ISO de facture pour produire une échéance stable d’un fuseau et d’un hôte à l’autre.

Rappels et relances

Planifiez des relances support ou commerciales à sept, quatorze ou quatre-vingt-dix jours après un ticket ou une date de lancement avec une pure arithmétique de jours.

Questions fréquentes

Que signifie ajouter des jours à une date ?

Cela signifie prendre un jour valide du calendrier grégorien et avancer ou reculer d’un nombre entier de jours calendaires, en franchissant les limites de mois et d’année ainsi que les jours bissextiles le cas échéant.

Gère-t-il les années bissextiles ?

Oui. Les règles bissextiles grégoriennes s’appliquent : divisible par 4, sauf les siècles qui doivent l’être par 400. Le 29 février n’est accepté qu’en année bissextile et est franchi correctement lorsque le décalage tombe sur ce jour ou le dépasse.

Quel format de date est exigé ?

ISO strict YYYY-MM-DD avec année à quatre chiffres et mois et jour à deux. Des valeurs comme 2024-3-1 ou 2024/03/01 sont rejetées pour que chaque client s’accorde sur la même chaîne.

Que se passe-t-il avec une date de base invalide comme 2023-02-29 ?

Le message d’erreur explique que le jour n’est pas valide pour cette année et ce mois.

Quel est le coût ?

L’outil navigateur est gratuit et s’exécute en local.

Outils associés

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

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

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-days \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-01","days":10}'

const res = await fetch("https://api.kit.forhosting.com/date/add-days", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-03-01",
    "days": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/add-days",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-03-01",
    "days": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/add-days", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2024-03-01","days":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2024-03-01","days":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/add-days", 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

{
  "date": "2024-03-01",
  "days": 10
}

Exemple de réponse

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

par requête$0.002

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.

Notes techniques

Ce que vous envoyez et ce que vous recevez

Envoyez deux champs obligatoires : date comme jour calendaire ISO strict, par exemple deux mille vingt-quatre tiret zéro trois tiret zéro un, et days comme un comptage entier fini de jours, par exemple dix, zéro ou moins sept. Vérifications classiques : ajouter dix jours au premier mars deux mille vingt-quatre pour atteindre le onze mars, ajouter un jour au vingt-huit février d’une année commune pour atteindre le premier mars, ajouter un jour au vingt-huit février d’une année bissextile pour atteindre le vingt-neuf, et soustraire sept jours d’une date ISO de type lundi pour retomber sur la semaine précédente. Champs manquants, dates non textuelles, chaînes qui ne correspondent pas au motif de chiffres quatre-deux-deux, décalages de jours non entiers et bases qui matchent le motif mais ne sont pas de vraies dates calendaires échouent avec invalid_input et ne sont pas facturés. En cas de succès la réponse renvoie la date de base normalisée, le décalage entier days appliqué, la chaîne ISO result après addition, l’année, le mois et le jour numériques du résultat, un booléen is_leap_year pour l’année du résultat, et une courte chaîne formula qui documente la règle bissextile. Le tarif des appels API réussis est la base publiée de $0.002 par élément ; les échecs de validation ne consomment pas le solde prépayé.

Où les calculateurs d’ajout de jours interviennent au travail

Comme cette capacité est un moteur parse pur, le tarif API est la base publiée de $0.002 par élément réussi et l’échec de validation ne consomme pas le solde.

Cas d'intégration

Fenêtres de rétention et d’essai

Dérivez les fins d’essai et les seuils de rétention à partir d’une chaîne ISO de début plus un décalage entier de jours configuré pour pipelines et fixtures QA.

Consulter la documentation complète du KIT →