The exception "DPY-3022: named time zones are not supported in thin

mode" is now raised when attempting to fetch data of type TIMESTAMP WITH
TIME ZONE when the time zone associated with the data is a named time
zone. Previously invalid data was returned (#131).

Author: anthony-tuininga

doc/src/release_notes.rst

@@ -49,6 +49,11 @@ Thin Mode Changes
 #)  Fixed bug determining RETURNING binds in a SQL statement when RETURNING and
     INTO keywords are not separated by whitespace, but are separated by
     parentheses.
+#)  The exception ``DPY-3022: named time zones are not supported in thin mode``
+    is now raised when attempting to fetch data of type TIMESTAMP WITH TIME
+    ZONE when the time zone associated with the data is a named time zone.
+    Previously invalid data was returned
+    (`disc 131 <https://github.com/oracle/python-oracledb/discussions/131>`__).
 #)  Internal implementation changes:
 
     - Added internal support for prefetching the LOB size and chunk size,

src/oracledb/errors.py

@@ -202,6 +202,7 @@ def _raise_from_string(exc_type: Exception, message: str) -> None:
 ERR_OSON_NODE_TYPE_NOT_SUPPORTED = 3019
 ERR_OSON_FIELD_NAME_LIMITATION = 3020
 ERR_OSON_VERSION_NOT_SUPPORTED = 3021
+ERR_NAMED_TIMEZONE_NOT_SUPPORTED = 3022
 
 # error numbers that result in DatabaseError
 ERR_TNS_ENTRY_NOT_FOUND = 4000
@@ -421,6 +422,8 @@ def _raise_from_string(exc_type: Exception, message: str) -> None:
             'element {element} is not the same data type as previous elements',
     ERR_MIXED_POSITIONAL_AND_NAMED_BINDS:
             'positional and named binds cannot be intermixed',
+    ERR_NAMED_TIMEZONE_NOT_SUPPORTED:
+            'named time zones are not supported in thin mode',
     ERR_NCHAR_CS_NOT_SUPPORTED:
             'national character set id {charset_id} is not supported by '
             'python-oracledb in thin mode',

src/oracledb/impl/thin/buffer.pyx

@@ -359,6 +359,8 @@ cdef class Buffer:
         value = cydatetime.datetime_new(year, ptr[2], ptr[3], ptr[4] - 1,
                                         ptr[5] - 1, ptr[6] - 1, fsecond, None)
         if num_bytes > 11 and ptr[11] != 0 and ptr[12] != 0:
+            if ptr[11] & TNS_HAS_REGION_ID:
+                errors._raise_err(errors.ERR_NAMED_TIMEZONE_NOT_SUPPORTED)
             tz_hour = ptr[11] - TZ_HOUR_OFFSET
             tz_minute = ptr[12] - TZ_MINUTE_OFFSET
             if tz_hour != 0 or tz_minute != 0:

src/oracledb/impl/thin/constants.pxi

@@ -727,6 +727,7 @@ DEF TNS_TXN_IN_PROGRESS = 0x00000002
 DEF TNS_MAX_CONNECT_DATA = 230
 DEF TNS_CHUNK_SIZE = 32767
 DEF TNS_MAX_UROWID_LENGTH = 5267
+DEF TNS_HAS_REGION_ID = 0x80
 
 # base 64 encoding alphabet
 DEF TNS_BASE64_ALPHABET = \