Datos de fecha y hora

SQL Server 2008 ha incorporado nuevos tipos de datos para administrar la información sobre la fecha y hora. Los nuevos tipos de datos incluyen tipos independientes para la fecha y la hora y tipos de datos expandidos con mayor control sobre el intervalo, la precisión y la zona horaria. A partir de .NET Framework versión 3.5 Service Pack (SP) 1, el proveedor de datos .NET Framework para SQL Server (System.Data.SqlClient) proporciona compatibilidad total con todas las características nuevas del Motor de base de datos de SQL Server 2008. Debe instalar .NET Framework 3.5 SP1 (o posterior) para usar estas características nuevas con SqlClient.

Las versiones de SQL Server anteriores a SQL Server 2008 solo tenían dos tipos de datos para trabajar con valores de fecha y hora: datetime y smalldatetime. Ambos tipos de datos contienen el valor de fecha y el valor de hora, lo que dificulta trabajar solo con valores de fecha o de hora. Además, estos tipos de datos solo admiten las fechas posteriores a la introducción del calendario gregoriano en Inglaterra en 1753. Otra limitación es que estos tipos de datos más antiguos no reconocen la zona horaria, por lo que resulta difícil trabajar con datos que proceden de varias zonas horarias.

Para obtener más información acerca de los tipos de fecha y hora en SQL Server, vea Tipos de datos y funciones de fecha y hora (Transact-SQL).

Tipos de datos de fecha y hora introducidos en SQL Server 2008

En la tabla siguiente se describen los nuevos tipos de datos de fecha y hora.

Formato de fecha y orden de la fecha

La forma en que SQL Server analiza los valores de fecha y hora no solo depende de la versión del sistema de tipos y de la versión del servidor, sino también de la configuración de formato e idioma predeterminados del servidor. Una cadena de fecha que funcione para los formatos de fecha de un idioma podría ser irreconocible si la consulta se ejecuta por una conexión que utiliza una configuración de formato de fecha e idioma diferente.

La instrucción SET LANGUAGE de Transact-SQL establece implícitamente DATEFORMAT, que determina el orden de las partes de la fecha. Puede usar la instrucción SET DATEFORMAT de Transact-SQL en una conexión para eliminar la ambigüedad de los valores de fecha ordenando las partes de fecha según MDA, DMA, AMD, ADM, MAD o DAM.

Si no especifica ningún valor DATEFORMAT para la conexión, SQL Server utiliza el idioma predeterminado asociado a la conexión. Por ejemplo, una cadena de fecha de "01/02/03" se interpretaría como MDA (2 de enero de 2003) en un servidor con una configuración de idioma de inglés de Estados Unidos y como DMA (1 de febrero de 2003) en un servidor con una configuración de idioma de inglés británico. El año se determina mediante el uso de la regla del año límite de SQL Server, que define la fecha límite para asignar el valor del siglo. Para obtener más información, vea la opción two year cutoff.

Para obtener más información sobre cómo SQL Server interpreta los datos de fecha y hora, vea el tema Usar datos de fecha y hora.

Tipos de datos de fecha y hora y parámetros

Se han agregado los siguientes valores de enumeración a SqlDbType para admitir los nuevos tipos de datos de fecha y hora.

• SqlDbType.Date

• SqlDbType.Time

• SqlDbType.DateTime2

• SqlDbType.DateTimeOffSet

Puede especificar el tipo de datos de SqlParameter mediante una de las enumeraciones SqlDbType anteriores.

También puede especificar el tipo de SqlParameter de forma genérica si establece la propiedad DbType de un objeto SqlParameter en un determinado valor de enumeración DbType. Se han agregado los siguientes valores de enumeración a DbType para admitir los tipos de datos datetime2 y datetimeoffset:

• DbType.DateTime2

• DbType.DateTimeOffset

Estas nuevas enumeraciones complementan las enumeraciones Date, Time y DateTime, que ya existían en versiones anteriores de .NET Framework.

El tipo del proveedor de datos .NET Framework de un objeto de parámetro se deduce a partir del tipo de .NET Framework del valor del objeto de parámetro o a partir de la enumeración DbType del objeto de parámetro. No se han introducido nuevos tipos de datos de System.Data.SqlTypes para admitir los nuevos tipos de datos de fecha y hora. En la tabla siguiente se describen las asignaciones entre los tipos de datos de fecha y hora de SQL Server 2008 y los tipos de datos de CLR.

Propiedades de SqlParameter

En la tabla siguiente se describen las propiedades SqlParameter que son pertinentes para los tipos de datos de fecha y hora.

Crear parámetros

Para crear un objeto SqlParameter, se puede usar su constructor o bien se puede agregar a una colección SqlCommandParameters mediante una llamada al método Add de la colección SqlParameterCollection. El método Add tomará como entrada los argumentos del constructor o un objeto de parámetro existente.

En las secciones siguientes de este tema se proporcionan ejemplos de cómo especificar parámetros de fecha y hora. Para obtener ejemplos adicionales de cómo trabajar con parámetros, vea Configurar parámetros y tipos de datos de parámetros y parámetros DataAdapter.

Ejemplo de date

El fragmento de código siguiente muestra cómo se especifica un parámetro date.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@Date";
parameter.SqlDbType = SqlDbType.Date;
parameter.Value = "2007/12/1";

Dim parameter As New SqlParameter()
parameter.ParameterName = "@Date"
parameter.SqlDbType = SqlDbType.Date
parameter.Value = "2007/12/1"

Ejemplo de time

El fragmento de código siguiente muestra cómo se especifica un parámetro time.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@time";
parameter.SqlDbType = SqlDbType.Time;
parameter.Value = DateTime.Parse("23:59:59").TimeOfDay;

Dim parameter As New SqlParameter()
parameter.ParameterName = "@Time"
parameter.SqlDbType = SqlDbType.Time
parameter.Value = DateTime.Parse("23:59:59").TimeOfDay;

Ejemplo de datetime2

En el fragmento de código siguiente se muestra cómo especificar un parámetro datetime2 con las partes de fecha y hora.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@Datetime2";
parameter.SqlDbType = SqlDbType.DateTime2;
parameter.Value = DateTime.Parse("1666-09-02 1:00:00");

Dim parameter As New SqlParameter()
parameter.ParameterName = "@Datetime2"
parameter.SqlDbType = SqlDbType.DateTime2
parameter.Value = DateTime.Parse("1666-09-02 1:00:00");

Ejemplo de DateTimeOffSet

En el fragmento de código siguiente se muestra cómo especificar un parámetro DateTimeOffSet con una fecha, una hora y un ajuste de zona horaria de 0.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@DateTimeOffSet";
parameter.SqlDbType = SqlDbType.DateTimeOffSet;
parameter.Value = DateTimeOffset.Parse("1666-09-02 1:00:00+0");

Dim parameter As New SqlParameter()
parameter.ParameterName = "@DateTimeOffSet"
parameter.SqlDbType = SqlDbType.DateTimeOffSet
parameter.Value = DateTimeOffset.Parse("1666-09-02 1:00:00+0");

AddWithValue

También puede proporcionar parámetros mediante el método AddWithValue de un SqlCommand, como se muestra en el fragmento de código siguiente. Sin embargo, el método AddWithValue no permite especificar el valor DbType o SqlDbType para el parámetro.

command.Parameters.AddWithValue(
    "@date", DateTimeOffset.Parse("16660902"));

command.Parameters.AddWithValue( _
    "@date", DateTimeOffset.Parse("16660902"))

El parámetro @date podría asignarse a un tipo de datos date, datetime o datetime2 en el servidor. Al trabajar con los nuevos tipos de datos de datetime, debe establecer explícitamente la propiedad SqlDbType del parámetro en el tipo de datos de la instancia. El uso de Variant o el suministro implícito de valores de parámetros puede causar problemas de compatibilidad con versiones anteriores de los tipos de datos datetime y smalldatetime.

En la tabla siguiente se muestra qué valores SqlDbTypes se deducen a partir de los tipos de CLR:

Recuperar datos de fecha y hora

En la tabla siguiente se describen los métodos que se usan para recuperar valores de fecha y hora de SQL Server 2008.

Especificar valores de fecha y hora como literales

Puede especificar tipos de datos de fecha y hora mediante una variedad de diferentes formatos de cadena literales, que SQL Server evalúa luego en el entorno de ejecución, convirtiéndolos en estructuras de fecha y hora internas. SQL Server reconoce los datos de fecha y hora que se incluyen entre comillas simples ('). Los ejemplos siguientes demuestran algunos formatos:

• Formatos de fecha alfabéticos, como 'October 15, 2006'.

• Formatos de fecha numéricos, como '10/15/2006'.

• Formatos de cadena no separados, como '20061015', que se interpretarán como 15 de octubre de 2006 si usa el formato de fecha estándar ISO.

Los valores de hora que son menores que cero o mayores o iguales que 24 horas producirán una excepción ArgumentException.

recursos documentales de SQL Server

Para obtener más información sobre cómo trabajar con valores de fecha y hora en SQL Server, vea los artículos siguientes.

Consulte también

• Asignaciones de tipos de datos de SQL Server
• Configurar parámetros y tipos de datos de parámetros
• Tipos de datos de SQL Server y ADO.NET
• Información general de ADO.NET