Analyser les dates relatives
À partir du 10 janvier 2020 à 12:00 UTC, l'expression in 3 days devient le 13 janvier 2020 à 12:00 UTC. Saisissez une courte expression en anglais ou en espagnol et un moment de référence pour obtenir la date et l'heure exactes. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Texte
- in 3 days
- Date de référence
- 2020-01-10T12:00:00.000Z
- Date et heure ISO
- 2020-01-13T12:00:00.000Z
- Horodatage Unix (millisecondes)
- 1 578 916 800 000
Interprétez des phrases relatives finies en anglais et en espagnol pour obtenir des horodatages ISO absolus calculés à partir d'une ancre que vous fournissez.
D'une expression à un instant précis
Nous écrivons sans cesse des dates relatives : dans 3 jours, dans quelques semaines, il y a quelque temps. Une telle expression n'a pas de sens fixe tant qu'on ne dit pas d'où elle part, c'est pourquoi l'outil demande un moment de référence. Il compte ensuite en avant ou en arrière à partir de ce moment et vous donne le résultat exact. L'heure de la journée est conservée : une expression comptée depuis midi tombe aussi à midi. À partir du 10 janvier 2020 à 12:00 UTC, in 3 days devient le 13 janvier 2020 à 12:00 UTC. Le résultat est fourni en date et heure lisibles et en un seul nombre de millisecondes.
Obtenir des réponses fiables
La surprise la plus fréquente vient du moment de référence. Comptée depuis un autre point de départ, la même expression désigne un autre jour : conservez donc la référence avec le résultat quand c'est important. L'outil travaille avec un ensemble limité de courtes expressions en anglais et en espagnol, pas avec n'importe quelle phrase, et une expression vide ou une valeur qui n'est pas du texte est refusée avant tout calcul. Tout se passe sur votre appareil, sans rien consulter en ligne : la même expression et le même moment de référence donnent toujours la même réponse, sans tableur.
Entrées et sorties
Les champs requis du schéma doivent être présents et correctement typés, tandis que les champs facultatifs utilisent des valeurs par défaut documentées. Les réponses réussies incluent toujours les champs de sortie principaux, afin que vos liaisons d'interface restent stables et prévisibles d'une exécution à l'autre.
Nous vous recommandons de lire attentivement les exemples de référence relatifs à l'ordre de validation, au déterminisme des résultats et aux chaînes de correspondance d'erreur destinées à la certification, avant de raccorder cette capacité à des systèmes critiques ou à des suites de tests automatisés qui doivent rester fiables dans la durée.
Cas limites et restrictions
Les chaînes vides, les types erronés et les plages contradictoires sont rejetés très tôt, avant le moindre calcul, ce qui rend le comportement prévisible face à des données malformées. Les dates civiles dépourvues de fuseau horaire sont traitées comme de simples dates calendaires, sans conversion implicite susceptible de fausser le résultat. Les tables de référence voyagent à l'intérieur du dossier de la capacité et aucun appel réseau n'est effectué pendant l'exécution, ce qui préserve à la fois la confidentialité et la vitesse.
Cas d’usage
Travail quotidien
Obtenez une réponse fiable sans passer par un tableur.
Pédagogie
Des exemples de référence stables pour vos démonstrations.
Questions fréquentes
Réseau ?
Aucun réseau ; l'analyse se fait sur l'appareil.
Qu'est-ce qu'une date relative ?
C'est une expression comme in 3 days qui n'a de sens qu'à partir d'un point de départ. Seule, elle ne désigne aucun jour ; avec un moment de référence, elle indique une date et une heure exactes.
À quoi sert le moment de référence ?
C'est l'instant à partir duquel l'expression est comptée. La même expression donne des résultats différents selon le moment de départ : notez celui que vous avez utilisé si vous devez refaire le calcul.
Dans quelles langues puis-je écrire l'expression ?
En anglais ou en espagnol. L'outil comprend un ensemble limité de courtes expressions relatives dans ces deux langues, et non du texte libre, ce qui rend chaque réponse prévisible.
Que contient le résultat ?
La date et l'heure au format ISO, par exemple le 2020-01-13 à 12:00 UTC, et le même instant sous forme de nombre de millisecondes, ici 1578916800000, prêt pour un tableur ou un autre outil.
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
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/relative-parse \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"in 3 days"}'const res = await fetch("https://api.kit.forhosting.com/date/relative-parse", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "in 3 days"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/relative-parse",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "in 3 days"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/relative-parse", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"in 3 days"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"in 3 days"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/relative-parse", 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
{
"text": "in 3 days"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.relative_parse",
"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. |
Notes techniques
Comment ça marche
Cette capacité interprète des phrases relatives finies rédigées en anglais ou en espagnol et les convertit en horodatages ISO-8601 absolus, calculés à partir d'une ancre que vous fournissez. Le calcul est entièrement déterministe et s'exécute gratuitement dans votre navigateur grâce à la même fonction pure que celle de l'API, ce qui garantit des résultats identiques hors ligne comme en ligne. Chaque entrée est validée avant toute opération arithmétique : les types incorrects sont donc signalés immédiatement par une erreur invalid_input claire et stable. Avant d'intégrer cette fonction dans vos flux de production ou vos tests automatisés, consultez les exemples de référence, qui couvrent aussi bien les cas de réussite que les chemins d'erreur, l'ordre de validation, la parité entre le navigateur et l'API, ainsi que le traitement sûr des valeurs flottantes situées hors des limites autorisées.
Entrées et sorties
Les valeurs intermédiaires extrêmement grandes qui dépassent la précision IEEE-754 produisent une erreur explicite de dépassement de plage plutôt qu'une valeur nulle silencieuse, ce qui évite les mauvaises surprises dans les calculs en aval.
Cas limites et restrictions
Examinez toujours les exemples fournis avant l'intégration : ils documentent l'ordre de validation, la parité entre le navigateur et l'API, les chaînes de correspondance d'erreur stables pour la certification et la gestion sûre des valeurs flottantes qui se situent hors des limites acceptées par le format.
Cas d'intégration
Automatisation
La même fonction pure dans le widget et dans l'API.
Questions techniques
Est-ce gratuit ?
Oui, palier A directement dans le navigateur.
Entrée invalide ?
Erreur invalid_input avec une correspondance claire.
Est-ce stable ?
Des exemples déterministes figent le contrat.
Auteur ?
samurai.