JSON shema upisuje datum, ali to ne znači da validator mora provjeriti datum.
Shema kaže `format: date`, ali loš datum prolazi provjeru. To ne mora nužno značiti da postoji greška u knjižnici. Kako se rukuje `format` ovisi o konfiguraciji validatora. Kada dobijete "provjera uspješna", prvo pitajte je li provjerava tip, strukturu ili također provjerava semantiku datuma.
format: date je zapisan u JSON shemi, ali nepostojeći datum prolazi provjeru. Ovo obično nije greška u knjižnici. Kako se rukuje format ovisi o konfiguraciji validatora. Kada naiđete na rezultat "provjera uspješna", prvo biste trebali provjeriti provjerava li vrstu, strukturu ili također provjerava semantiku datuma.
Ovaj je članak prikladan za programere i recenzente koji trebaju izvršiti strukturiranu provjeru podataka dokumenta i brinu o točnosti datumskih polja. Nakon što ovo pročitate, moći ćete odrediti što znači prolazna provjera i upotrijebiti testiranje protuprimjera da popravite pravila datuma.
Ovaj članak koristi sintetičke uzorke za demonstraciju metode obrade. Kôd je provjeren s primjerima u izoliranom okruženju i nije jamstvo svih stvarnih datoteka ili performansi proizvoda. Prije obrade važnih dokumenata, molimo vas da sačuvate izvornike i pregledate ih prema granicama i stavkama prihvaćanja u tekstu.
Što točno provjerava provjera datuma JSON sheme? Zaključak jedne rečenice
Najprije provjerite je li provjera format omogućena u validatoru, a zatim provjerite jesu li semantička pravila datuma (postoji li doista i kako ga interpretirati) inače odgovorna.
| vaša situacija | Preporučene prakse | razlog |
|---|---|---|
Provjerite samo format: date sa zadanim validatorom | Prvo provjerite je li FormatChecker izričito omogućen | Kako se rukuje format ovisi o konfiguraciji validatora |
Potrebno je identificirati datume kao što je 2026-02-30 | Stavite ga u testni skup kao protuprimjer | Niz izgleda kao datum, što ne znači da postoji u kalendaru. |
| Redoslijed dana i mjeseca izvornog datuma nije poznat. | Označite dvosmislenost, nema automatskog pogađanja | Prolazak date provjere može samo pokazati da je pretvorena vrijednost važeća |
| Polja s vremenom i vremenskom zonom | Koristite neovisne vremenske protokole | Prvih deset znakova ne treba presresti i obrađivati ležerno |
| Koristi se za provjeru datuma prijevoda | Spremite i raw_text i normalizirane vrijednosti | Recenzenti moraju vidjeti i izvorni sadržaj i sustavno objašnjenje |
Dva naizgled identična čeka
2026-02-30 je niz i izgleda kao datum, ali ne postoji 30. dan u veljači. Samo provjerom pravilnih oblika propustit ćete ovu vrstu problema. Sljedeće koristi Pythonov jsonschema za usporedbu rezultata zadanog validatora i eksplicitnog omogućavanja FormatChecker.
Testirajte konfiguraciju s nemogućim datumom
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)
Sintetički primjer samo potvrđuje date. Ostali formati mogu imati neobavezne ovisnosti ili razlike u implementaciji i trebaju se testirati od slučaja do slučaja u zaključanom okruženju. Nazivi nepoznatog formata ne mogu se shvatiti kao da znače da je implementirana neka vrsta provjere, a pravopisne pogreške mogu vam dati osjećaj besmislene sigurnosti.
Format datuma nije pravilo tumačenja datuma
03/04/2026 u izvoru može značiti 4. ožujka, ili može značiti 3. travnja. Izvorna regija, specifikacija polja ili eksplicitni protokol potrebni su prije pretvaranja u ISO oblik. Prolaskom date provjere može se samo dokazati da je pretvorena vrijednost važeća, ali ne može dokazati da ste odabrali točan mjesec.
| Izvor informacija | što učiniti | Što ne raditi |
|---|---|---|
| Kalendarski datum koji ne postoji | Prijavite pogrešku i pregledajte izvor | Automatski prijeđite na sljedeći mjesec |
| Nepoznat redoslijed sunca i mjeseca | Dvosmislenost oznake | Pogodite na temelju jezika poslužitelja |
| S vremenom i vremenskom zonom | Koristite neovisne vremenske protokole | Nasumično presretnite prvih deset znakova |
| Polje je prazno | Tretirajte prema pravilima koja nedostaju | Dopuni današnji datum |
Uključite konfiguraciju u regresijsko testiranje
Put at least three types of values into the test set: a legal leap day, an illegal leap day, and a malformed value. Running these counterexamples when deploying is more efficient than just checking whether the Schema file exists. Ako je usluga implementirana na više jezika, isti skup testova treba zasebno provjeriti i nemojte pretpostavljati da je zadano ponašanje dva validatora isto.
Pregled prijevoda zadržava izvorni datum
When using the date extraction results for OmniDoc translation verification, it is recommended to save both raw_text and normalized values. Recenzent treba vidjeti "što je izvorni sadržaj" i "kako ga sustav tumači" kako bi utvrdio leži li razlika u prijevodu, izdvajanju ili pretvorbi formata.
Izvori: Niz i format JSON sheme.
📊 Osnovna usporedba
| Usporedna stavka | Zadani validator | Eksplicitno omogućite FormatChecker |
|---|---|---|
| Provjerite opseg | Vrste i strukture | Dodatno, provjerite formatformat deklaracije |
Zaključak o 2026-02-30 | Ne pretpostavljajte odbijanje | Treba potvrditi protuprimjerima |
| značenje pri prolasku | To ne znači da je datum semantički ispravan | Još treba provjeriti objašnjenje datuma u tvrtki |
🎯 Koja je metoda prikladna za vas?
Ako samo trebaš potvrditi da je polje niz ili ima ispravnu strukturu
Zadani validator je obično dovoljan, ali imajte na umu da ne provjerava nužno semantiku datuma.
Ako trebaš potvrditi da datum stvarno postoji
Eksplicitno omogući FormatChecker i provjeri s protuprimjerima poput 2026-02-30.
Ako želite provjeriti datum u izvornoj datoteci
Prvo potvrdite izvorna pravila slijeda dana i mjeseca, a zatim spremite izvorni tekst i normalizirane vrijednosti.
Ako je vaša usluga raspoređena na više jezika
Isti skup testova izvodi se na svakoj implementaciji.
❓ Često postavljana pitanja (FAQ)
1. Shema je napisana format: date, zašto loši datumi ipak mogu proći?
Način na koji se rukuje format ovisi o konfiguraciji validatora, a semantika datuma nije nužno provjeravana prema zadanim postavkama.
2. Zašto je 2026-02-30 korisna ispitna vrijednost?
Izgleda kao datum, ali veljača nema trideseti dan. Samom provjerom izgleda propustit ćete ovu vrstu problema.
3. Što se događa ako se koristi naziv nepoznatog formata?
Ne treba ga tretirati kao da je provjeren, a pravopisne pogreške mogu vam dati lažan osjećaj sigurnosti.
4. Kako treba pretvoriti 03/04/2026?
Potrebna je regija podrijetla, opis polja ili eksplicitni protokol. Inače bi bilo nemoguće reći predstavlja li to 4. ožujka ili 3. travnja.
📝 Sažetak
Prolazak provjere samo znači da podaci zadovoljavaju deklarirana pravila, ali ne znači da je značenje svakog datuma točno. Prvo potvrdite opseg provjere validatora, a zatim upotrijebite protuprimjere i izvorna pravila da popravite obradu datuma, tako da rezultati budu pouzdaniji.


