Compartir vía


Funciones de fecha y hora

El proveedor de datos de .NET Framework para SQL Server (SqlClient) proporciona funciones de fecha y hora que realizan operaciones en un valor de entrada System.DateTime y devuelven un resultado string, numérico o un valor System.DateTime. Estas funciones están en el espacio de nombres SqlServer, que está disponible cuando se usa SqlClient. La propiedad de espacio de nombres de un proveedor permite a Entity Framework detectar qué prefijo usa este proveedor para construcciones específicas, como tipos y funciones. En la tabla siguiente se muestran las funciones de fecha y hora sqlClient.

Función Descripción
DATEADD(datepart, number, date) Devuelve un valor DateTime nuevo que se basa en sumar un intervalo a la fecha especificada.

Argumentos

datepart: valor de tipo String que representa qué parte de la fecha se devuelve como el valor nuevo.

number: el Int32, el Int64, el Decimal, o el Double valor utilizado para incrementar datepart.

date: Expresión que devuelve un DateTime, o DateTimeOffset, o Time con precisión = [0-7] o una cadena de caracteres en un formato de fecha.

Valor Devuelto

Un nuevo valor de DateTime, DateTimeOffset, o Time con precisión = [0-7].

Ejemplo

SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime))
DATEDIFF(datepart,startdate,enddate) Devuelve el número de límites de fecha y hora entre dos fechas especificadas.

Argumentos

datepart: String que representa la parte de la fecha para calcular la diferencia.

startdate: una fecha de inicio para el cálculo es una expresión que devuelve un DateTimevalor , o DateTimeOffset, o Time con precisión = [0-7] o una cadena de caracteres en un formato de fecha.

enddate: Una fecha de finalización para el cálculo es una expresión que devuelve un DateTimevalor , o DateTimeOffset, o Time con precisión = [0-7] o una cadena de caracteres en un formato de fecha.

Valor Devuelto

Un Int32.

Ejemplo

SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),

cast('6/20/2006' as DateTime))
DATENAME(datepart, date) Devuelve una cadena de caracteres que representa la parte especificada de una fecha determinada.

Argumentos

datepart: valor de tipo String que representa qué parte de la fecha se devuelve como el valor nuevo.

date: expresión que devuelve un valor DateTime, o un valor DateTimeOffset, o un valor Time con una precisión = [0-7], o una cadena de caracteres en formato de fecha.

Valor Devuelto

La cadena de caracteres que representa el datepart especificado de la fecha especificada.

Ejemplo

SqlServer.DATENAME('year', cast('6/9/2006' as DateTime))
DATEPART(datepart, date) Devuelve un número entero que representa el Datepart especificado de la fecha dada.

Argumentos

datepart: valor de tipo String que representa qué parte de la fecha se devuelve como el valor nuevo.

date: una expresión que devuelve un valor DateTime,, DateTimeOffset, o Time con una precisión de [0-7], o una cadena de caracteres en un formato de fecha.

Valor Devuelto

El datepart especificado de la fecha especificada como un valor de tipo Int32.

Ejemplo

SqlServer.DATEPART('year', cast('6/9/2006' as DateTime))
DAY(date) Devuelve el día de la fecha especificada como un entero.

Argumentos

date:Expresión de tipo DateTime o DateTimeOffset con precisión = 0-7.

Valor Devuelto

Día de la fecha especificada como un valor de tipo Int32.

Ejemplo

SqlServer.DAY(cast('6/9/2006' as DateTime))
GETDATE() Genera la fecha y hora actuales en el formato interno de SQL Server para los valores datetime.

Valor Devuelto

La fecha y hora actuales del sistema como DateTime con una precisión de 3.

Ejemplo

SqlServer.GETDATE()
GETUTCDATE() Genera el valor datetime en formato UTC (hora universal coordinada o hora media de Greenwich).

Valor Devuelto

Valor DateTime con una precisión de 3 en formato UTC.

Ejemplo

SqlServer.GETUTCDATE()
MONTH(date) Devuelve el mes de la fecha especificada como un entero.

Argumentos

date:Expresión de tipo DateTime o DateTimeOffset con precisión = 0-7.

Valor Devuelto

Mes de la fecha especificada como un Int32.

Ejemplo

SqlServer.MONTH(cast('6/9/2006' as DateTime))
YEAR(date) Devuelve el año de la fecha especificada como un entero.

Argumentos

date:Expresión de tipo DateTime o DateTimeOffset con precisión = 0-7.

Valor Devuelto

Año de la fecha especificada como un valor de tipo Int32.

Ejemplo

SqlServer.YEAR(cast('6/9/2006' as DateTime))
SYSDATETIME() Devuelve un DateTime valor con una precisión de 7.

Valor Devuelto

Valor DateTime con una precisión de 7.

Ejemplo

SqlServer.SYSDATETIME()
SYSUTCDATE() Genera el valor datetime en formato UTC (hora universal coordinada o hora media de Greenwich).

Valor Devuelto

El valor DateTime con una precisión de 7 en formato UTC.

Ejemplo

SqlServer.SYSUTCDATE()
SYSDATETIMEOFFSET() Devuelve un valor DateTimeOffset con una precisión de 7.

Valor Devuelto

Valor DateTimeOffset con precisión de 7 en formato UTC.

Ejemplo

SqlServer.SYSDATETIMEOFFSET()

Para obtener más información sobre las funciones de fecha y hora compatibles con SqlClient, vea Tipos de datos y funciones de fecha y hora (Transact-SQL).

Consulte también