Vrednosti in omejitve

Ta stran opisuje, kako WKL Office JSON pretvarja vrednosti JSON v vrednosti VBA in nazaj ter kje so meje. JSON (RFC 8259) pozna nize, števila, true/false, null, objekte in polja; VBA pozna tipizirane vrednosti Variant. Tu je naveden vsak prehod med obema, skupaj s tem, kaj se pri tem izgubi in kaj je zavrnjeno. Strani članov v referenci API (v angleščini) se sklicujejo na to stran.

Nadomestna vrednost tipizirane bralne metode se pretvori v tip bralne metode po pravilih pretvorbe v VBA (VariantChangeType); nadomestna vrednost, ki je ni mogoče pretvoriti (na primer GetLong(path, "abc")), sproži jeTypeMismatch. GetValue vrne nadomestno vrednost nespremenjeno.

Niz se prebere kot število le, če je njegovo besedilo brez presledkov na začetku in koncu število JSON: "42" in " 4.2 " se prebereta; "007", "+5", ".5", "12,5" in "1 000" sprožijo jeTypeMismatch – take kode berite z GetString. Pri GetBoolean je število False, če je po pretvorbi v Decimal enako 0; to velja tudi za števila, manjša od 1E-28, kot je 1e-30 (drugače kot pri CBool), vsako drugo število, tudi zunaj obsega Decimal, pa je True.

Kaj sprejmejo SetValue, Add, Insert in CreateValue (Value = … vozlišča z vrednostjo sprejme samo tiste vrednosti iz te tabele, ki nimajo podrejenih elementov, ali JValue; vozlišče s podrejenimi vozlišči, polje ali JDoc z objektom ali poljem kot korenom tam sproži jeInvalidOperation, Value = … na objektu ali polju pa vedno sproži jeInvalidOperation):

Število ohrani besedilo, s katerim je bilo prebrano; Json, Save in GetString to besedilo zapišejo nespremenjeno, tudi 0.10, 1E3 ali število s 40 števkami. Zaokroži ali ne uspe lahko samo pretvorba v tip VBA:

• GetDecimal in GetCurrency besedilo pretvorita neposredno, ne prek Double, zato 0.1 + 0.2 ostane natančno. Decimal hrani 28 do 29 veljavnih števk: število z več števkami se brez napake zaokroži na to natančnost, število z absolutno vrednostjo pod 1E-28 (na primer 1e-30) pa brez napake postane 0; take vrednosti berite z GetDouble. Currency zaokroži na štiri decimalna mesta.
• Value za cela števila vrne Long ali Decimal; celo število zunaj obsega Decimal (približno 7,9 × 10^28) vrne kot Double, z natančnostjo tipa Double.
• Število zunaj obsega Double (1e400) je veljaven JSON; branje z Value ali GetDouble sproži jeTypeMismatch; GetString vrne njegovo besedilo.

JSON nima datumskega tipa; datumi se prenašajo kot nizi.

Branje (GetDate, DateValue) sprejme oblike, ki jih pošiljajo spletne storitve (profil RFC 3339 standarda ISO 8601): 2026-09-25, 2026-09-25T14:30, 2026-09-25T14:30:15, del sekunde s piko ali vejico (prebere se do sedem števk, preostale se prezrejo), vsakič po izbiri z dodanim Z, +02:00, +0200 ali +02. Namesto T je sprejet tudi presledek. Zavrnjeni so tedenski datumi in datumi z zaporedno številko dneva v letu, trajanja, sekunda 60, 24:00 ter datum brez časa, ki nosi časovni pas. Datum pred letom 100, s katerim se začnejo datumi VBA, sproži jeTypeMismatch. Kaj postane časovni žig s časovnim pasom, določa DateZone dokumenta: pretvorba v lokalni čas (privzeto), pretvorba v UTC ali vrednost, kot je zapisana (glejte Datumi in časovni pasovi). Lokalni čas uporablja pravila časovnih pasov, ki jih ima Windows za ta datum.

Pisanje da yyyy-MM-dd za datum ob polnoči, sicer yyyy-MM-ddTHH:mm:ss, z .fff, kadar ima vrednost milisekunde, vedno brez časovnega pasu. Čas VBA brez datuma (#14:30#) se zapiše z osnovnim datumom VBA, 1899-12-30T14:30:00.

JPath izvaja sintakso in semantiko RFC 9535 (JSONPath). Razlike:

• Razširitve. Pot brez $ se začne pri trenutnem vozlišču (na najvišji ravni tudi @); v kratkih imenih je dovoljen - ($.first-name); presledki okrog celotnega izraza se prezrejo; regularni izraz se ustavi po eni sekundi in nato vrne false.
• Sprejeto, čeprav RFC 9535 zahteva napako. Funkcijski izrazi, ki niso pravilno tipizirani ($[?length(@.*) < 3], $[?length(@.a)], $[?match(@.a,'x') == true]), ! neposredno pred primerjavo, \' v nizu z dvojnimi narekovaji, indeksa -0 in 01 ter indeksi zunaj ±(2^53−1).
• Drugačni rezultati. Nizi so urejeni po kodnih enotah UTF-16, ne po skalarnih vrednostih Unicode (razlika se pokaže le med znaki U+E000–U+FFFF in znaki nad U+FFFF). Števila se primerjajo kot Decimal: števila pod 1E-28 so enaka 0, števila, ki se razlikujejo šele za 28. veljavno števko, pa so enaka. Funkcija tipa ValueType, uporabljena kot pogoj, pri vrednosti false ni izpolnjena.
• Regularni izrazi. match in search uporabljata regularne izraze .NET namesto I-Regexp (RFC 9485): . ustreza eni kodni enoti UTF-16 (emodži potrebuje dve) in tudi znaku CR; \d, \w, \s, povratni sklici in pogledi naprej oziroma nazaj (look-around) so sprejeti. Neveljaven vzorec vrne false, kot zahteva razdelek 2.4.6 RFC 9535.
• Poti. Path vozlišča vrne izraz te knjižnice v zapisu s piko, kjer ime to dopušča, sicer ['name'] ($.lines[2].no, $['first name']), ne oklepajske oblike normalizirane poti (Normalized Path, RFC 9535, razdelek 2.7).

Prevedeni izrazi se hranijo v predpomnilniku s 512 vnosi.

Objekti so objekti COM modela apartment: ustvarite in uporabljajte jih v eni niti, tako kot to počne VBA; za druge gostitelje niso varni pri hkratni uporabi iz več niti.

Podprta konfiguracija: 32- in 64-bitni Microsoft 365 Access 16.0 (ACCDB, ACCDE in Access Runtime) v sistemu Windows 11. Druge različice programa Access (2016, 2019, 2021, LTSC) in druge različice sistema Windows v tej izdaji niso podprte.

• Pregled
• Branje natančnih števil
• Datumi in časovni pasovi
• Obravnava neveljavnega JSON
• Poizvedovanje z JPath