TRY_PARSE (Transact-SQL)

Возвращает результат выражения, преобразованный в запрошенный тип данных, или значение NULL, если привести тип в SQL Server не удается. Используйте инструкцию TRY_PARSE только для преобразования данных из строкового типа в типы даты или времени и числовые типы.

Синтаксические обозначения в Transact-SQL

Синтаксис

TRY_PARSE ( string_value AS data_type [ USING culture ] )

Аргументы

• string_value
  Значение nvarchar(4000), представляющее форматированное значение для преобразования в указанный тип данных.

  string_value должно быть допустимым представлением требуемого типа данных, или инструкция TRY_PARSE возвратит значение NULL.

• data_type
  Литерал, представляющий тип данных, запрошенный в качестве результата.

• culture
  Дополнительная строка, идентифицирующая язык и региональные параметры, в которых форматируется string_value.

  Если аргумент culture не указан, то используется язык текущего сеанса. Язык может быть задан неявно или явно с использованием инструкции SET LANGUAGE. Значение culture принимает любой язык и региональные параметры, поддерживаемые .NET Framework; его применение не ограничивается языками, явно поддерживаемыми SQL Server. Если аргумент culture недопустим, инструкция PARSE выдаст ошибку.

Типы возвращаемых данных

Возвращает результат выражения, преобразованный в запрошенный тип данных, или значение NULL, если привести тип не удается.

Замечания

Используйте инструкцию TRY_PARSE только для преобразования данных из строкового типа в типы даты или времени и числовые типы. Для общих преобразований типов данных продолжайте использовать CAST и CONVERT. Следует учитывать, что разбор строкового значения приводит к некоторой потере производительности.

Для выполнения инструкции TRY_PARSE требуется среда CLR платформы .NET Framework.

Данная функция не будет работать удаленно, поскольку возможность ее работы зависит от наличия среды CLR. Удаленный вызов функции, требующей наличия среды CLR, приведет к ошибке на удаленном сервере.

Дополнительные сведения о параметре data_type

Значения параметра data_type ограничиваются списком типов, приведенным в следующей таблице, включая стили. Представленные сведения о стилях позволяют определить, какие типы шаблонов разрешены. Дополнительные сведения о стилях см. в документации по .NET Framework для перечислений System.Globalization.NumberStyles и DateTimeStyles.

Дополнительные сведения о параметре культуры

В следующей таблице показаны сопоставления между языками SQL Server и культурами платформы .NET Framework.

Примеры

А.Простой пример использования TRY_PARSE

SELECT TRY_PARSE('Jabberwokkie' AS datetime2 USING 'ru-RU') AS Result;

Ниже приводится результирующий набор.

Result
---------------
NULL

(1 row(s) affected)

Б.Обнаружение значений NULL с помощью TRY_PARSE

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

Ниже приводится результирующий набор.

Result
---------------
True

(1 row(s) affected)

В.Использование функции IIF с TRY_PARSE и неявная установка культуры

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

Ниже приводится результирующий набор.

Result
---------------
False

(1 row(s) affected)

См. также

Справочник

PARSE (Transact-SQL)

Функции преобразования (Transact-SQL)

TRY_CONVERT (Transact-SQL)

Функции CAST и CONVERT (Transact-SQL)