PARSE (Transact-SQL)

Devuelve el resultado de una expresión, traducido al tipo de datos solicitado en SQL Server 2012.

Convenciones de sintaxis de Transact-SQL

Sintaxis

PARSE ( string_value AS data_type [ USING culture ] )

Argumentos

• string_value
  Valor nvarchar(4000) que representa el valor con formato que se va a analizar en el tipo de datos especificado.

  string_value debe ser una representación válida del tipo de datos solicitado; de lo contrario, PARSE produce un error.

• data_type
  Valor literal que representa el tipo de datos solicitado para el resultado.

• culture
  Cadena opcional que identifica la referencia cultural en la que se da formato a string_value.

  Si no se proporciona el argumento culture, se usará el idioma de la sesión actual. Este idioma se establece implícitamente, o explícitamente mediante la instrucción SET LANGUAGE. culture acepta cualquier referencia cultural compatible con .NET Framework; no se limita a los idiomas admitidos explícitamente por SQL Server. Si el argumento culture no es válido, PARSE produce un error.

Tipos de valor devuelto

Devuelve el resultado de la expresión, traducido al tipo de datos solicitado.

Comentarios

Los valores NULL que se pasan como argumentos a PARSE se tratan de dos maneras:

1. Si se pasa una constante NULL, se produce un error. Un valor NULL no se puede analizar en otro tipo de datos diferente teniendo en cuenta la referencia cultural.

2. Si se pasa un parámetro con un valor NULL en tiempo de ejecución, se devuelve un valor NULL para evitar que se cancele todo el lote.

Use PARSE solo para convertir de tipos de cadena a tipos de fecha y hora y de número. Para las conversiones de tipos generales, siga usando CAST o CONVERT. Tenga en cuenta que hay cierta sobrecarga de rendimiento al analizar el valor de cadena.

PARSE se basa en la presencia de Common Language Runtime (CLR) de .NET Framework.

Esta función no se enviará de forma remota puesto que depende de la presencia del CLR. El envío remoto de una función que necesita el CLR produciría un error en el servidor remoto.

Más información acerca del parámetro data_type

Los valores del parámetro data_type están restringidos a los tipos que aparecen en la tabla siguiente, junto con estilos. La información de estilo se proporciona como ayuda para determinar los tipos de modelos permitidos. Para obtener más información acerca de los estilos, vea las enumeraciones System.Globalization.NumberStyles y DateTimeStyles en la documentación de .NET Framework.

Más información acerca del parámetro culture

En la tabla siguiente se muestran las asignaciones de los idiomas de SQL Server a las referencias culturales de .NET Framework.

Ejemplos

A.PARSE en datetime2

SELECT PARSE('Monday, 13 December 2010' AS datetime2 USING 'en-US') AS Result;

El conjunto de resultados es el siguiente.

Result
---------------
2010-12-13 00:00:00.0000000

(1 row(s) affected)

B.PARSE con símbolo de moneda

SELECT PARSE('€345,98' AS money USING 'de-DE') AS Result;

El conjunto de resultados es el siguiente.

Result
---------------
345.98

(1 row(s) affected)

C.PARSE con configuración implícita de idioma

-- The English language is mapped to en-US specific culture
SET LANGUAGE 'English';
SELECT PARSE('12/16/2010' AS datetime2) AS Result;

El conjunto de resultados es el siguiente.

Result
---------------
2010-12-16 00:00:00.0000000

(1 row(s) affected)