Funciones canónicas de fecha y horaDate and Time Canonical Functions

Entity SQLEntity SQL incluye funciones canónicas de fecha y hora.includes date and time canonical functions.

ComentariosRemarks

En la tabla siguiente se muestran las funciones Entity SQLEntity SQL canónicas de fecha y hora.The following table shows the date and time Entity SQLEntity SQL canonical functions. datetimees un DateTime valor.datetime is a DateTime value.

FunciónFunction DESCRIPCIÓNDescription
AddNanoseconds(expression,number) Agrega el number de nanosegundos especificado a expression.Adds the specified number of nanoseconds to the expression.

ArgumentosArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valor devueltoReturn Value

Tipo de expression.The type of expression.
AddMicroseconds(expression,number) Agrega el objeto especificado number de microsegundos a expression.Adds the specified number of microseconds to the expression.

ArgumentosArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valor devueltoReturn Value

Tipo de expression.The type of expression.
AddMilliseconds(expression,number) Agrega el objeto especificado number de milisegundos a expression.Adds the specified number of milliseconds to the expression.

ArgumentosArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valor devueltoReturn Value

Tipo de expression.The type of expression.
AddSeconds(expression,number) Agrega el objeto especificado number de segundos a expression.Adds the specified number of seconds to the expression.

ArgumentosArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valor devueltoReturn Value

Tipo de expression.The type of expression.
AddMinutes(expression,number) Agrega el objeto especificado number de minutos a expression.Adds the specified number of minutes to the expression.

ArgumentosArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valor devueltoReturn Value

Tipo de expression.The type of expression.
AddHours(expression,number) Agrega el objeto especificado number de horas a expression.Adds the specified number of hours to the expression.

ArgumentosArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valor devueltoReturn Value

Tipo de expression.The type of expression.
AddDays(expression,number) Agrega el objeto especificado number de días a expression.Adds the specified number of days to the expression.

ArgumentosArguments

expression: DateTime o DateTimeOffset.expression: DateTime or DateTimeOffset.

number: Int32.number: Int32.

Valor devueltoReturn Value

Tipo de expression.The type of expression.
AddMonths(expression,number) Agrega el objeto especificado number de meses a expression.Adds the specified number of months to the expression.

ArgumentosArguments

expression: DateTime o DateTimeOffset.expression: DateTime or DateTimeOffset.

number: Int32.number: Int32.

Valor devueltoReturn Value

Tipo de expression.The type of expression.
AddYears(expression,number) Agrega el objeto especificado number de años a expression.Adds the specified number of years to the expression.

ArgumentosArguments

expression: DateTime o DateTimeOffset.expression: DateTime or DateTimeOffset.

number: Int32.number: Int32.

Valor devueltoReturn Value

Tipo de expression.The type of 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.Returns a new DateTime value as the current date and time of the server in the server's time zone.

ArgumentosArguments

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

second: Double.second: Double.

Valor devueltoReturn Value

Objeto DateTime.A 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).Returns a new DateTimeOffset value as the current date and time of the server relative to the Coordinated Universal Time (UTC).

ArgumentosArguments

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

second: Double.second: Double.

Valor devueltoReturn Value

Objeto DateTimeOffset.A DateTimeOffset.
CreateTime(hour,minute,second) Devuelve un valor Time nuevo como la hora actual.Returns a new Time value as the current time.

ArgumentosArguments

hour y minute: Int32.hour and minute: Int32.

second: Double.second: Double.

Valor devueltoReturn Value

Objeto Time.A Time.
CurrentDateTime() Devuelve un valor DateTime como fecha y hora actuales del servidor en la zona horaria del servidor.Returns a DateTime value as the current date and time of the server in the server's time zone.

Valor devueltoReturn Value

Objeto DateTime.A DateTime.
CurrentDateTimeOffset() Devuelve la fecha, la hora y el desplazamiento actuales como un objeto DateTimeOffset.Returns the current date, time and offset as a DateTimeOffset.

Valor devueltoReturn Value

Objeto DateTimeOffset.A DateTimeOffset.
CurrentUtcDateTime() Devuelve un valor DateTime como fecha y hora actuales del servidor en la zona horaria UTS.Returns a DateTime value as the current date and time of the server in the UTS time zone.

Valor devueltoReturn Value

Objeto DateTime.A DateTime.
Day(expression) Devuelve la parte de día de expression como un valor Int32 entre 1 y 31.Returns the day portion of expression as an Int32 between 1 and 31.

ArgumentosArguments

DateTime y DateTimeOffset.A DateTime and DateTimeOffset.

Valor devueltoReturn Value

Una clase Int32.An Int32.

EjemploExample

-- 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.Returns the day portion of expression as an Int32 between 1 and 366, where 366 is returned for the last day of a leap year.

ArgumentosArguments

DateTime o DateTimeOffset.A DateTime or DateTimeOffset.

Valor devueltoReturn Value

Una clase Int32.An Int32.
DiffNanoseconds(startExpression,endExpression) Devuelve la diferencia, en nanosegundos, entre startExpression y endExpression.Returns the difference, in nanoseconds, between startExpression and endExpression.

ArgumentosArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression yendExpression deben ser del mismo tipo.Note: startExpression and endExpression must be of the same type.

Valor devueltoReturn Value

Una clase Int32.An Int32.
DiffMilliseconds(startExpression,endExpression) Devuelve la diferencia, en milisegundos, entre startExpression y endExpression.Returns the difference, in milliseconds, between startExpression and endExpression.

ArgumentosArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression yendExpression deben ser del mismo tipo.Note: startExpression and endExpression must be of the same type.

Valor devueltoReturn Value

Una clase Int32.An Int32.
DiffMicroseconds(startExpression,endExpression) Devuelve la diferencia, en microsegundos, entre startExpression y endExpression.Returns the difference, in microseconds, between startExpression and endExpression.

ArgumentosArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression yendExpression deben ser del mismo tipo.Note: startExpression and endExpression must be of the same type.

Valor devueltoReturn Value

Una clase Int32.An Int32.
DiffSeconds(startExpression,endExpression) Devuelve la diferencia, en segundos, entre startExpression y endExpression.Returns the difference, in seconds, between startExpression and endExpression.

ArgumentosArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression yendExpression deben ser del mismo tipo.Note: startExpression and endExpression must be of the same type.

Valor devueltoReturn Value

Una clase Int32.An Int32.
DiffMinutes(startExpression,endExpression) Devuelve la diferencia, en minutos, entre startExpression y endExpression.Returns the difference, in minutes, between startExpression and endExpression.

ArgumentosArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression yendExpression deben ser del mismo tipo.Note: startExpression and endExpression must be of the same type.

Valor devueltoReturn Value

Una clase Int32.An Int32.
DiffHours(startExpression,endExpression) Devuelve la diferencia, en horas, entre startExpression y endExpression.Returns the difference, in hours, between startExpression and endExpression.

ArgumentosArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression yendExpression deben ser del mismo tipo.Note: startExpression and endExpression must be of the same type.

Valor devueltoReturn Value

Una clase Int32.An Int32.
DiffDays(startExpression,endExpression) Devuelve la diferencia, en días, entre startExpression y endExpression.Returns the difference, in days, between startExpression and endExpression.

ArgumentosArguments

startExpression, endExpression: DateTime o DateTimeOffset.startExpression, endExpression: DateTime or DateTimeOffset. Nota: startExpression yendExpression deben ser del mismo tipo.Note: startExpression and endExpression must be of the same type.

Valor devueltoReturn Value

Una clase Int32.An Int32.
DiffMonths(startExpression,endExpression) Devuelve la diferencia, en meses, entre startExpression y endExpression.Returns the difference, in months, between startExpression and endExpression.

ArgumentosArguments

startExpression, endExpression: DateTime o DateTimeOffset.startExpression, endExpression: DateTime or DateTimeOffset. Nota: startExpression yendExpression deben ser del mismo tipo.Note: startExpression and endExpression must be of the same type.

Valor devueltoReturn Value

Una clase Int32.An Int32.
DiffYears(startExpression,endExpression) Devuelve la diferencia, en años, entre startExpression y endExpression.Returns the difference, in years, between startExpression and endExpression.

ArgumentosArguments

startExpression, endExpression: DateTime o DateTimeOffset.startExpression, endExpression: DateTime or DateTimeOffset. Nota: startExpression yendExpression deben ser del mismo tipo.Note: startExpression and endExpression must be of the same type.

Valor devueltoReturn Value

Una clase Int32.An Int32.
GetTotalOffsetMinutes(datetimeoffset) Devuelve el número de minutos que constituyen el desplazamiento de datetimeoffset con respecto a GMT.Returns the number of minutes that the datetimeoffset is offset from GMT. Este valor está comprendido generalmente entre +780 y -780 (+ o - 13 horas).This is generally between +780 and -780 (+ or - 13 hrs). Nota: Esta función solo se admite en SQL Server 2008.Note: This function is supported in SQL Server 2008 only.

ArgumentosArguments

Objeto DateTimeOffset.A DateTimeOffset.

Valor devueltoReturn Value

Una clase Int32.An Int32.
Hour(expression) Devuelve la parte de hora de expression como un valor Int32 entre 0 y 23.Returns the hour portion of expression as an Int32 between 0 and 23.

ArgumentosArguments

DateTime, Time y DateTimeOffset.A DateTime, Time and DateTimeOffset.

EjemploExample

-- 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.Returns the milliseconds portion of expression as an Int32 between 0 and 999.

ArgumentosArguments

DateTime, Time y DateTimeOffset.A DateTime, Time and DateTimeOffset.

Valor devueltoReturn Value

Una clase Int32.An Int32.
Minute(expression) Devuelve la parte de minutos de expression como un valor Int32 entre 0 y 59.Returns the minute portion of expression as an Int32 between 0 and 59.

ArgumentosArguments

DateTime, Time o DateTimeOffset.A DateTime, Time or DateTimeOffset.

Valor devueltoReturn Value

Una clase Int32.An Int32.

EjemploExample

-- 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.Returns the month portion of expression as an Int32 between 1 and 12.

ArgumentosArguments

DateTime o DateTimeOffset.A DateTime or DateTimeOffset.

Valor devueltoReturn Value

Una clase Int32.An Int32.

EjemploExample

-- 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.Returns the seconds portion of expression as an Int32 between 0 and 59.

ArgumentosArguments

DateTime, Time y DateTimeOffset.A DateTime, Time and DateTimeOffset.

Valor devueltoReturn Value

Una clase Int32.An Int32.

EjemploExample

-- The following example returns 5

Second(cast('22:35:5' as DateTime))
TruncateTime(expression) Devuelve expression, con los valores de tiempo truncados.Returns the expression, with the time values truncated.

ArgumentosArguments

DateTime o DateTimeOffset.A DateTime or DateTimeOffset.

Valor devueltoReturn Value

Tipo de expression.The type of expression.
Year(expression) Devuelve la parte del año expression de como Int32 un YYYY.Returns the year portion of expression as an Int32 YYYY.

ArgumentosArguments

DateTime y DateTimeOffset.A DateTime and DateTimeOffset.

Valor devueltoReturn Value

Una clase Int32.An Int32.

EjemploExample

-- The following example returns 1998.

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

Estas funciones devolverán null si se proporciona la entrada null.These functions will return null if given null input.

La funcionalidad equivalente está disponible en el proveedor administrado de Microsoft SQL Client.Equivalent functionality is available in the Microsoft SQL Client Managed Provider. Para obtener más información, vea SqlClient para funciones de Entity Framework.For more information, see SqlClient for Entity Framework Functions.

Vea tambiénSee also