Csak azért, mert a dátum a JSON-sémában van írva, ez nem jelenti azt, hogy az érvényesítőnek ellenőriznie kell a dátumot.
A séma szerint `format: date`, de a rossz dátum átmegy az ellenőrzésen. Ez nem feltétlenül jelenti azt, hogy hiba van a könyvtárban. Az `format` kezelésének módja az érvényesítő konfigurációjától függ. Amikor megkapja az "ellenőrzés sikeres", először kérdezze meg, hogy ellenőrizte-e a típust, a szerkezetet, vagy a dátum szemantikáját is.
A format: date szerepel a JSON-sémában, de egy nem létező dátum átmegy az ellenőrzésen. Ez általában nem a könyvtár hibája. A format kezelésének módja az érvényesítő konfigurációjától függ. Ha "ellenőrzés sikeres" eredménnyel találkozik, először meg kell győződnie arról, hogy ellenőrzi-e a típust, a struktúrát, vagy a dátum szemantikáját is.
Ez a cikk azoknak a fejlesztőknek és lektoroknak szól, akiknek strukturált ellenőrzést kell végezniük a dokumentumadatokban, és törődnek a dátummezők pontosságával. Ennek elolvasása után meg tudja határozni, mit jelent a sikeres ellenőrzés, és ellenpélda teszttel rögzítheti a dátumszabályokat.
Ez a cikk szintetikus mintákat használ a feldolgozási módszer bemutatására. A kódot példákkal ellenőrizték elszigetelt környezetben, és nem garantálja az összes valós fájlt vagy a termék teljesítményét. A fontos dokumentumok feldolgozása előtt kérjük, őrizze meg az eredeti példányokat és nézze át a szövegben szereplő határok és átvételi tételek szerint.
Pontosan mit ellenőriz a JSON-séma dátumellenőrzése? Egy mondatos következtetés
Először ellenőrizze, hogy a format ellenőrzés engedélyezve van-e az érvényesítőben, majd ellenőrizze, hogy a dátum szemantikai szabályai (valóban létezik-e, és hogyan kell értelmezni) felelősek-e.
| a helyzeted | Ajánlott gyakorlatok | ok |
|---|---|---|
Csak az alapértelmezett érvényesítővel ellenőrizze a format: date elemet | Először ellenőrizze, hogy a FormatChecker kifejezetten engedélyezve van-e | A format kezelésének módja az érvényesítő konfigurációjától függ |
Meg kell határozni a dátumokat, például a 2026-02-30 | Tedd be a tesztkészletbe ellenpéldaként | A karakterlánc dátumnak tűnik, ami nem jelenti azt, hogy létezik a naptárban. |
| A forrásdátum napjának és hónapjának sorrendje ismeretlen. | Jelölje meg a kétértelműséget, nincs automatikus találgatás | A date ellenőrzés átadása csak azt mutatja, hogy a konvertált érték érvényes |
| Idővel és időzónával rendelkező mezők | Használjon független időprotokollokat | Az első tíz karaktert nem szabad véletlenszerűen elfogni és feldolgozni |
| A fordítás dátumának ellenőrzésére szolgál | Mentse el a raw_text és a normalizált értékeket | A véleményezőknek látniuk kell az eredeti tartalmat és a szisztematikus magyarázatot is |
Két látszólag egyforma csekk
A 2026-02-30 egy karakterlánc, és úgy néz ki, mint egy dátum, de februárban nincs 30. nap. Csak a szabályos alakzatok ellenőrzése esetén elkerülhető ez a fajta probléma. A következőkben a Python jsonschema-ját használja az alapértelmezett érvényesítő és a FormatChecker explicit engedélyezése eredményeinek összehasonlítására.
Tesztelje a konfigurációt lehetetlen dátummal
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)
A szintetikus példa csak a date-t igazolja. Más formátumok opcionális függőségekkel vagy megvalósítási különbségekkel rendelkezhetnek, és ezeket eseti alapon kell tesztelni zárt környezetben. Az ismeretlen formátumneveket nem lehet úgy értelmezni, hogy valamilyen ellenőrzést végrehajtottak, és az elírások értelmetlen biztonságérzetet kelthetnek.
A dátumformátum nem dátumértelmezési szabály
A forrásban szereplő 03/04/2026 jelentheti március 4-ét, vagy április 3-át. A forrásrégió, a mezőspecifikáció vagy az explicit protokoll szükséges az ISO formátumra való átalakítás előtt. A date ellenőrzés sikeressége csak azt bizonyítja, hogy az átváltott érték érvényes, de azt nem, hogy a megfelelő hónapot választotta.
| Forrás információ | mit kell tenni | Mit ne tegyen |
|---|---|---|
| Nem létező naptári dátum | Jelentse be a hibát, és tekintse át a forrást | Automatikus görgetés a következő hónapra |
| A nap és a hold ismeretlen sorrendje | Címke kétértelműség | Találd ki a szerver nyelve alapján |
| Idővel és időzónával | Használjon független időprotokollokat | Véletlenszerűen elkapja az első tíz karaktert |
| A mező üres | Kezelje a hiányzó szabályokat | Egészítse ki a mai dátumot |
Konfiguráció beépítése a regressziós tesztelésbe
Tegyen be legalább háromféle értéket a tesztkészletbe: egy legális szökőnapot, egy illegális szökőnapot és egy hibásan kialakított értéket. Ezeknek az ellenpéldáknak a futtatása a telepítés során hatékonyabb, mint annak ellenőrzése, hogy létezik-e a sémafájl. Ha a szolgáltatás több nyelven van implementálva, ugyanazt a tesztkészletet külön kell ellenőrizni, és ne feltételezzük, hogy a két érvényesítő alapértelmezett viselkedése megegyezik.
A fordítási vélemény megtartja az eredeti dátumot
Ha a dátumkivonási eredményeket használja a OmniDoc fordítás-ellenőrzéshez, javasoljuk a raw_text és a normalizált értékek mentését. A bírálónak látnia kell, „mi az eredeti tartalom"és „hogyan értelmezi a rendszer", hogy megállapítsa, a különbség a fordításban, a kivonatolásban vagy a formátumátalakításban van-e.
Források: JSON-séma karakterlánc és formátum.
📊 Alapvető összehasonlítás
| Összehasonlító tétel | Alapértelmezett érvényesítő | Kifejezetten engedélyezze a FormatCheckert |
|---|---|---|
| Ellenőrizze a hatókört | Típusok és szerkezetek | Aformat nyilatkozat formátumának további ellenőrzése |
Következtetés a 2026-02-30-ről | Ne feltételezze az elutasítást | Ellenpéldákkal kell megerősíteni |
| jelentése elhaladáskor | Ez nem jelenti azt, hogy a dátum szemantika helyes | Még mindig ellenőriznie kell a dátum magyarázatát a vállalkozáson |
🎯 Melyik módszer illik hozzád?
Ha csak meg kell győződnie arról, hogy a mező karakterlánc-e vagy megfelelően strukturált
Az alapértelmezett érvényesítő általában elegendő, de ne feledje, hogy nem feltétlenül ellenőrzi a dátumszemantikát.
Ha meg kell erősítenie, hogy a dátum valóban létezik
Kifejezetten engedélyezze a FormatCheckert, és ellenőrizze az olyan ellenpéldákkal, mint a 2026-02-30.
Ha ellenőrizni szeretné a dátumot a forrásfájlban
Először erősítse meg a nap- és hónapsorozat forrásszabályait, majd mentse el az eredeti szöveget és a normalizált értékeket.
Ha a szolgáltatást több nyelven is telepítik
Ugyanaz a tesztkészlet fut minden egyes implementáción.
❓ Gyakran Ismételt Kérdések (GYIK)
1. A séma meg van írva. format: date, miért múlhatnak el a rossz dátumok?
A format kezelésének módja az érvényesítő konfigurációjától függ, és a dátumszemantika alapértelmezés szerint nem feltétlenül ellenőrzött.
2. Miért hasznos a 2026-02-30 tesztérték?
Úgy néz ki, mint egy randevú, de februárnak nincs harmincadik napja. Csak a megjelenés ellenőrzése elmulasztja ezt a fajta problémát.
3. Mi történik, ha ismeretlen formátumnevet használnak?
Nem szabad úgy kezelni, mintha ellenőrizték volna, és a helyesírási hibák hamis biztonságérzetet kelthetnek.
4. Hogyan kell a 03/04/2026-t konvertálni?
Származási régió, mezőleírás vagy kifejezett protokoll szükséges. Különben lehetetlen lenne megmondani, hogy március 4-ét vagy április 3-át jelképezi.
📝 Összefoglaló
Az ellenőrzés sikeressége csak azt jelenti, hogy az adatok megfelelnek a deklarált szabályoknak, de nem jelenti azt, hogy az egyes dátumok jelentése helyes. Először ellenőrizze az érvényesítő ellenőrzési hatókörét, majd ellenpéldák és forrásszabályok segítségével rögzítse a dátumfeldolgozást, hogy az eredmények megbízhatóbbak legyenek.


