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 situacijaPreporučene prakserazlog
Provjerite samo format: date sa zadanim validatoromPrvo provjerite je li FormatChecker izričito omogućenKako se rukuje format ovisi o konfiguraciji validatora
Potrebno je identificirati datume kao što je 2026-02-30Stavite ga u testni skup kao protuprimjerNiz 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đanjaProlazak date provjere može samo pokazati da je pretvorena vrijednost važeća
Polja s vremenom i vremenskom zonomKoristite neovisne vremenske protokolePrvih deset znakova ne treba presresti i obrađivati ležerno
Koristi se za provjeru datuma prijevodaSpremite i raw_text i normalizirane vrijednostiRecenzenti 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 postojiPrijavite pogrešku i pregledajte izvorAutomatski prijeđite na sljedeći mjesec
Nepoznat redoslijed sunca i mjesecaDvosmislenost oznakePogodite na temelju jezika poslužitelja
S vremenom i vremenskom zonomKoristite neovisne vremenske protokoleNasumično presretnite prvih deset znakova
Polje je praznoTretirajte prema pravilima koja nedostajuDopuni 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 stavkaZadani validatorEksplicitno omogućite FormatChecker
Provjerite opsegVrste i struktureDodatno, provjerite formatformat deklaracije
Zaključak o 2026-02-30Ne pretpostavljajte odbijanjeTreba potvrditi protuprimjerima
značenje pri prolaskuTo ne znači da je datum semantički ispravanJoš 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.

Iskustvo sada: Učitajte svoj dokument kako biste započeli prijevod, zadržavajući izvorno formatiranje

Ažurirano 2026-11-16