Len preto, že dátum je napísaný v schéme JSON, neznamená to, že validátor musí dátum skontrolovať.
Schéma hovorí `format: date`, ale zlý dátum prejde overením. Nemusí to nevyhnutne znamenať, že v knižnici je chyba. Spôsob spracovania `format` závisí od konfigurácie validátora. Keď dostanete "overenie úspešné", najprv sa opýtajte, či skontroloval typ, štruktúru alebo skontroloval aj sémantiku dátumu.
format: date je zapísaný v schéme JSON, ale overením prejde neexistujúci dátum. Toto zvyčajne nie je chyba v knižnici. Spôsob spracovania format závisí od konfigurácie validátora. Keď narazíte na výsledok „overenie úspešné", mali by ste najprv potvrdiť, či kontroluje typ, štruktúru alebo kontroluje aj sémantiku dátumu.
Tento článok je vhodný pre vývojárov a recenzentov, ktorí potrebujú vykonať štruktúrované overenie údajov dokumentu a dbajú na presnosť polí dátumu. Po prečítaní tohto budete môcť určiť, čo znamená úspešné overenie, a použiť testovanie protipríkladu na opravu pravidiel dátumu.
Tento článok používa syntetické vzorky na demonštráciu spôsobu spracovania. Kód bol skontrolovaný pomocou príkladov v izolovanom prostredí a nie je zárukou všetkých skutočných súborov alebo výkonu produktu. Pred spracovaním dôležitých dokumentov si uschovajte originály a skontrolujte ich podľa hraníc a akceptačných položiek v texte.
Čo presne kontroluje overenie dátumu schémy JSON? Záver jednou vetou
Najprv potvrďte, či je vo validátore povolená kontrolaformat, a potom potvrďte, či sú inak zodpovedné sémantické pravidlá dátumu (či skutočne existuje a ako ho interpretovať).
| vaša situácia | Odporúčané postupy | dôvod |
|---|---|---|
format: date skontrolujte iba s predvoleným validátorom | Najprv skontrolujte, či je program FormatChecker explicitne povolený | Spôsob spracovania format závisí od konfigurácie validátora |
Potrebujete identifikovať dátumy, napríklad 2026-02-30 | Vložte ho do testovacej súpravy ako protipríklad | Reťazec vyzerá ako dátum, čo však neznamená, že v kalendári existuje. |
| Poradie dňa a mesiaca zdrojového dátumu nie je známe. | Označte nejednoznačnosť, žiadne automatické hádanie | Úspešné overenie date môže ukázať iba to, že prevedená hodnota je platná |
| Polia s časom a časovým pásmom | Používajte nezávislé časové protokoly | Prvých desať znakov by nemalo byť náhodne zachytených a spracovaných |
| Používa sa na overenie dátumu prekladu | Uložte hodnoty raw_text aj normalizované hodnoty | Recenzenti musia vidieť pôvodný obsah aj systematické vysvetlenie |
Dva zdanlivo rovnaké šeky
2026-02-30 je reťazec a vyzerá ako dátum, ale vo februári neexistuje 30. deň. Iba kontrola pravidelných tvarov tento problém vynechá. Nasledujúci text používa jsonschema Pythonu na porovnanie výsledkov predvoleného validátora a explicitného povolenia FormatChecker.
Otestujte konfiguráciu s nemožným dátumom
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)
Syntetický príklad iba overuje date. Iné formáty môžu mať voliteľné závislosti alebo rozdiely v implementácii a mali by sa testovať od prípadu k prípadu v uzamknutom prostredí. Neznáme názvy formátov nemožno chápať tak, že znamenajú, že bol implementovaný nejaký druh kontroly, a preklepy vám môžu poskytnúť pocit bezvýznamnej bezpečnosti.
Formát dátumu nie je pravidlom interpretácie dátumu
03/04/2026 v zdroji môže znamenať 4. marec alebo 3. apríl. Pred konverziou do formátu ISO sa vyžaduje zdrojová oblasť, špecifikácia poľa alebo explicitný protokol. Úspešné overenie date môže iba dokázať, že prevedená hodnota je platná, ale nemôže dokázať, že ste vybrali správny mesiac.
| Informácie o zdroji | čo robiť | Čo nerobiť |
|---|---|---|
| Dátum kalendára, ktorý neexistuje | Nahláste chybu a skontrolujte zdroj | Automaticky prejsť na nasledujúci mesiac |
| Poradie slnka a mesiaca nie je jasné | Nejednoznačnosť Mark | Odhadovanie na základe serverového jazyka |
| Zahŕňa čas a časové pásmo | Používajte dohody o nezávislom čase | Náhodné orezanie prvých desiatich znakov |
| Pole je prázdne | Riešené podľa chýbajúceho pravidla | Doplňte dátum dňa |
Zahrnúť konfiguráciu do regresného testovania
Testovací súbor obsahuje aspoň tri typy hodnôt: jeden platný prestupný deň, jeden nelegálny prestupný deň a jednu nesprávnu hodnotu. Spúšťanie týchto protipríkladov počas nasadenia je efektívnejšie než len kontrola, či súbor schémy existuje. Ak je služba implementovaná naprieč jazykmi, rovnaká testovacia sada by mala byť validovaná samostatne a predvolené správanie dvoch validátorov by sa nemalo predpokladať ako identické.
Recenzia prekladu zachováva pôvodný dátum
Pri používaní výsledku extrakcie dátumu na overenie prekladu OmniDoc sa odporúča uložiť hodnoty raw_text aj normalizované hodnoty. Recenzenti potrebujú vidieť "čo je pôvodný obsah" a "ako ho systém interpretuje", aby identifikovali rozdiely v preklade, extrakcii alebo konverzii formátu.
Zdroje: Reťazec a formát schémy JSON.
📊 Porovnanie jadra
| Porovnávacie položky | Predvolený validátor | Explicitne povoliť FormatChecker |
|---|---|---|
| Rozsah inšpekcie | Typy a štruktúra | Okrem toho skontrolujte formát deklarácieformat |
Záver o 2026-02-30 | Nemôžeš predpokladať, že ťa odmietnu | Na potvrdenie sú potrebné protipríklady na reálne testovanie |
| Význam prechodu cez | To však neznamená, že dátum je sémanticky správny | Stále je potrebné overiť vysvetlenie dátumu v pracovný deň |
🎯 Ktorá metóda ti vyhovuje?
Ak potrebujete len potvrdiť, že pole je reťazec alebo má správnu štruktúru
Predvolený validátor je zvyčajne postačujúci, ale majte na pamäti, že nemusí nevyhnutne kontrolovať dátumovú sémantiku.
Ak potrebuješ potvrdiť, že dátum naozaj existuje
Explicitne povolte FormatChecker a overte pomocou protipríkladov ako 2026-02-30.
Ak chcete overiť dátum v zdrojovom súbore
Najprv potvrďte zdrojové pravidlá pre poradie deň a mesiac, potom uložte pôvodný text a normalizované hodnoty.
Ak je vaša služba nasadená naprieč jazykmi
Spustite rovnakú testovaciu sadu samostatne v každej implementácii.
❓ Často kladené otázky (FAQ)
1. Schéma napísala format: date, tak prečo môžu zlé dátumy stále prejsť?
Spracovanie format závisí od konfigurácie validátora; predvolene nemusí byť dátumová sémantika kontrolovaná.
2. Prečo je 2026-02-30 užitočná testovacia hodnota?
Vyzerá to ako dátum, ale február nemá tridsiaty deň. Ak sa zameriate len na vzhľad, tieto problémy sa prehliadne.
3. Čo sa stane, ak použijete neznámy názov formátu?
Nemalo by sa považovať za overené; pravopisné chyby vám môžu vyvolať falošný pocit bezpečia.
4. Ako by sa mal 03/04/2026 konvertovať?
Vyžaduje sa zdrojová oblasť, popis poľa alebo jasná zhoda. Inak nie je možné určiť, či ide o 4. marec alebo 3. apríl.
📝 Zhrnutie
Prechod kontrolou len znamená, že dáta spĺňajú deklarované pravidlá, a neznamená to, že každý dátum je správny. Najprv potvrďte rozsah inšpekcie validátora, potom opravte spracovanie dátumov pomocou protipríkladov a zdrojových pravidiel pre spoľahlivejšie výsledky.


