Bagikan melalui


Konversi (OLE DB)

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Unduh driver OLE DB

Bagian ini membahas cara mengonversi antara nilai datetime dan datetimeoffset . Konversi yang dijelaskan di bagian ini sudah disediakan oleh OLE DB atau merupakan ekstensi OLE DB yang konsisten.

Format literal dan string untuk tanggal dan waktu dalam OLE DB umumnya mengikuti ISO, dan tidak tergantung pada lokal klien. Satu pengecualian adalah DBTYPE_DATE, di mana standarnya adalah OLE Automation. Namun, karena Driver OLE DB untuk SQL Server hanya mengonversi antara jenis ketika data dikirimkan ke atau dari klien, tidak ada cara bagi aplikasi untuk memaksa Driver OLE DB untuk SQL Server untuk mengonversi antara format DBTYPE_DATE dan string. Jika tidak, string menggunakan format berikut (teks dalam tanda kurung menunjukkan elemen opsional):

  • Format string datetime dan datetimeoffset adalah:

    yyyy-mm-dd[ hh:mm:ss[.9999999][ ± hh:mm]]

  • Format string waktu adalah:

    hh:mm:ss[.9999999]

  • Format string tanggal adalah:

    yyyy-mm-dd

Catatan

Versi sebelumnya dari SQL Server Native Client dan SQLOLEDB menerapkan konversi OLE, jika konversi standar gagal. Driver OLE DB untuk SQL Server mengikuti perilaku yang sama dengan SQL Server Native Client. Akibatnya, beberapa konversi yang dilakukan oleh Driver OLE DB untuk SQL Server berbeda dari spesifikasi OLE DB.

Konversi dari string memungkinkan fleksibilitas dalam spasi kosong dan lebar bidang. Untuk informasi selengkapnya, lihat bagian "Format Data: String dan Literal" di Dukungan Jenis Data untuk Peningkatan Tanggal dan Waktu OLE DB.

Berikut ini adalah aturan konversi umum:

  • Saat string dikonversi ke jenis tanggal/waktu, string pertama-tama diurai sebagai literal ISO. Jika gagal, string diurai sebagai literal tanggal OLE, yang memiliki komponen waktu.

  • Jika tidak ada waktu tetapi penerima dapat menyimpan waktu, waktu diatur ke nol. Jika tidak ada tanggal yang ada tetapi penerima dapat menyimpan tanggal, tanggal diatur ke tanggal saat ini saat konversi ISO digunakan dan ke 1899-12-30 saat konversi OLE digunakan.

  • Jika tidak ada zona waktu yang ada dalam jenis data yang digunakan klien, tetapi server dapat menyimpan zona waktu, data pada klien diasumsikan berada di zona waktu klien.

  • Jika tidak ada zona waktu yang ada di server tetapi klien memiliki informasi zona waktu, zona waktu UTC diasumsikan. Ini berbeda dari perilaku server.

  • Jika waktu ada tetapi penerima tidak dapat menyimpan waktu, komponen waktu diabaikan.

  • Jika tanggal ada tetapi penerima tidak dapat menyimpan tanggal, komponen tanggal diabaikan.

  • Jika pemotongan detik atau detik pecahan terjadi saat mengonversi dari klien ke server, DB_E_ERRORSOCCURRED dikembalikan dan status DBSTATUS_E_DATAOVERFLOW diatur.

  • Jika pemotongan detik atau detik pecahan terjadi saat mengonversi dari server ke klien, DBSTATUS_S_TRUNCATED diatur

Di Bagian Ini

Konversi Yang Dilakukan dari Klien ke Server
Menjelaskan konversi tanggal/waktu yang dilakukan antara aplikasi klien yang ditulis dengan Driver OLE DB untuk SQL Server 2008 (10.0.x) dan versi yang lebih baru.

Konversi Yang Dilakukan dari Server ke Klien
Menjelaskan konversi tanggal/waktu yang dilakukan antara SQL Server 2008 (10.0.x) dan versi yang lebih baru, dan aplikasi klien yang ditulis dengan Driver OLE DB untuk SQL Server.

Lihat Juga

Peningkatan Tanggal dan Waktu (OLE DB)