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áciaOdporúčané postupydôvod
format: date skontrolujte iba s predvoleným validátoromNajprv 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-30Vložte ho do testovacej súpravy ako protipríkladReť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ásmomPoužívajte nezávislé časové protokolyPrvých desať znakov by nemalo byť náhodne zachytených a spracovaných
Používa sa na overenie dátumu prekladuUložte hodnoty raw_text aj normalizované hodnotyRecenzenti 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ý neexistujeNahláste chybu a skontrolujte zdrojAutomaticky prejsť na nasledujúci mesiac
Poradie slnka a mesiaca nie je jasnéNejednoznačnosť MarkOdhadovanie na základe serverového jazyka
Zahŕňa čas a časové pásmoPoužívajte dohody o nezávislom časeNáhodné orezanie prvých desiatich znakov
Pole je prázdneRiešené podľa chýbajúceho pravidlaDoplň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žkyPredvolený validátorExplicitne povoliť FormatChecker
Rozsah inšpekcieTypy a štruktúraOkrem toho skontrolujte formát deklarácieformat
Záver o 2026-02-30Nemôžeš predpokladať, že ťa odmietnuNa potvrdenie sú potrebné protipríklady na reálne testovanie
Význam prechodu cezTo však neznamená, že dátum je sémanticky správnyStá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.

Skúsenosti teraz: Nahrajte svoj dokument a začnite s prekladom, pričom zachovávate pôvodné formátovanie

Aktualizované 2026-11-16