TRY_PARSE (T-SQL)

Berlaku untuk:SQL ServerDatabase Azure SQLInstans Terkelola Azure SQLAzure Synapse AnalyticsTitik akhir analitik SQL di Microsoft FabricGudang di Microsoft FabricDatabase SQL di Microsoft Fabric

Mengembalikan hasil ekspresi, diterjemahkan ke jenis data yang diminta, atau null jika pemeran gagal di SQL Server. Gunakan TRY_PARSE hanya untuk mengonversi dari string ke tanggal/waktu dan jenis angka.

Konvensi sintaks transact-SQL

Sintaks

TRY_PARSE ( string_value AS data_type [ USING culture ] )  

Argumen

string_value
nilai nvarchar(4000) yang mewakili nilai yang diformat untuk diurai ke dalam jenis data yang ditentukan.

string_value harus berupa representasi yang valid dari jenis data yang diminta, atau TRY_PARSE mengembalikan null.

data_type
Literal yang mewakili jenis data yang diminta untuk hasilnya.

budaya
String opsional yang mengidentifikasi budaya tempat string_value diformat.

Jika argumen budaya tidak disediakan, bahasa sesi saat ini digunakan. Bahasa ini diatur secara implisit atau eksplisit dengan menggunakan pernyataan SET LANGUAGE. budaya menerima budaya apa pun yang didukung oleh .NET Framework; tidak terbatas pada bahasa yang secara eksplisit didukung oleh SQL Server. Jika argumen budaya tidak valid, PARSE akan menimbulkan kesalahan.

Jenis Kembalian

Mengembalikan hasil ekspresi, diterjemahkan ke jenis data yang diminta, atau null jika pemeran gagal.

Keterangan

Gunakan TRY_PARSE hanya untuk mengonversi dari string ke tanggal/waktu dan jenis angka. Untuk konversi jenis umum, terus gunakan CAST atau CONVERT. Perlu diingat bahwa ada overhead performa tertentu dalam mengurai nilai string.

TRY_PARSE bergantung pada keberadaan .net Framework Common Language Runtime (CLR).

Fungsi ini tidak akan di-remote karena tergantung pada keberadaan CLR. Jarak jauh fungsi yang memerlukan CLR akan menyebabkan kesalahan pada server jarak jauh.

Informasi selengkapnya tentang parameter data_type

Nilai untuk parameter data_type dibatasi untuk jenis yang diperlihatkan dalam tabel berikut, bersama dengan gaya. Informasi gaya disediakan untuk membantu menentukan jenis pola apa yang diizinkan. Untuk informasi selengkapnya tentang gaya, lihat dokumentasi .NET Framework untuk enumerasi System.Globalization.NumberStyles dan DateTimeStyles .

Kategori	Jenis	Jenis .NET	Gaya yang digunakan
Numerik	bigint	Int64	NumberStyles.Number
Numerik	int	Int32	NumberStyles.Number
Numerik	smallint	Int16	NumberStyles.Number
Numerik	tinyint	Byte	NumberStyles.Number
Numerik	desimal	Decimal	NumberStyles.Number
Numerik	numeric	Decimal	NumberStyles.Number
Numerik	float	Laju	NumberStyles.Float
Numerik	real	Tunggal	NumberStyles.Float
Numerik	smallmoney	Decimal	NumberStyles.Currency
Numerik	money	Decimal	NumberStyles.Currency
Tanggal dan Waktu	date	DateTime	DateTimeStyles.AllowWhiteSpaces | TanggalWaktuGaya.AsumsiUniversal
Tanggal dan Waktu	waktu	TimeSpan	DateTimeStyles.AllowWhiteSpaces | TanggalWaktuGaya.AsumsiUniversal
Tanggal dan Waktu	tanggalwaktu	DateTime	DateTimeStyles.AllowWhiteSpaces | TanggalWaktuGaya.AsumsiUniversal
Tanggal dan Waktu	smalldatetime	DateTime	DateTimeStyles.AllowWhiteSpaces | TanggalWaktuGaya.AsumsiUniversal
Tanggal dan Waktu	tanggalwaktu2	DateTime	DateTimeStyles.AllowWhiteSpaces | TanggalWaktuGaya.AsumsiUniversal
Tanggal dan Waktu	tanggalwaktulewat	DateTimeOffset	DateTimeStyles.AllowWhiteSpaces | TanggalWaktuGaya.AsumsiUniversal

Informasi selengkapnya tentang parameter budaya

Tabel berikut ini memperlihatkan pemetaan dari bahasa SQL Server ke budaya .NET Framework.

Nama lengkap	Alias	LCID	Budaya tertentu
us_english	Inggris	1033	id-ID
Deutsch	Jerman	1031	de-DE
Français	Prancis	1036	fr-FR
日本語	Jepang	1041	ja-JP
Dansk	Dansk	1030	da-DK
Español	Spanyol	3082	es-ES
Italiano	Italia	1040	it-IT
Nederlands	Belanda	1043	nl-NL
Norsk	Norwegia	2068	nn-NO
Português	Portugis	2070	pt-PT
Suomi	Suomi	1035	fi-FI
Svenska	Swedia	1053	sv-SE
čeština	Cheska	1029	Cs-CZ
magyar	Hungaria	1038	Hu-HU
polski	Polski	1045	Pl-PL
română	Rumania	1048	Ro-RO
hrvatski	Kroasia	1050	hr-HR
slovenčina	Slovak	1051	Sk-SK
slovenski	Sloven	1060	Sl-SI
ελληνικά	Yunani	1032	El-GR
български	Bulgaria	1026	bg-BG
русский	Rusia	1049	Ru-RU
Türkçe	Turki	1055	Tr-TR
Inggris	Inggris Inggris	2057	en-GB
eesti	Esti	1061	Et-EE
latviešu	Latvi	1062	lv-LV
lietuvių	Lituavi	1063	lt-LT
Português (Brasil)	Brasil	1046	pt-BR
繁體中文	Mandarin Tradisional	1028	zh-TW
한국어	Korea	1042	Ko-KR
简体中文	Bahasa Tionghoa Sederhana	2052	zh-CN
Arab	Arab	1025	ar-SA
ไทย	Thailand	1054	Th-TH

Contoh

J. Contoh sederhana TRY_PARSE

SELECT TRY_PARSE('Jabberwokkie' AS datetime2 USING 'en-US') AS Result;  

Berikut set hasilnya.

Result  
---------------  
NULL  
  
(1 row(s) affected)  

B. Mendeteksi null dengan TRY_PARSE

SELECT  
    CASE WHEN TRY_PARSE('Aragorn' AS decimal USING 'sr-Latn-CS') IS NULL  
        THEN 'True'  
        ELSE 'False'  
END  
AS Result;  

Berikut set hasilnya.

Result  
---------------  
True  
  
(1 row(s) affected)  

C. Menggunakan IIF dengan pengaturan budaya TRY_PARSE dan implisit

SET LANGUAGE English;  
SELECT IIF(TRY_PARSE('01/01/2011' AS datetime2) IS NULL, 'True', 'False') AS Result;

Berikut set hasilnya.

Result  
---------------  
False  
  
(1 row(s) affected)  

Lihat Juga

PARSE (Transact-SQL)
Fungsi Konversi (Transact-SQL)
TRY_CONVERT (T-SQL)
CAST dan CONVERT (Transact-SQL)