Compartir a través de


Funciones canónicas de fecha y hora

Entity SQL incluye funciones canónicas de fecha y hora.

Comentarios

En la tabla siguiente se muestran las funciones canónicas de fecha y hora de Entity SQL. datetime es un DateTime valor.

Función Descripción
AddNanoseconds(expression,number) Agrega el number de nanosegundos especificado a expression.

Argumentos

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valor devuelto

Tipo de expression.
AddMicroseconds(expression,number) Agrega el objeto especificado number de microsegundos a expression.

Argumentos

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valor devuelto

Tipo de expression.
AddMilliseconds(expression,number) Agrega el objeto especificado number de milisegundos a expression.

Argumentos

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valor devuelto

Tipo de expression.
AddSeconds(expression,number) Agrega el objeto especificado number de segundos a expression.

Argumentos

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valor devuelto

Tipo de expression.
AddMinutes(expression,number) Agrega el objeto especificado number de minutos a expression.

Argumentos

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valor devuelto

Tipo de expression.
AddHours(expression,number) Agrega el objeto especificado number de horas a expression.

Argumentos

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valor devuelto

Tipo de expression.
AddDays(expression,number) Agrega el objeto especificado number de días a expression.

Argumentos

expression: DateTime o DateTimeOffset.

number: Int32.

Valor devuelto

Tipo de expression.
AddMonths(expression,number) Agrega el objeto especificado number de meses a expression.

Argumentos

expression: DateTime o DateTimeOffset.

number: Int32.

Valor devuelto

Tipo de expression.
AddYears(expression,number) Agrega el objeto especificado number de años a expression.

Argumentos

expression: DateTime o DateTimeOffset.

number: Int32.

Valor devuelto

Tipo de expression.
CreateDateTime(year,month,day,hour,minute,second) Devuelve un valor DateTime nuevo como fecha y hora actuales del servidor en la zona horaria del servidor.

Argumentos

year, month, day, hour, minute: Int16 y Int32.

second: Double.

Valor devuelto

Un objeto DateTime.
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset) Devuelve un valor DateTimeOffset nuevo como una fecha y hora del servidor relativo a la hora universal coordinada (UTC).

Argumentos

year, month, day, hour, minute, tzoffset: Int32.

second: Double.

Valor devuelto

Un objeto DateTimeOffset.
CreateTime(hour,minute,second) Devuelve un valor Time nuevo como la hora actual.

Argumentos

hour y minute: Int32.

second: Double.

Valor devuelto

Un objeto Time.
CurrentDateTime() Devuelve un valor DateTime como fecha y hora actuales del servidor en la zona horaria del servidor.

Valor devuelto

Un objeto DateTime.
CurrentDateTimeOffset() Devuelve la fecha, la hora y el desplazamiento actuales como un objeto DateTimeOffset.

Valor devuelto

Un objeto DateTimeOffset.
CurrentUtcDateTime() Devuelve un valor DateTime como fecha y hora actuales del servidor en la zona horaria UTC.

Valor devuelto

Un objeto DateTime.
Day(expression) Devuelve la parte de día de expression como un valor Int32 entre 1 y 31.

Argumentos

DateTime y DateTimeOffset.

Valor devuelto

Una clase Int32.

Ejemplo

-- The following example returns 12.

Day(cast('03/12/1998' as DateTime))
DayOfYear(expression) Devuelve la parte de día de expression como un objeto Int32 entre 1 y 366, donde 366 corresponde al último día de un año bisiesto.

Argumentos

DateTime o DateTimeOffset.

Valor devuelto

Una clase Int32.
DiffNanoseconds(startExpression,endExpression) Devuelve la diferencia, en nanosegundos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Una clase Int32.
DiffMilliseconds(startExpression,endExpression) Devuelve la diferencia, en milisegundos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Una clase Int32.
DiffMicroseconds(startExpression,endExpression) Devuelve la diferencia, en microsegundos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Una clase Int32.
DiffSeconds(startExpression,endExpression) Devuelve la diferencia, en segundos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Una clase Int32.
DiffMinutes(startExpression,endExpression) Devuelve la diferencia, en minutos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Una clase Int32.
DiffHours(startExpression,endExpression) Devuelve la diferencia, en horas, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Una clase Int32.
DiffDays(startExpression,endExpression) Devuelve la diferencia, en días, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime o DateTimeOffset. Nota: startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Una clase Int32.
DiffMonths(startExpression,endExpression) Devuelve la diferencia, en meses, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime o DateTimeOffset. Nota: startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Una clase Int32.
DiffYears(startExpression,endExpression) Devuelve la diferencia, en años, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime o DateTimeOffset. Nota: startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Una clase Int32.
GetTotalOffsetMinutes(datetimeoffset) Devuelve el número de minutos que constituyen el desplazamiento de datetimeoffset con respecto a GMT. Este valor está comprendido generalmente entre +780 y -780 (+ o - 13 horas). Nota: Esta función solo se admite en SQL Server 2008.

Argumentos

Un objeto DateTimeOffset.

Valor devuelto

Una clase Int32.
Hour(expression) Devuelve la parte de hora de expression como un valor Int32 entre 0 y 23.

Argumentos

DateTime, Time y DateTimeOffset.

Ejemplo

-- The following example returns 22.

Hour(cast('22:35:5' as DateTime))
Millisecond(expression) Devuelve la parte de milisegundos de expression como un valor Int32 entre 0 y 999.

Argumentos

DateTime, Time y DateTimeOffset.

Valor devuelto

Una clase Int32.
Minute(expression) Devuelve la parte de minutos de expression como un valor Int32 entre 0 y 59.

Argumentos

DateTime, Time o DateTimeOffset.

Valor devuelto

Una clase Int32.

Ejemplo

-- The following example returns 35

Minute(cast('22:35:5' as DateTime))
Month(expression) Devuelve la parte de mes de expression como un valor Int32 entre 1 y 12.

Argumentos

DateTime o DateTimeOffset.

Valor devuelto

Una clase Int32.

Ejemplo

-- The following example returns 3.

Month(cast('03/12/1998' as DateTime))
Second(expression) Devuelve la parte de segundos de expression como un valor Int32 entre 0 y 59.

Argumentos

DateTime, Time y DateTimeOffset.

Valor devuelto

Una clase Int32.

Ejemplo

-- The following example returns 5

Second(cast('22:35:5' as DateTime))
TruncateTime(expression) Devuelve expression, con los valores de tiempo truncados.

Argumentos

DateTime o DateTimeOffset.

Valor devuelto

Tipo de expression.
Year(expression) Devuelve la parte de año de expression como un valor Int32 YYYY.

Argumentos

DateTime y DateTimeOffset.

Valor devuelto

Una clase Int32.

Ejemplo

-- The following example returns 1998.

Year(cast('03/12/1998' as DateTime))

Estas funciones devolverán null si se proporciona la entrada null.

La funcionalidad equivalente está disponible en el proveedor administrado de Microsoft SQL Client. Para obtener más información, consulte SqlClient para funciones de Entity Framework.

Consulte también