ISO 8601 Timestamp Validator and Formatter

Validarea marcajelor de timp ISO 8601 și normalizarea formatării pentru API-uri, încărcăturile utile JSON, jurnalele de audit, orarele, feed-urile și exporturile de baze de date. Utilizați-l pentru a prinde date malformate înainte de a rupe integrarea sau de a crea confuzie fus orar. ToolMill ruleaza pe deplin client-side, ceea ce face convenabil pentru verificarea valorilor de producție-ca și fără a le trimite la un alt serviciu validator.

Ce verifică acest validator

Acest validator este conceput pentru un flux de lucru practic al dezvoltatorului: lipirea unui timbru de timp sau a unui șir de date, verificarea dacă se potrivește cu forma preconizată ISO 8601 și prinderea problemelor evidente de formatare înainte ca valoarea să fie trimisă la un API, stocată în JSON, sau copiată într-un fișier de configurare. Se verifică dacă valoarea arată ca o dată sau o marcă de timp ISO validă și dacă browser-ul poate parse într-o dată reală în loc de una imposibilă.

Ce nu verifică acest validator

Un șir poate fi valabil structural aici și încă să fie greșit pentru aplicarea dumneavoastră. Această pagină nu cunoaște regulile dvs. de afaceri, ordine de evenimente, cerințe de schema API, sau dacă un serviciu în aval insistă pe un interval de timp compensat, un UTC Z sufix, secunde fracționare, sau un format numai data. Te ajută să prinzi greșeli de format, dar nu înlocuiește contractul definit de sistem care va consuma în cele din urmă marca de timp.

Motive comune un ISO 8601 Timestamp Fails

Cele mai frecvente eșecuri sunt simple: lipsește separatorul T, folosind un spațiu în care o ștampilă de timp strictă se așteaptă la T, tastând o lună sau o zi imposibilă, omitend o compensare necesară a fusului orar, adăugând text suplimentar de urmărire, sau copierea unei valori cu spațiu alb ascuns dintr-o foaie de calcul sau un vizualizator log. Un timbru temporal poate eșua, de asemenea, pentru că arată aproape de ISO 8601, dar nu include piesele exacte la care se așteaptă sistemul țintă.

Exemple acceptate şi exemple respinse

Exemple bune includ o ștampilă de timp UTC completă, cum ar fi 2026-03-05T17:46:39Z și o valoare unică la data, cum ar fi 2026-03-05 atunci când o dată este tot ce ai nevoie. Intrările respinse includ adesea valori cum ar fi 2026/03/05, marcaje temporale cu spațiu, dar fără fus orar sau corzi cu câmpuri temporale parțial lipsă. Compararea unui exemplu care trece şi eşuează unul lângă altul este adesea cea mai rapidă cale de a vedea dacă problema este punctuaţia, notaţia fusului orar sau o valoare calendaristică imposibilă.

UTC, Offset-uri și sensul Z

Sufixul Z înseamnă UTC. O compensare explicită, cum ar fi +00:00 reprezintă, de asemenea, UTC, în timp ce valori cum ar fi -05:00 sau +02:00 reprezintă același tip de timbru cu un alt offset local. Două șiruri de caractere pot reprezenta același moment în timp ce se uită diferit pe ecran, deoarece unul este scris în UTC și altul este scris cu o compensare regională. Acesta este unul dintre motivele pentru care depanarea timbrului de timp necesită adesea atât validarea, cât și interpretarea, nu doar corelarea cu modelul.

Data- vs Data- Ora de intrare

O valoare unică pentru date, cum ar fi 2026-03-05, poate fi valabilă ISO 8601, dar nu are o durată de timp sau un fus orar. Acest lucru poate fi acceptabil pentru datele datorate, intervalele de raportare și câmpurile calendaristice, dar nu pentru marcajele de timp ale evenimentului, înregistrările de audit sau încărcăturile utile API care necesită o perioadă exactă. Utilizați această distincție pentru a decide dacă o valoare este doar validă sau adecvată efectiv pentru sistemul pe care îl testați.

Cum se fixează o marcă de timp nevalidă

Începeți prin tăierea valorii și verificarea separatoarelor. Se confirmă apoi dacă sistemul țintă se așteaptă doar la o dată, o marcă de timp UTC cu Z sau o marcă de timp cu o compensare numerică explicită. În cazul în care valoarea a venit dintr-o foaie de calcul, jurnal de export, sau câmpul UI copiat, eliminați spațiile suplimentare și confirmați că piesele de lună, zi și timp sunt complete. Mici probleme de punctuaţie sunt adesea cauza reală a unui rezultat nereuşit de validare.

Confidenţialitatea şi validarea locală

Înainte de a vă baza pe un timbru temporal validat

După validare, confirmați formatul exact de timbru de timp așteptat de destinația reală, inclusiv precizia, manipularea offset, și dacă este necesară normalizarea UTC. Validitatea sintaxei este doar prima verificare; compatibilitatea cu sistemul de primire este partea care necesită încă revizuire.

De ce un termen aparent clar poate cauza încă probleme

Chiar și o ștampilă cu aspect curat poate provoca probleme în cazul în care un sistem se așteaptă UTC, un alt magazin de compensare locale, sau o destinație necesită secunde, milisecunde, sau un anumit stil de compensare. Valorile unice pentru date pot fi, de asemenea, ambigue dacă codul din aval presupune miezul nopții într-un anumit fus orar.

Ce înseamnă un rezultat valid ISO 8601

Un rezultat valabil inseamna ca textul corespunde regulilor formatului pe care acest validator il accepta pentru stampila de stil ISO 8601. Aceasta nu garantează faptul că timbrul de timp descrie evenimentul potrivit, utilizează fusul orar prevăzut, sau se potrivește cu cerințele de stocare exacte ale API, baza de date, sau conducta de logare.

Validarea ruleaza in browser-ul dumneavoastra astfel incat sa puteti inspecta stampile de timp de la busteni, webhoose, programe, si sisteme interne fara a le trimite la un checker timbru tert. Acest lucru este util atunci când valoarea în sine este sensibilă, legată de un incident, sau o parte dintr-o sarcină utilă pe care ați prefera să o păstrați într-o sesiune locală de depanare.

ISO 8601 Validator și Formatter

Încearcă.

Exemple