Umanizzare durata
Inserisca una durata in secondi e ottenga un testo leggibile a colpo d'occhio: 183840 secondi diventano «2 days 3 hours 4 minutes», cioè 2 giorni, 3 ore e 4 minuti. Le unità a zero vengono omesse e la frase è in inglese. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Lunghezza della durata in secondi
- 183.840
- Secondi di input
- 183.840
- Giorni
- 2
- Ore
- 3
- Minuti
- 4
Un formattatore di durata umanizzata risponde a una domanda pratica che compare in log, dashboard e testi di prodotto: data una lunghezza di tempo come numero grezzo di secondi, cosa deve leggere una persona? Inserisca una durata non negativa in secondi e questo strumento restituisce una frase compatta costruita da giorni, ore, minuti e secondi interi; ad esempio centottantatremilaottocentoquaranta secondi diventano due giorni, tre ore e quattro minuti. Gli ingegneri di supporto che spiegano finestre di incidente, gli sviluppatori che scrivono stringhe attese per test unitari, i docenti che valutano esercizi sul tempo trascorso e i team di prodotto che affinano stati vuoti necessitano della stessa formulazione deterministica senza trascinare una pesante libreria i18n.
Cosa significa umanizzare una durata e quali unità compaiono
Una durata è una lunghezza di tempo, non un timestamp di calendario. Quando i sistemi memorizzano il tempo trascorso usano quasi sempre un conteggio non negativo di secondi perché quell’unità è facile da sommare, sottrarre e serializzare. Gli esseri umani, invece, faticano a interpretare a colpo d’occhio grandi conteggi di secondi: novanta secondi sono chiaramente un minuto e mezzo, ma centottantatremilaottocentoquaranta secondi non si leggono come due giorni e qualche ora.
Umanizzare significa scomporre quel totale nella scala familiare di giorni interi di ottantaseimilaquattrocento secondi, ore di tremilaseicento secondi, minuti di sessanta secondi e secondi residui. Le unità intermedie che valgono zero vengono omesse così la frase resta breve —un giorno cinque minuti anziché un giorno zero ore cinque minuti— mentre un input tutto zero stampa ancora zero secondi affinché chi chiama non riceva mai una stringa vuota. Le etichette al singolare e al plurale seguono la grammatica ordinaria: un’ora contro due ore, un minuto contro due minuti.
Consigli pratici, limiti e ricerche correlate
Preferisca inviare numeri piuttosto che stringhe preformattate quando controlla il client; le stringhe numeriche sono accettate solo se corrispondono a un pattern numerico finito rigoroso. Mantenga le durate entro il massimo pubblicato così grandi moltiplicazioni non diventano mai non finite. Quando insegna o testa, conservi un piccolo insieme noto: un caso di successo multi-unità come due giorni tre ore quattro minuti, un mix breve come un minuto trenta secondi, un caso zero secondi, un input frazionario che fa floor in modo pulito e un fallimento negativo deliberato.
I controlli andata-ritorno sono facili: ricalcoli days per ottantaseimilaquattrocento più hours per tremilaseicento più minutes per sessanta più secondi e confermi che la somma uguaglia il campo dei secondi interi pubblicato. Questa landing intercetta chi cerca un formattatore di durata umanizzata, secondi in giorni ore minuti o tempo trascorso leggibile online; non è un formattatore di date di calendario, non un convertitore di fuso, non un monitor di uptime e non un ammorbiditore di prosa.
Preferisca questa capacità quando ha già un conteggio di secondi e le serve solo una frase stabile; se le servono nomi di mese o etichette del giorno della settimana da una data di calendario, usi una capacità di formattazione date o giorno della settimana. Documenti la regola di floor nei commenti del client così i redattori di prodotto sanno che mezzo secondo non viene mai arrotondato per eccesso a un secondo intero in questo strumento.
Casi d'uso
Testi di tempo trascorso per incidenti e SLA
Le pagine di stato e le post-mortem convertono contatori grezzi di secondi in frasi come due ore quindici minuti che i non tecnici leggono senza aritmetica mentale.
Stringhe attese per test di timer
I team di ingegneria fissano etichette umanizzate per countdown, runtime di job e lunghezze media così gli snapshot UI restano deterministici tra browser.
Esercizi scolastici sul tempo trascorso
Gli studenti inviano un totale in secondi e confrontano la scomposizione stampata giorno-ora-minuto-secondo con un risultato deterministico prima di consegnare i fogli.
Domande frequenti
Quale input accetta il formattatore di durata umanizzata?
I valori frazionari subiscono floor a secondi interi.
Cosa succede con una durata negativa?
Le lunghezze negative vengono rifiutate invece di essere prese in valore assoluto o abbellite.
Quali unità compaiono nella stringa leggibile?
Giorni, ore, minuti e secondi interi. Le unità intermedie zero sono omesse; una durata tutta zero si stampa come «0 seconds».
Formatta date di calendario o timestamp?
No. Umanizza solo la lunghezza di una durata pura. Usi strumenti di formattazione date o giorno della settimana quando ha una data di calendario.
Il formattatore di durata umanizzata è gratuito?
Lo strumento nel browser è gratuito e gira in locale.
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/humanize-duration \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"seconds":183840}'const res = await fetch("https://api.kit.forhosting.com/date/humanize-duration", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"seconds": 183840
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/humanize-duration",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"seconds": 183840
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/humanize-duration", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"seconds":183840}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"seconds":183840}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/humanize-duration", 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
{
"seconds": 183840
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.humanize_duration",
"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.
Limiti
max_seconds | 1000000000000 |
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
Lo zero è consentito e si stampa come zero secondi; i valori negativi vengono rifiutati con un errore invalid_input chiaro invece di un valore assoluto fuorviante. Il percorso è aritmetica intera pura —nessuna rete, nessun seme casuale, nessuna dipendenza dall’orologio Date—, così l’esecutore gratuito del browser e l’API prepagata restituiscono lo stesso JSON dopo il floor delle entrate frazionarie ogni volta che viene chiamato.
Cosa significa umanizzare una durata e quali unità compaiono
Le lunghezze negative sono fuori dall’intento di prodotto: un timer trascorso che va all’indietro è un errore di dati, non una frase da abbellire, quindi la validazione fallisce con invalid_input nominando il campo seconds.
Come chiamare l’API e cosa torna indietro
Gli input frazionari sono accettati e portati a floor in secondi interi prima della suddivisione per unità, così il rumore in virgola mobile non può ribaltare un confine quasi intero. Quando afferma risultati nei test, preferisca confrontare il campo human (o text) e il dettaglio numerico piuttosto che ricostruire le etichette a mano, perché le forme singolare e plurale fanno parte del contratto pubblicato. Invii un corpo JSON con un numero finito obbligatorio chiamato seconds, che può anche essere fornito sotto gli alias duration, value, secs o s. I valori assoluti devono restare entro il massimo pubblicato di un bilione di secondi così i prodotti intermedi restano finiti sul Worker e nel browser. In caso di successo la risposta ecoa seconds come totale intero con floor, opzionalmente input_seconds quando il valore grezzo differiva, days, hours, minutes e secs come interi non negativi che ricombinano il totale, human e text come la stessa frase leggibile, message come una breve frase di riepilogo e steps come un array ordinato che descrive il floor e la scomposizione. La validazione fallita —campo assente, numeri non finiti, valori sopra il massimo o qualsiasi durata negativa— restituisce invalid_input e non viene mai addebitata. Il prezzo è un forfait $0.002 per richiesta riuscita con unità item e prezzo marginale zero.
Consigli pratici, limiti e ricerche correlate
Le attività fallite che restituiscono invalid_input non consumano saldo prepagato, il che mantiene economici gli script esplorativi quando gli allievi inviano di proposito valori negativi.