Obsługa typu danych dla ulepszenia ODBC Data/Godzina

Mapowanie typu danych, parametry i Resultsets

Oprócz typów danych ODBC (SQL_TYPE_TIMESTAMP i SQL_TIMESTAMP) wymagane są dwa nowe typy danych w SQL Server Macierzysta ODBC klient do udostępnienia nowe typy serwerów:

• SQL_SS_TIME2

• SQL_TIMESTAMPOFFSET

W poniższej tabela przedstawiono mapowanie pełny typ serwera.Powiadomienie, że niektóre komórki w tabela zawiera dwa wpisy; w takich przypadkach pierwszą jest wartość ODBC 3.0, a drugi jest wartością ODBC 2.0.

Poniższa lista zawiera odpowiedniej struktury i typy ODBC C.Ponieważ ODBC nie zezwala na C typy zdefiniowane przez sterownik, SQL_C_BINARY jest używany do czas i datetimeoffset jako binarne struktur.

Po określeniu SQL_C_BINARY wiązanie będą wykonywane sprawdzanie wyrównanie i zgłosił błąd wyrównanie niepoprawne.SQLSTATE dla tego błędu będą IM016, z komunikatem "Niepoprawna struktura wyrównanie".

Formaty danych: Ciągi i literały

W poniższej tabela przedstawiono mapowania między SQL Server typy danych, typy danych ODBC, a literały ciągów znaków ODBC.

Dla data nie istnieją żadne zmiany w sekwencji unikowych ODBC / czas literałów.

Ułamków sekund w wynikach zawsze używać kropki (.), zamiast dwukropka (:)).

Ciąg wartości zwracanych do aplikacji zawsze mają tę samą długość dla danej kolumna.Rok, miesiąc, dzień, godzin, minut i drugiej części są wypełniane z wiodącymi zerami z ich maksymalną szerokość i jest pojedynczy odstęp między datą i czas daty czas wartości.Istnieje także jedną spację między czas i przesunięcie wartości datetimeoffset timezone.Przesunięcie timezone zawsze poprzedzone znakiem; Jeśli przesunięcie wynosi zero, ten znak jest znakiem plus (+).Ułamków sekund są wypełniane z końcowe zera w razie potrzeby do określonych precyzji kolumna.W przypadku kolumn typu Data/Godzina istnieją trzy cyfry ułamków sekund.Dla kolumn, smalldatetime są cyframi nie ułamków sekund, a sekundy będzie zawsze równa zero.

Pusty ciąg nie jest prawidłową data/czas literał i nie reprezentuje wartość NULL.Podjęto próbę konwersji pusty ciąg znaków do wartości data/godziny spowoduje błąd SQLState 22018 i komunikat "nieprawidłowy znak wartości dla specyfikacji rzutowania".

Podczas konwersji z parametry ciąg będzie oczekiwać, że ciągi znaków w tym samym formacie, z wyjątkiem znaku timezone godzin zero i zero minut może być albo plus lub minus i końcowe zera są dozwolone dla ułamków sekund maksymalnie 9 cyfr.Składnik czas mogą kończyć się z punktem dziesiętnym i nie cyfr ułamków sekund.

Obecnie sterownik pozwala dodatkowe światło wokół znaki interpunkcyjne i odstęp między przesunięcie czas i timezone jest opcjonalne.Jednak to mogą ulec zmianie w przyszłych wydaniach, aplikacje nie powinna polegać na bieżące zachowanie.

Formaty danych: Struktury danych

W strukturach opisane poniżej ODBC określa następujące ograniczenia, które są pobierane z kalendarza gregoriańskiego:

• Miesiąc zakres wynosi od 1 do 12.

• Dzień pole zakres to 1 do liczby dni w miesiącu i muszą być zgodne z pole rok i miesiąc, biorąc pod uwagę przestępnego.

• Godzina zakres wynosi od 0 do 23.

• Minuta zakres wynosi od 0 do 59.

• Sekund zakres wynosi od 0 do 61.9(n).Dzięki temu do dwóch sekund przestępnych zachować synchronizację z czas sideral.

  Należy zauważyć, że SQL Server nie zezwala na przestępnych sekund, co drugi większa niż 59 wartości spowoduje, że wystąpił błąd serwera.

Zmieniono do obsługi nowych implementacji dla następujących istniejących strukturach ODBC SQL Server Data i godzina typów danych. Definicje, jednak nie zostały zmienione.

• DATE_STRUCT

• TIME_STRUCT

• TIMESTAMP_STRUCT

Istnieją także dwa nowe strukturach:

• SQL_SS_TIME2_STRUCT

• SQL_SS_TIMESTAMPOFFSET_STRUCT

SQL_SS_TIME2_STRUCT

typedef struct tagSS_TIME2_STRUCT {
   SQLUSMALLINT hour;
   SQLUSMALLINT minute;
   SQLUSMALLINT second;
   SQLUINTEGER fraction;
} SQL_SS_TIME2_STRUCT;

SQL_SS_TIMESTAMPOFFSET_STRUCT

typedef struct tagSS_TIMESTAMPOFFSET_STRUCT {
   SQLSMALLINT year;
   SQLUSMALLINT month;
   SQLUSMALLINT day;
   SQLUSMALLINT hour;
   SQLUSMALLINT minute;
   SQLUSMALLINT second;
   SQLUINTEGER fraction;
   SQLSMALLINT timezone_hour;
   SQLSMALLINT timezone_minute;
} SQL_SS_TIMESTAMPOFFSET_STRUCT;

See Also

Concepts