ForHosting KIT · Outils pour développeurs

Convertisseur de durée ISO 8601 en secondes

Transformez une durée ISO 8601 telle que P3DT4H30M en un total unique de secondes.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le convertisseur lit les années, mois, semaines, jours, heures, minutes et secondes, puis applique des longueurs nominales explicites : 365 jours par année et 30 jours par mois. Comme il utilise uniquement votre texte, sans calendrier, fuseau horaire, date actuelle ni heure d’été, une entrée identique produit toujours le même résultat.

Lire la structure d’une durée ISO 8601

Une durée ISO 8601 commence par P, suivi des unités de date et, si nécessaire, du séparateur T avant les unités de temps. P2W désigne deux semaines, P3DT6H trois jours et six heures, et PT15M quinze minutes. La lettre M change de sens selon sa position : avant T, elle représente les mois ; après T, les minutes. Le convertisseur reconnaît les années, mois, semaines, jours, heures, minutes et secondes dans l’ordre normalisé. Il accepte aussi une fraction décimale sur la plus petite unité présente, avec un point ou une virgule. Saisissez la durée complète sans commentaire. La réponse reprend l’entrée normalisée, détaille chaque composant et fournit total_seconds. Les durées vides, unités désordonnées, valeurs négatives, marqueurs P ou PT seuls et textes étrangers sont refusés. Cette validation stricte permet de repérer des données incorrectes à la frontière d’une intégration au lieu de produire silencieusement un nombre trompeur.

Comprendre les années et mois nominaux

Une durée composée uniquement de jours, heures, minutes ou secondes possède une longueur fixe. Les années et mois calendaires varient : un mois réel compte 28, 29, 30 ou 31 jours, et une année 365 ou 366. Une durée seule ne contient pas la date de départ permettant de lever cette ambiguïté. L’outil emploie donc des constantes nominales affichées dans chaque réponse : 365 jours par année et 30 jours par mois. Une semaine vaut toujours sept jours, un jour 86,400 secondes, une heure 3,600 secondes et une minute 60 secondes. Le calcul additionne les composants pondérés. Un mois ajoute ainsi 2,592,000 secondes, quelle que soit la date d’exécution. Ces hypothèses ne décrivent pas un intervalle calendaire précis. Pour mesurer le temps écoulé entre deux horodatages réels, utilisez une différence de dates avec deux bornes explicites.

Exploiter des totaux déterministes en sécurité

Le total renvoyé est un nombre JSON entier de secondes. Les fractions ISO sont admises seulement sur la plus petite unité écrite et lorsque le calcul aboutit à une seconde entière. Ainsi, PT0.5M donne 30 secondes, tandis qu’une valeur nécessitant une fraction de seconde est refusée. Les totaux hors de la plage des entiers sûrs de JavaScript sont également rejetés afin d’éviter une précision illusoire. La sortie convient aux champs de base de données, contrôles de délai, réglages de timeout, simulations et tests reproductibles, à condition de partager les hypothèses nominales. Conservez l’objet des hypothèses si une autre équipe risque d’interpréter les mois selon le calendrier. Chaque requête API coûte $0.002; la même conversion pure fonctionne aussi dans le navigateur. Aucun réseau, horloge, aléa ni objet Date n’intervient, donc une entrée identique conserve exactement ses composants et son total.

Cas d’usage

Normaliser les durées d’une API

Convertissez les champs ISO 8601 reçus en entier avant validation, comparaison ou stockage.

Créer des tests reproductibles

Produisez des totaux attendus stables sans dépendre d’une date initiale, d’un fuseau ou du calendrier courant.

Contrôler une configuration

Vérifiez rétentions, délais et timeouts en notation ISO avec les hypothèses nominales affichées.

Questions fréquentes

Quelle est la durée d’une année ici ?

Chaque année vaut exactement 365 jours, soit 31,536,000 secondes.

Quelle est la durée d’un mois ?

Chaque mois vaut nominalement 30 jours, soit 2,592,000 secondes ; aucune date initiale n’est utilisée.

M indique-t-il des mois ou des minutes ?

M avant le séparateur T indique les mois ; après T, il indique les minutes.

Les durées décimales sont-elles admises ?

Oui, sur la plus petite unité présente, si le résultat est un entier sûr de secondes. Point et virgule sont acceptés.

Quel est le tarif de l’API ?

Chaque requête API coûte $0.002. La conversion interactive s’exécute aussi localement dans le navigateur.

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/iso-duration-to-seconds

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/iso-duration-to-seconds \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration":"P1Y2M3DT4H5M6S"}'

const res = await fetch("https://api.kit.forhosting.com/date/iso-duration-to-seconds", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "duration": "P1Y2M3DT4H5M6S"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/iso-duration-to-seconds",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "duration": "P1Y2M3DT4H5M6S"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"duration":"P1Y2M3DT4H5M6S"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/iso-duration-to-seconds", 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

{
  "duration": "P1Y2M3DT4H5M6S"
}

Exemple de réponse

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

Limites

max_chars 200

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.

Consulter la documentation complète du KIT →