Funções canônicas de data e hora
O Entity SQL inclui funções canônicas de data e hora.
Observações
A tabela a seguir mostra as funções canônicas de data e hora do Entity SQL. datetime é um DateTime valor.
| Function | Description |
|---|---|
AddNanoseconds(expression,number) |
Adiciona o especificado number de nanossegundos ao expression.Argumentos expression: DateTime, DateTimeOffset, ou Time.number: Int32.Valor de retorno O tipo de expression. |
AddMicroseconds(expression,number) |
Adiciona o especificado number de microssegundos ao expressionarquivo .Argumentos expression: DateTime, DateTimeOffset, ou Time.number: Int32.Valor de retorno O tipo de expression. |
AddMilliseconds(expression,number) |
Adiciona o especificado number de milissegundos ao expression.Argumentos expression: DateTime, DateTimeOffset, ou Time.number: Int32.Valor de retorno O tipo de expression. |
AddSeconds(expression,number) |
Adiciona o especificado number de segundos ao expression.Argumentos expression: DateTime, DateTimeOffset, ou Time.number: Int32.Valor de retorno O tipo de expression. |
AddMinutes(expression,number) |
Adiciona o especificado number de minutos ao expressionarquivo .Argumentos expression: DateTime, DateTimeOffset, ou Time.number: Int32.Valor de retorno O tipo de expression. |
AddHours(expression,number) |
Adiciona as horas especificadas number ao expressionarquivo .Argumentos expression: DateTime, DateTimeOffset, ou Time.number: Int32.Valor de retorno O tipo de expression. |
AddDays(expression,number) |
Adiciona os dias especificados number ao expression.Argumentos expression: DateTime ou DateTimeOffset.number: Int32.Valor de retorno O tipo de expression. |
AddMonths(expression,number) |
Adiciona os meses especificados number ao expression.Argumentos expression: DateTime ou DateTimeOffset.number: Int32.Valor de retorno O tipo de expression. |
AddYears(expression,number) |
Adiciona os anos especificados number ao expression.Argumentos expression: DateTime ou DateTimeOffset.number: Int32.Valor de retorno O tipo de expression. |
CreateDateTime(year,month,day,hour,minute,second) |
Retorna um novo DateTime valor como a data e hora atuais do servidor no fuso horário do servidor.Argumentos year, month, day, hour, minute: Int16 e Int32.second: Double.Valor de retorno A DateTime. |
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset) |
Retorna um novo DateTimeOffset valor como a data e hora atuais do servidor em relação ao Tempo Universal Coordenado (UTC).Argumentos year, month, day, hour, minute, tzoffset: Int32.second: Double.Valor de retorno A DateTimeOffset. |
CreateTime(hour,minute,second) |
Retorna um novo Time valor como a hora atual.Argumentos hour e minute: Int32.second: Double.Valor de retorno A Time. |
CurrentDateTime() |
Retorna um DateTime valor como a data e hora atuais do servidor no fuso horário do servidor.Valor de retorno A DateTime. |
CurrentDateTimeOffset() |
Devolve a data, hora e deslocamento atuais como um DateTimeOffsetarquivo .Valor de retorno A DateTimeOffset. |
CurrentUtcDateTime() |
Retorna um DateTime valor como a data e hora atuais do servidor no fuso horário UTC. Valor de retorno A DateTime. |
Day(expression) |
Devolve a parte do dia como expression um Int32 entre 1 e 31.Argumentos A DateTime e DateTimeOffset.Valor de retorno Um Int32.Exemplo -- The following example returns 12.Day(cast('03/12/1998' as DateTime)) |
DayOfYear(expression) |
Devolve a parte do dia de expression como um Int32 entre 1 e 366, onde 366 é devolvido para o último dia de um ano bissexto.Argumentos A DateTime ou DateTimeOffset.Valor de retorno Um Int32. |
DiffNanoseconds(startExpression,endExpression) |
Devolve a diferença, em nanossegundos, entre startExpression e endExpression.Argumentos startExpression, endExpression: DateTime, DateTimeOffset, ou Time. Nota: startExpression e endExpression deve ser do mesmo tipo. Valor de retorno Um Int32. |
DiffMilliseconds(startExpression,endExpression) |
Devolve a diferença, em milissegundos, entre startExpression e endExpression.Argumentos startExpression, endExpression: DateTime, DateTimeOffset, ou Time. Nota: startExpression e endExpression deve ser do mesmo tipo. Valor de retorno Um Int32. |
DiffMicroseconds(startExpression,endExpression) |
Devolve a diferença, em microssegundos, entre startExpression e endExpression.Argumentos startExpression, endExpression: DateTime, DateTimeOffset, ou Time. Nota: startExpression e endExpression deve ser do mesmo tipo. Valor de retorno Um Int32. |
DiffSeconds(startExpression,endExpression) |
Devolve a diferença, em segundos, entre startExpression e endExpression.Argumentos startExpression, endExpression: DateTime, DateTimeOffset, ou Time. Nota: startExpression e endExpression deve ser do mesmo tipo. Valor de retorno Um Int32. |
DiffMinutes(startExpression,endExpression) |
Devolve a diferença, em minutos, entre startExpression e endExpression.Argumentos startExpression, endExpression: DateTime, DateTimeOffset, ou Time. Nota: startExpression e endExpression deve ser do mesmo tipo. Valor de retorno Um Int32. |
DiffHours(startExpression,endExpression) |
Devolve a diferença, em horas, entre startExpression e endExpression.Argumentos startExpression, endExpression: DateTime, DateTimeOffset, ou Time. Nota: startExpression e endExpression deve ser do mesmo tipo. Valor de retorno Um Int32. |
DiffDays(startExpression,endExpression) |
Devolve a diferença, em dias, entre startExpression e endExpression.Argumentos startExpression, endExpression: DateTime ou DateTimeOffset. Nota: startExpression e endExpression deve ser do mesmo tipo. Valor de retorno Um Int32. |
DiffMonths(startExpression,endExpression) |
Devolve a diferença, em meses, entre startExpression e endExpression.Argumentos startExpression, endExpression: DateTime ou DateTimeOffset. Nota: startExpression e endExpression deve ser do mesmo tipo. Valor de retorno Um Int32. |
DiffYears(startExpression,endExpression) |
Devolve a diferença, em anos, entre startExpression e endExpression.Argumentos startExpression, endExpression: DateTime ou DateTimeOffset. Nota: startExpression e endExpression deve ser do mesmo tipo. Valor de retorno Um Int32. |
GetTotalOffsetMinutes(datetimeoffset) |
Devolve o número de minutos em que o datetimeoffset é deslocado do GMT. Isto é geralmente entre +780 e -780 (+ ou - 13 horas). Nota: Esta função é suportada apenas no SQL Server 2008. Argumentos A DateTimeOffset.Valor de retorno Um Int32. |
Hour(expression) |
Devolve a parte horária de expression como um Int32 entre 0 e 23.Argumentos A DateTime, Time e DateTimeOffset.Exemplo -- The following example returns 22.Hour(cast('22:35:5' as DateTime)) |
Millisecond(expression) |
Devolve a porção de milissegundos de expression como um Int32 entre 0 e 999.Argumentos A DateTime, Time e DateTimeOffset.Valor de retorno Um Int32. |
Minute(expression) |
Devolve a parte de minuto de expression como um Int32 entre 0 e 59.Argumentos A DateTime, Time ou DateTimeOffset.Valor de retorno Um Int32.Exemplo -- The following example returns 35Minute(cast('22:35:5' as DateTime)) |
Month(expression) |
Devolve a parte do mês como expression um Int32 entre 1 e 12.Argumentos A DateTime ou DateTimeOffset.Valor de retorno Um Int32.Exemplo -- The following example returns 3.Month(cast('03/12/1998' as DateTime)) |
Second(expression) |
Devolve a parte de segundos de expression como um Int32 entre 0 e 59.Argumentos A DateTime, Time e DateTimeOffset.Valor de retorno Um Int32.Exemplo -- The following example returns 5Second(cast('22:35:5' as DateTime)) |
TruncateTime(expression) |
Retorna o expression, com os valores de tempo truncados.Argumentos A DateTime ou DateTimeOffset.Valor de retorno O tipo de expression. |
Year(expression) |
Devolve a parte do ano de expression como um Int32 YYYYficheiro .Argumentos A DateTime e DateTimeOffset.Valor de retorno Um Int32.Exemplo -- The following example returns 1998.Year(cast('03/12/1998' as DateTime)) |
Essas funções retornarão null se a entrada for dada null .
Funcionalidade equivalente está disponível no Microsoft SQL Client Managed Provider. Para obter mais informações, consulte SqlClient for Entity Framework Functions.