Funciones canónicas de fecha y hora (Entity SQL)

  • Artículo

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

Notas

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

Función Descripción

AddNanoseconds( expression, number)

Agrega el objeto especificado number de nanosegundos 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

Valor de tipo 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

Valor de tipo DateTimeOffset.

CreateTime( hour, minute, second)

Devuelve un valor Time nuevo como la hora actual.

Argumentos

hour y minute: Int32.

second: Double.

Valor devuelto

Valor de tipo Time.

CurrentDateTime()

Devuelve un valor DateTime como fecha y hora actuales del servidor en la zona horaria del servidor.

Valor devuelto

Valor de tipo DateTime.

CurrentDateTimeOffset()

Devuelve la fecha, la hora y el desplazamiento actuales como un objeto DateTimeOffset.

Valor devuelto

Valor de tipo DateTimeOffset.

CurrentUtcDateTime()

Devuelve un valor DateTime como fecha y hora actuales del servidor en la zona horaria UTS.

Valor devuelto

Valor de tipo DateTime.

Day( expression )

Devuelve la parte de día de expression como un valor Int32 entre 1 y 31.

Argumentos

Valor de tipo DateTime y DateTimeOffset.

Valor devuelto

Valor de tipo 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

Valor DateTime o DateTimeOffset.

Valor devuelto

Valor de tipo Int32.

DiffNanoseconds( startExpression, endExpression)

Devuelve la diferencia, en nanosegundos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(es-es,VS.100).gifNota:
startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Valor de tipo Int32.

DiffMilliseconds( startExpression, endExpression)

Devuelve la diferencia, en milisegundos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(es-es,VS.100).gifNota:
startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Valor de tipo Int32.

DiffMicroseconds( startExpression, endExpression)

Devuelve la diferencia, en microsegundos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(es-es,VS.100).gifNota:
startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Valor de tipo Int32.

DiffSeconds( startExpression, endExpression)

Devuelve la diferencia, en segundos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(es-es,VS.100).gifNota:
startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Valor de tipo Int32.

DiffMinutes( startExpression, endExpression)

Devuelve la diferencia, en minutos, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(es-es,VS.100).gifNota:
startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Valor de tipo Int32.

DiffHours( startExpression, endExpression)

Devuelve la diferencia, en horas, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(es-es,VS.100).gifNota:
startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Valor de tipo Int32.

DiffDays( startExpression, endExpression)

Devuelve la diferencia, en días, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime o DateTimeOffset.

Bb738563.note(es-es,VS.100).gifNota:
startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Valor de tipo Int32.

DiffMonths( startExpression, endExpression)

Devuelve la diferencia, en meses, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime o DateTimeOffset.

Bb738563.note(es-es,VS.100).gifNota:
startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Valor de tipo Int32.

DiffYears( startExpression, endExpression)

Devuelve la diferencia, en años, entre startExpression y endExpression.

Argumentos

startExpression, endExpression: DateTime o DateTimeOffset.

Bb738563.note(es-es,VS.100).gifNota:
startExpression y endExpression deben ser del mismo tipo.

Valor devuelto

Valor de tipo 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).

Bb738563.note(es-es,VS.100).gifNota:
Esta función solo se admite en SQL Server 2008.

Argumentos

Valor de tipo DateTimeOffset.

Valor devuelto

Valor de tipo Int32.

Hour ( expression )

Devuelve la parte de hora de expression como un valor Int32 entre 0 y 23.

Argumentos

Valor de tipo DateTime, Time o 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

Valor de tipo DateTime, Time o DateTimeOffset.

Valor devuelto

Valor de tipo Int32.

Minute( expression )

Devuelve la parte de minutos de expression como un valor Int32 entre 0 y 59.

Argumentos

Valor DateTime, Time o DateTimeOffset.

Valor devuelto

Valor de tipo 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

Valor DateTime o DateTimeOffset.

Valor devuelto

Valor de tipo 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

Valor de tipo DateTime, Time y DateTimeOffset.

Valor devuelto

Valor de tipo Int32.

Ejemplo

-- The following example returns 5

Second(cast('22:35:5' as DateTime))

Truncate( expression )

Devuelve expression, con los valores de tiempo truncados.

Argumentos

Valor DateTime o DateTimeOffset.

Valor devuelto

Tipo de expression.

Year( expression )

Devuelve la parte de año de expression como un valor Int32 YYYY.

Argumentos

Valor de tipo DateTime y DateTimeOffset.

Valor devuelto

Valor de tipo 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, vea Proveedor de datos .NET Framework para SQL Server (SqlClient) para las funciones de Entity Framework.

Vea también

Conceptos

Funciones canónicas (Entity SQL)