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