Werte und Grenzen

Wie WKL Office JSON JSON-Werte in VBA-Werte umwandelt und zurück, und wo die Bibliothek an Grenzen stößt. JSON (RFC 8259) kennt Zeichenfolgen, Zahlen, true/false, null, Objekte und Arrays; VBA kennt typisierte Variant-Werte. Hier ist jeder Übergang zwischen beiden aufgeführt, zusammen mit dem, was dabei verloren geht, und dem, was abgelehnt wird. Die Seiten der Member in der API-Referenz (Englisch) verweisen auf diese Seite.

Der Ersatzwert einer typisierten Get-Methode wird nach den Umwandlungsregeln von VBA (VariantChangeType) in den Typ der Get-Methode umgewandelt; ein Ersatzwert, der sich nicht umwandeln lässt (zum Beispiel GetLong(path, "abc")), löst jeTypeMismatch aus. GetValue gibt seinen Ersatzwert unverändert zurück.

Eine Zeichenfolge wird nur dann als Zahl gelesen, wenn ihr Text ohne umgebende Leerzeichen eine JSON-Zahl ist: "42" und " 4.2 " werden gelesen; "007", "+5", ".5", "12,5" und "1 000" lösen jeTypeMismatch aus – lesen Sie solche Codes mit GetString. Für GetBoolean ist eine Zahl False, wenn sie nach der Umwandlung in Decimal 0 ist; das schließt Zahlen unter 1E-28 wie 1e-30 ein (anders als bei CBool), und jede andere Zahl, auch eine jenseits des Decimal-Bereichs, ist True.

Was SetValue, Add, Insert und CreateValue annehmen (Value = … eines Werteknotens nimmt nur die Werte dieser Tabelle ohne Kindknoten oder einen JValue an; ein Knoten mit Kindknoten, ein Array oder ein JDoc mit einem Objekt oder Array als Wurzel lösen dort jeInvalidOperation aus, und Value = … auf einem Objekt oder Array löst immer jeInvalidOperation aus):

Eine Zahl behält den Text, mit dem sie gelesen wurde; Json, Save und GetString schreiben diesen Text unverändert, auch 0.10, 1E3 oder eine Zahl mit 40 Ziffern. Nur die Umwandlung in einen VBA-Typ kann runden oder fehlschlagen:

• GetDecimal und GetCurrency wandeln den Text direkt um, nicht über Double; 0.1 + 0.2 bleibt daher exakt. Decimal fasst 28 bis 29 signifikante Stellen: Eine Zahl mit mehr Stellen wird ohne Fehler auf diese Genauigkeit gerundet, und eine Zahl, deren Betrag unter 1E-28 liegt (zum Beispiel 1e-30), wird ohne Fehler zu 0; lesen Sie solche Werte mit GetDouble. Currency rundet auf vier Nachkommastellen.
• Value gibt für ganze Zahlen Long oder Decimal zurück; eine ganze Zahl jenseits des Decimal-Bereichs (etwa 7,9 × 10^28) wird als Double zurückgegeben, mit der Genauigkeit eines Double.
• Eine Zahl jenseits des Double-Bereichs (1e400) ist gültiges JSON; sie mit Value oder GetDouble zu lesen, löst jeTypeMismatch aus; GetString gibt ihren Text zurück.

JSON kennt keinen Datumstyp; Datumswerte werden als Zeichenfolgen übertragen.

Lesen (GetDate, DateValue) nimmt die Formen an, die Webdienste senden (Profil von ISO 8601 nach RFC 3339): 2026-09-25, 2026-09-25T14:30, 2026-09-25T14:30:15, Sekundenbruchteile mit Punkt oder Komma (bis zu sieben Ziffern werden gelesen, weitere ignoriert), jeweils wahlweise gefolgt von Z, +02:00, +0200 oder +02. Ein Leerzeichen statt T wird akzeptiert. Abgelehnt werden Wochen- und Ordinaldaten, Zeitdauern, die Sekunde 60, 24:00 sowie ein Datum ohne Uhrzeit, das eine Zone trägt. Ein Datum vor dem Jahr 100, dem ersten Datum, das VBA kennt, löst jeTypeMismatch aus. DateZone des Dokuments legt fest, was aus einem Zeitstempel mit Zone wird: in Ortszeit umgerechnet (Standard), in UTC umgerechnet oder so, wie er geschrieben ist (siehe Datums- und Uhrzeitwerte lesen und schreiben). Für die Ortszeit gelten die Zeitzonenregeln, die Windows für das jeweilige Datum hat.

Schreiben ergibt yyyy-MM-dd für ein Datum um Mitternacht, sonst yyyy-MM-ddTHH:mm:ss, mit .fff, wenn der Wert Millisekunden hat, immer ohne Zone. Eine VBA-Uhrzeit ohne Datum (#14:30#) wird mit dem Basisdatum von VBA geschrieben: 1899-12-30T14:30:00.

JPath setzt Syntax und Semantik von RFC 9535 (JSONPath) um. Die Abweichungen:

• Erweiterungen. Ein Pfad ohne $ beginnt am aktuellen Knoten (auf oberster Ebene auch @); - ist in Kurznamen erlaubt ($.first-name); Leerraum um den gesamten Ausdruck wird ignoriert; ein regulärer Ausdruck bricht nach einer Sekunde ab und ergibt dann false.
• Angenommen, obwohl RFC 9535 einen Fehler verlangt. Funktionsausdrücke, die nicht korrekt typisiert sind ($[?length(@.*) < 3], $[?length(@.a)], $[?match(@.a,'x') == true]), ! unmittelbar vor einem Vergleich, \' in einer Zeichenfolge in doppelten Anführungszeichen, die Indizes -0 und 01 sowie Indizes jenseits von ±(2^53−1).
• Abweichende Ergebnisse. Zeichenfolgen werden nach UTF-16-Codeeinheiten geordnet, nicht nach Unicode-Skalarwerten (das macht nur zwischen Zeichen im Bereich U+E000–U+FFFF und Zeichen oberhalb von U+FFFF einen Unterschied). Zahlen werden als Decimal verglichen: Zahlen unter 1E-28 sind gleich 0, und Zahlen, die sich erst nach der 28. signifikanten Stelle unterscheiden, sind gleich. Eine Funktion vom Typ ValueType, die als Test verwendet wird, ist für den Wert false falsch.
• Reguläre Ausdrücke. match und search verwenden reguläre Ausdrücke von .NET statt I-Regexp (RFC 9485): . passt auf genau eine UTF-16-Codeeinheit (ein Emoji braucht zwei) und auch auf CR; \d, \w, \s, Rückverweise und Lookaround werden akzeptiert. Ein ungültiges Muster ergibt false, wie es RFC 9535, Abschnitt 2.4.6, verlangt. Ab 2.1.0 läuft ein Muster ohne Rückverweise und Lookaround auf einer Engine, deren Laufzeit nur linear mit dem Text wächst; ein Muster mit diesen Konstrukten läuft wie bisher mit dem Zeitlimit von einer Sekunde.
• Verschachtelte Ausdrücke. Ab 2.1.0 ergibt ein Ausdruck mit mehr als 256 Ebenen aus Klammern, Negationen, Funktionsargumenten und Filtern in Filtern (ein Filter in einem Filter zählt doppelt) den Fehler jePathSyntax.
• Pfade. Path eines Knotens gibt den Ausdruck dieser Bibliothek zurück, in Punktschreibweise, wo ein Name sie zulässt, sonst als ['name'] ($.lines[2].no, $['first name']) – nicht die Klammerform eines Normalized Path (RFC 9535, Abschnitt 2.7).

Kompilierte Ausdrücke werden in einem Cache mit 512 Einträgen gehalten.

Die Objekte sind COM-Objekte des Apartment-Modells: Erzeugen und verwenden Sie sie in einem einzigen Thread, wie es VBA tut; für andere Hosts sind sie nicht threadsicher.

Unterstützte Konfiguration: Microsoft 365 Access 16.0 in 32 und 64 Bit (ACCDB, ACCDE und Access Runtime) unter Windows 11. Andere Access-Versionen (2016, 2019, 2021, LTSC) und andere Windows-Versionen werden in diesem Release nicht unterstützt.

• Überblick
• Exakte Beträge und große Kennungen lesen
• Datums- und Uhrzeitwerte lesen und schreiben
• Ungültiges JSON behandeln
• JSON mit JPath abfragen