Doar pentru că data este scrisă în Schema JSON, nu înseamnă că validatorul trebuie să verifice data.
Schema spune `format: date`, dar data greșită trece de verificare. Acest lucru poate să nu însemne neapărat că există o eroare în bibliotecă. Modul în care este gestionat `format` depinde de configurația validatorului. Când obțineți o „verificare reușită”, mai întâi întrebați dacă a verificat tipul, structura sau a verificat și semantica datei.
format: date este scris în Schema JSON, dar o dată inexistentă trece de verificare. Aceasta nu este de obicei o eroare în bibliotecă. Modul în care este gestionat format depinde de configurația validatorului. Când întâlniți un rezultat „verificare reușită", trebuie să confirmați mai întâi dacă verifică tipul, structura sau verifică și semantica datei.
Acest articol este potrivit pentru dezvoltatori și evaluatori care trebuie să efectueze verificarea structurată a datelor documentelor și să se preocupe de acuratețea câmpurilor de date. După ce ați citit acest lucru, veți putea determina ce înseamnă o verificare de trecere și veți putea folosi testarea contra-exemplu pentru a stabili regulile de dată.
Acest articol folosește mostre sintetice pentru a demonstra metoda de procesare. Codul a fost verificat cu exemple într-un mediu izolat și nu este o garanție a tuturor fișierelor reale sau a performanței produsului. Înainte de a procesa documente importante, vă rugăm să păstrați originalele și să le revizuiți în funcție de limitele și elementele de acceptare din text.
Ce verifică exact verificarea datei Schemei JSON? O singură propoziție concluzie
Mai întâi confirmați dacă verificareaformat este activată în validator și apoi confirmați dacă regulile semantice ale datei (dacă există de fapt și cum să o interpretăm) sunt altfel responsabile.
| situatia ta | Practici recomandate | motiv |
|---|---|---|
Verificați format: date numai cu validatorul implicit | Mai întâi confirmați dacă FormatChecker este activat în mod explicit | Modul în care este gestionat format depinde de configurația validatorului |
Trebuie să identificați date precum 2026-02-30 | Puneți-l în setul de testare ca contraexemplu | Șirul arată ca o dată, ceea ce nu înseamnă că există în calendar. |
| Ordinea zilei și lunii datei sursei este necunoscută. | Marcați ambiguitatea, fără ghicire automată | Trecerea verificării date poate arăta doar că valoarea convertită este validă |
| Câmpuri cu ora și fusul orar | Utilizați protocoale de timp independente | Primele zece caractere nu trebuie interceptate și procesate aleatoriu |
| Folosit pentru verificarea datei traducerii | Salvați atât raw_text, cât și valorile normalizate | Recenziatorii trebuie să vadă atât conținutul original, cât și explicația sistematică |
Două verificări aparent identice
2026-02-30 este un șir și arată ca o dată, dar nu există a 30-a zi în februarie. Numai verificarea formelor obișnuite va rata acest tip de problemă. Următoarele utilizează jsonschema de la Python pentru a compara rezultatele validatorului implicit și pentru a activa în mod explicit FormatChecker.
Testează configurația cu o dată imposibilă
from jsonschema import Draft202012Validator, FormatChecker
schema = {"type": "string", "format": "date"}
structural = Draft202012Validator(schema)
strict = Draft202012Validator(schema, format_checker=FormatChecker())
def valid(v, value):
return not list(v.iter_errors(value))
assert valid(structural, "2026-02-30")
assert not valid(strict, "2026-02-30")
assert valid(strict, "2024-02-29")
assert not valid(strict, "2025-02-29")
assert not valid(strict, "26/09/2026")
assert not valid(strict, 20260926)
Exemplul sintetic verifică doar date. Alte formate pot avea dependențe opționale sau diferențe de implementare și ar trebui testate de la caz la caz într-un mediu blocat. Numele de format necunoscute nu pot fi interpretate ca însemnând că a fost implementat un fel de verificare, iar greșelile de ortografie vă pot oferi un sentiment de securitate lipsită de sens.
Formatul datei nu este o regulă de interpretare a datei
03/04/2026 în sursă poate însemna 4 martie sau poate însemna 3 aprilie. Regiunea sursă, specificația câmpului sau protocolul explicit sunt necesare înainte de a le converti în format ISO. Trecerea verificării date poate dovedi doar că valoarea convertită este validă, dar nu poate dovedi că ați selectat luna corectă.
| Informații sursă | ce să fac | Ce să nu faci |
|---|---|---|
| Data calendaristică care nu există | Raportați o eroare și examinați sursa | Derulați automat la luna următoare |
| Ordine necunoscută a soarelui și a lunii | Ambiguitatea etichetei | Ghici pe baza limbajului serverului |
| Cu ora și fusul orar | Utilizați protocoale de timp independente | Interceptați aleatoriu primele zece caractere |
| Câmpul este gol | Tratați conform regulilor lipsă | Completați data de astăzi |
Încorporați configurația în testarea de regresie
Introduceți cel puțin trei tipuri de valori în setul de testare: o zi bisectă legală, o zi bisectă ilegală și o valoare defectuoasă. Rularea acestor contraexemple la implementare este mai eficientă decât simpla verificare dacă există fișierul Schema. Dacă serviciul este implementat în diferite limbi, același set de teste ar trebui verificat separat și nu presupuneți că comportamentul implicit al celor doi validatori este același.
Revizuirea traducerii păstrează data inițială
Când utilizați rezultatele extragerii datei pentru verificarea traducerii OmniDoc, se recomandă să salvați atât raw_text, cât și valorile normalizate. Revizorul trebuie să vadă „care este conținutul original"și „cum îl interpretează sistemul"pentru a determina dacă diferența constă în traducere, extragere sau conversie de format.
Referințe: Șir de schemă JSON și format.
📊 Comparație de bază
| Element comparativ | Validator implicit | Activați în mod explicit FormatChecker |
|---|---|---|
| Verificați domeniul de aplicare | Tipuri și structuri | Verificare suplimentară pentru formatul declarațieiformat |
Concluzie despre 2026-02-30 | Nu presupune respingere | Trebuie confirmat cu contraexemple |
| sens la trecere | Nu înseamnă că semantica datei este corectă | Mai trebuie să verifici explicația datei despre afacere |
🎯 Ce metodă este potrivită pentru tine?
Dacă trebuie doar să vă asigurați că câmpul este un șir sau este structurat corect
Validatorul implicit este de obicei suficient, dar rețineți că nu verifică neapărat semantica datei.
Dacă trebuie să confirmați că data există cu adevărat
Activați în mod explicit FormatChecker și verificați cu contraexemple precum 2026-02-30.
Dacă doriți să verificați data în fișierul sursă
Mai întâi confirmați regulile sursă ale secvenței zile și luni, apoi salvați textul original și valorile normalizate.
Dacă serviciul dvs. este implementat în mai multe limbi
Același set de teste este rulat pe fiecare implementare.
❓ Întrebări frecvente (FAQ)
1. Schema este scrisă format: date, de ce mai pot trece datele proaste?
Modul în care este gestionat format depinde de configurația validatorului și semantica datei nu este neapărat verificată în mod implicit.
2. De ce este 2026-02-30 o valoare de test utilă?
Pare o întâlnire, dar februarie nu are a treizecea zi. Doar verificarea aspectului va rata acest tip de problemă.
3. Ce se întâmplă dacă este folosit un nume de format necunoscut?
Nu ar trebui tratat ca și cum ar fi fost verificat, iar greșelile de ortografie vă pot oferi un fals sentiment de securitate.
4. Cum ar trebui convertit 03/04/2026?
Regiunea de origine, descrierea câmpului sau protocolul explicit necesar. Altfel ar fi imposibil de spus dacă reprezintă 4 martie sau 3 aprilie.
📝 Rezumat
Trecerea verificării înseamnă doar că datele respectă regulile declarate, dar nu înseamnă că semnificația fiecărei date este corectă. Mai întâi confirmați sfera de verificare a validatorului, apoi utilizați contraexemple și regulile sursă pentru a stabili data procesării, astfel încât rezultatele să fie mai fiabile.
Încercați acum: încărcați documentul pentru a începe traducerea, păstrând aspectul original


