Analizzare date relative
Dal 10 gennaio 2020 alle 12:00 UTC, la frase in 3 days diventa il 13 gennaio 2020 alle 12:00 UTC. Scriva una breve frase in inglese o in spagnolo e un momento di riferimento per ottenere la data e l'ora esatte. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Testo
- in 3 days
- Data di riferimento
- 2020-01-10T12:00:00.000Z
- Data e ora ISO
- 2020-01-13T12:00:00.000Z
- Timestamp Unix (millisecondi)
- 1.578.916.800.000
Interpreta frasi relative finite in inglese e spagnolo per ottenere timestamp ISO assoluti calcolati rispetto a un'ancora che fornisci tu.
Da una frase a un istante preciso
Scriviamo continuamente date relative: tra 3 giorni, tra qualche settimana, qualche tempo fa. Una frase così non ha un significato fisso finché non si dice da dove parte, ed è per questo che lo strumento chiede un momento di riferimento. Da lì conta in avanti o all'indietro e le restituisce il risultato esatto. L'ora del giorno resta la stessa, quindi una frase contata da mezzogiorno cade anch'essa a mezzogiorno: dal 10 gennaio 2020 alle 12:00 UTC, in 3 days diventa il 13 gennaio 2020 alle 12:00 UTC. Riceve il risultato sia come data e ora leggibili sia come un unico numero di millisecondi.
Come ottenere risposte affidabili
La sorpresa più comune riguarda il momento di riferimento. Contata da un altro punto di partenza, la stessa frase indica un altro giorno, quindi conservi il riferimento insieme al risultato quando conta. Lo strumento lavora con un insieme limitato di brevi frasi in inglese e in spagnolo, non con qualsiasi frase, e una frase vuota o un valore che non è testo viene rifiutato prima di qualsiasi calcolo. Tutto avviene sul suo dispositivo senza consultare nulla in rete, quindi la stessa frase con lo stesso momento di riferimento dà sempre la stessa risposta, senza foglio di calcolo.
Input e output
Le risposte andate a buon fine includono sempre i campi di output principali, in modo che i collegamenti dell'interfaccia rimangano stabili e prevedibili da un'esecuzione all'altra. Ti consigliamo di leggere con attenzione gli esempi di riferimento relativi all'ordine di convalida, al determinismo dei risultati e alle stringhe di corrispondenza degli errori destinate alla certificazione, prima di collegare questa capacità a sistemi critici o a suite di test automatici che devono restare affidabili nel tempo.
Casi limite e restrizioni
Le stringhe vuote, i tipi errati e gli intervalli contraddittori vengono rifiutati molto presto, prima di qualsiasi calcolo, rendendo il comportamento prevedibile di fronte a dati malformati. Le date civili prive di fuso orario vengono trattate come semplici date di calendario, senza conversioni implicite che potrebbero falsare il risultato. Le tabelle di riferimento viaggiano all'interno della cartella della capacità e durante l'esecuzione non viene effettuata alcuna chiamata di rete, il che preserva sia la riservatezza sia la velocità.
Casi d'uso
Lavoro quotidiano
Ottieni una risposta affidabile senza un foglio di calcolo.
Didattica
Esempi di riferimento stabili per le tue dimostrazioni.
Domande frequenti
Che cos'è una data relativa?
È un'espressione come in 3 days che ha senso solo a partire da un punto di partenza. Da sola non indica alcun giorno; con un momento di riferimento indica una data e un'ora esatte.
A che cosa serve il momento di riferimento?
È l'istante da cui si conta la frase. La stessa frase dà risultati diversi da momenti diversi, quindi annoti quale ha usato se deve ripetere il calcolo in seguito.
In quali lingue posso scrivere la frase?
In inglese o in spagnolo. Lo strumento capisce un insieme limitato di brevi frasi relative in queste due lingue, non testo libero, e così ogni risposta resta prevedibile.
Che cosa contiene il risultato?
La data e l'ora in formato ISO, ad esempio il 2020-01-13 alle 12:00 UTC, e lo stesso istante come numero di millisecondi, qui 1578916800000, pronto per un foglio di calcolo o un altro strumento.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"text": "in 3 days"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.relative_parse",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Come funziona
Questa capacità interpreta frasi relative finite scritte in inglese o in spagnolo e le converte in timestamp ISO-8601 assoluti, calcolati a partire da un'ancora che fornisci tu. Il calcolo è completamente deterministico e viene eseguito gratuitamente nel tuo browser grazie alla stessa funzione pura utilizzata dall'API, così i risultati restano identici sia offline sia online. Ogni input viene convalidato prima di qualsiasi operazione aritmetica: i tipi errati vengono quindi segnalati subito con un errore invalid_input chiaro e stabile. Prima di integrare questa funzione nei tuoi flussi di produzione o nei tuoi test automatici, consulta gli esempi di riferimento, che coprono sia i casi di successo sia i percorsi di errore, l'ordine di convalida, la parità tra il browser e l'API e la gestione sicura dei valori in virgola mobile che si trovano fuori dai limiti consentiti.
Input e output
I campi obbligatori dello schema devono essere presenti e tipizzati correttamente, mentre i campi facoltativi utilizzano valori predefiniti documentati. I valori intermedi estremamente grandi che superano la precisione IEEE-754 producono un errore esplicito di superamento dell'intervallo anziché un valore nullo silenzioso, evitando così spiacevoli sorprese nei calcoli a valle.
Casi limite e restrizioni
Esamina sempre gli esempi forniti prima dell'integrazione: documentano l'ordine di convalida, la parità tra il browser e l'API, le stringhe di corrispondenza degli errori stabili per la certificazione e la gestione sicura dei valori in virgola mobile che si trovano al di fuori dei limiti accettati dal formato.
Casi di integrazione
Automazione
La stessa funzione pura nel widget e nell'API.
Domande tecniche
È gratis?
Sì, livello A direttamente nel browser.
Rete?
Nessuna rete; l'analisi avviene sul dispositivo.
Input non valido?
Errore invalid_input con una corrispondenza chiara.
È stabile?
Esempi deterministici bloccano il contratto.
Autore?
samurai.