JSON Schema γράφει ημερομηνία, αλλά αυτό δεν σημαίνει ότι ο επικυρωτής πρέπει να ελέγξει την ημερομηνία.
Το σχήμα λέει `format: date`, αλλά η εσφαλμένη ημερομηνία περνά την επαλήθευση. Αυτό μπορεί να μην σημαίνει απαραίτητα ότι υπάρχει σφάλμα στη βιβλιοθήκη. Ο τρόπος χειρισμού του `format` εξαρτάται από τη διαμόρφωση του εργαλείου επικύρωσης. Όταν λάβετε μια "επιτυχή επαλήθευση", ρωτήστε πρώτα εάν έλεγξε τον τύπο, τη δομή ή έλεγξε επίσης τη σημασιολογία της ημερομηνίας.
Το format: date είναι γραμμένο στο σχήμα JSON, αλλά η επαλήθευση περνά από μια ημερομηνία που δεν υπάρχει. Αυτό συνήθως δεν είναι ένα σφάλμα στη βιβλιοθήκη. Ο τρόπος χειρισμού του format εξαρτάται από τη διαμόρφωση του εργαλείου επικύρωσης. Όταν αντιμετωπίζετε ένα αποτέλεσμα "επιτυχής επαλήθευση", θα πρέπει πρώτα να επιβεβαιώσετε εάν ελέγχει τον τύπο, τη δομή ή ελέγχει επίσης τη σημασιολογία της ημερομηνίας.
Αυτό το άρθρο είναι κατάλληλο για προγραμματιστές και αναθεωρητές που πρέπει να εκτελούν δομημένη επαλήθευση των δεδομένων εγγράφων και να ενδιαφέρονται για την ακρίβεια των πεδίων ημερομηνίας. Αφού διαβάσετε αυτό, θα μπορείτε να προσδιορίσετε τι σημαίνει επιτυχής επαλήθευση και να χρησιμοποιήσετε τη δοκιμή αντιπαραδειγμάτων για να διορθώσετε τους κανόνες ημερομηνίας.
Αυτό το άρθρο χρησιμοποιεί συνθετικά δείγματα για να δείξει τη μέθοδο επεξεργασίας. Ο κώδικας έχει ελεγχθεί με παραδείγματα σε απομονωμένο περιβάλλον και δεν αποτελεί εγγύηση για όλα τα πραγματικά αρχεία ή την απόδοση του προϊόντος. Πριν επεξεργαστείτε σημαντικά έγγραφα, διατηρήστε τα πρωτότυπα και ελέγξτε τα σύμφωνα με τα όρια και τα στοιχεία αποδοχής στο κείμενο.
Τι ακριβώς ελέγχει η επαλήθευση ημερομηνίας του JSON Schema; Μια φράση συμπέρασμα
Πρώτα επιβεβαιώστε εάν ο έλεγχος format είναι ενεργοποιημένος στο πρόγραμμα επικύρωσης και, στη συνέχεια, επιβεβαιώστε εάν οι σημασιολογικοί κανόνες της ημερομηνίας (αν υπάρχει στην πραγματικότητα και πώς να το ερμηνεύσετε) είναι διαφορετικά υπεύθυνοι.
| την κατάστασή σας | Συνιστώμενες πρακτικές | λόγος |
|---|---|---|
Ελέγξτε μόνο το format: date με προεπιλεγμένο εργαλείο επικύρωσης | Πρώτα επιβεβαιώστε εάν το FormatChecker είναι ρητά ενεργοποιημένο | Ο τρόπος χειρισμού του format εξαρτάται από τη διαμόρφωση του εργαλείου επικύρωσης |
Πρέπει να προσδιορίσετε ημερομηνίες όπως το 2026-02-30 | Βάλτε το στο δοκιμαστικό σετ ως αντιπαράδειγμα | Η συμβολοσειρά μοιάζει με ημερομηνία, πράγμα που δεν σημαίνει ότι υπάρχει στο ημερολόγιο. |
| Η σειρά της ημέρας και του μήνα της ημερομηνίας πηγής είναι άγνωστη. | Σημειώστε ασάφεια, χωρίς αυτόματη εικασία | Η επικύρωση της επαλήθευσης date μπορεί να δείξει μόνο ότι η τιμή μετατροπής είναι έγκυρη |
| Πεδία με ώρα και ζώνη ώρας | Χρησιμοποιήστε ανεξάρτητα πρωτόκολλα χρόνου | Οι πρώτοι δέκα χαρακτήρες δεν πρέπει να υποκλαπούν και να επεξεργαστούν τυχαία |
| Χρησιμοποιείται για την επαλήθευση ημερομηνίας μετάφρασης | Αποθηκεύστε τόσο τις τιμές raw_text όσο και τις κανονικοποιημένες τιμές | Οι αναθεωρητές πρέπει να δουν τόσο το αρχικό περιεχόμενο όσο και τη συστηματική εξήγηση |
Δύο φαινομενικά πανομοιότυπες επιταγές
Το 2026-02-30 είναι μια συμβολοσειρά και μοιάζει με ημερομηνία, αλλά δεν υπάρχει 30ή ημέρα τον Φεβρουάριο. Μόνο ο έλεγχος των κανονικών σχημάτων θα χάσει αυτό το είδος προβλήματος. Το παρακάτω χρησιμοποιεί το jsonschema της Python για να συγκρίνει τα αποτελέσματα του προεπιλεγμένου εργαλείου επικύρωσης και να ενεργοποιήσει ρητά το FormatChecker.
Δοκιμάστε τη διαμόρφωση με μια αδύνατη ημερομηνία
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)
Το συνθετικό παράδειγμα επαληθεύει μόνο το date. Άλλες μορφές ενδέχεται να έχουν προαιρετικές εξαρτήσεις ή διαφορές υλοποίησης και θα πρέπει να ελέγχονται κατά περίπτωση σε κλειδωμένο περιβάλλον. Τα ονόματα άγνωστων μορφών δεν μπορούν να θεωρηθούν ότι σημαίνουν ότι έχει εφαρμοστεί κάποιο είδος ελέγχου και τα ορθογραφικά λάθη μπορεί να σας δώσουν μια αίσθηση ανούσιας ασφάλειας.
Η μορφή ημερομηνίας δεν είναι κανόνας ερμηνείας ημερομηνίας
Το 03/04/2026 στην πηγή μπορεί να σημαίνει 4 Μαρτίου ή μπορεί να σημαίνει 3 Απριλίου. Η περιοχή προέλευσης, η προδιαγραφή πεδίου ή το ρητό πρωτόκολλο απαιτείται πριν από τη μετατροπή σε μορφή ISO. Η επικύρωση της επαλήθευσης date μπορεί μόνο να αποδείξει ότι η τιμή μετατροπής είναι έγκυρη, αλλά δεν μπορεί να αποδείξει ότι επιλέξατε τον σωστό μήνα.
| Πληροφορίες πηγής | τι να κάνουμε | Τι να μην κάνεις |
|---|---|---|
| Ημερομηνία που δεν υπάρχει | Αναφέρετε ένα σφάλμα και ελέγξτε την πηγή | Μεταφέρεται αυτόματα στον επόμενο μήνα |
| Η σειρά του ήλιου και της σελήνης είναι ασαφής | Σημειώστε την ασάφεια | Εικασία με βάση τη γλώσσα του διακομιστή |
| Περιλαμβάνει ώρα και ζώνη ώρας | Χρησιμοποιήστε ανεξάρτητα συμφωνητικά χρόνου | Τυχαία αποκοπή των πρώτων δέκα χαρακτήρων |
| Το πεδίο είναι κενό | Χειρισμός σύμφωνα με τον κανόνα που λείπει | Συμπληρώστε την ημερομηνία της ημέρας |
Συμπεριλάβετε τη διαμόρφωση στη δοκιμή παλινδρόμησης
Το σύνολο δοκιμής περιέχει τουλάχιστον τρεις τύπους τιμών: μία έγκυρη δίσεκτη ημέρα, μία παράνομη δίσεκτη ημέρα και μία εσφαλμένη τιμή. Η εκτέλεση αυτών των αντιπαραδειγμάτων κατά την ανάπτυξη είναι πιο αποτελεσματική από τον απλό έλεγχο εάν υπάρχει το αρχείο σχήματος. Εάν η υπηρεσία υλοποιείται σε όλες τις γλώσσες, το ίδιο σύνολο δοκιμών θα πρέπει να επικυρώνεται ξεχωριστά και η προεπιλεγμένη συμπεριφορά δύο επικυρωτών δεν θα πρέπει να θεωρείται πανομοιότυπη.
Η αναθεώρηση μετάφρασης διατηρεί την αρχική ημερομηνία
Όταν χρησιμοποιείτε το αποτέλεσμα εξαγωγής ημερομηνίας για επαλήθευση μετάφρασης OmniDoc, συνιστάται η αποθήκευση τόσο του raw_text όσο και των κανονικοποιημένων τιμών. Οι αναθεωρητές πρέπει να δουν "ποιο είναι το αρχικό περιεχόμενο" και "πώς το ερμηνεύει το σύστημα" για να εντοπίσουν διαφορές στη μετάφραση, την εξαγωγή ή τη μετατροπή μορφής.
Αναφορές: Συμβολοσειρά και μορφή JSON Schema.
📊 Σύγκριση πυρήνων
| Στοιχεία σύγκρισης | Προεπιλεγμένος επικυρωτής | Ενεργοποιήστε ρητά το FormatChecker |
|---|---|---|
| Πεδίο επιθεώρησης | Τύποι και δομή | Επιπλέον, ελέγξτε τη μορφή της δήλωσηςformat |
Συμπέρασμα για το 2026-02-30 | Δεν μπορείτε να υποθέσετε ότι θα σας απορρίψουν | Απαιτούνται αντιπαραδείγματα για δοκιμές σε πραγματικό κόσμο για να επιβεβαιωθεί |
| Η έννοια της διέλευσης | Αυτό δεν σημαίνει ότι η ημερομηνία είναι σημασιολογικά σωστή | Είναι ακόμα απαραίτητο να επαληθεύσετε την εξήγηση της ημερομηνίας κατά την εργάσιμη ημερομηνία |
🎯 Ποια μέθοδος σας ταιριάζει;
Εάν χρειάζεται μόνο να επιβεβαιώσετε ότι το πεδίο είναι συμβολοσειρά ή έχει τη σωστή δομή
Ο προεπιλεγμένος επικυρωτής είναι συνήθως επαρκής, αλλά να γνωρίζετε ότι δεν ελέγχει απαραίτητα τη σημασιολογία ημερομηνίας.
Εάν πρέπει να επιβεβαιώσετε ότι η ημερομηνία υπάρχει πραγματικά
Ενεργοποιήστε ρητά το FormatChecker και επαληθεύστε με αντιπαραδείγματα όπως το 2026-02-30.
Εάν θέλετε να επαληθεύσετε την ημερομηνία στο αρχείο προέλευσης
Αρχικά, επιβεβαιώστε τους κανόνες προέλευσης για τη σειρά ημέρας-μήνα και, στη συνέχεια, αποθηκεύστε το αρχικό κείμενο και τις κανονικοποιημένες τιμές.
Εάν η υπηρεσία σας αναπτύσσεται σε πολλές γλώσσες
Εκτελέστε το ίδιο σύνολο δοκιμών ξεχωριστά σε κάθε υλοποίηση.
❓ Συχνές Ερωτήσεις (FAQ)
1. Το σχήμα έγραφε format: date, οπότε γιατί μπορούν ακόμα να περάσουν κακές ημερομηνίες;
Ο χειρισμός του format εξαρτάται από τη διαμόρφωση του επικυρωτή. Από προεπιλογή, η σημασιολογία ημερομηνίας ενδέχεται να μην ελέγχεται.
2. Γιατί το 2026-02-30 είναι μια χρήσιμη τιμή δοκιμής;
Μοιάζει με ημερομηνία, αλλά ο Φεβρουάριος δεν έχει τριακοστή ημέρα. Εστιάζοντας μόνο στην εμφάνιση θα χάσετε τέτοιου είδους ζητήματα.
3. Τι συμβαίνει εάν χρησιμοποιείτε όνομα άγνωστης μορφής;
Δεν πρέπει να θεωρείται ότι έχει ελεγχθεί. Τα ορθογραφικά λάθη μπορεί να σας δώσουν μια ψευδή αίσθηση ασφάλειας.
4. Πώς πρέπει να μετατραπεί το 03/04/2026;
Απαιτείται περιοχή προέλευσης, περιγραφή πεδίου ή σαφής συμφωνία. Διαφορετικά, είναι αδύνατο να πούμε αν αντιπροσωπεύει την 4η Μαρτίου ή την 3η Απριλίου.
📝 Περίληψη
Η επιτυχία ενός ελέγχου σημαίνει μόνο ότι τα δεδομένα πληρούν τους δηλωμένους κανόνες και δεν σημαίνει ότι κάθε ημερομηνία είναι σωστή. Αρχικά, επιβεβαιώστε το εύρος επιθεώρησης του επικυρωτή και, στη συνέχεια, διορθώστε την επεξεργασία ημερομηνίας με αντιπαραδείγματα και κανόνες πηγής για πιο αξιόπιστα αποτελέσματα.


