Funções de Data e Hora
O provedor de dados. NET Framework para SQL Server (SqlClient) fornece funções de data e hora que executam operações em uma entrada de System.DateTime avalia e retorna um resultado de string, numérico, ou de System.DateTime de valor. Essas funções estão no namespace SqlServer, que está disponível quando você usa o SqlClient. A propriedade de namespace de um provedor permite que o Entity Framework descubra qual prefixo é usado por esse provedor para construções específicas, como tipos e funções. A tabela a seguir mostra as funções de data e hora de SqlClient.
| Função | Descrição |
|---|---|
DATEADD(datepart, number, date) |
Retorna o novo valor DateTime com base na adição de um intervalo à data especificada.Argumentos datepart: String que representa a parte de data para retornar um novo valor.number: Int32, Int64, Decimal, ou valor de Double usado para incrementar datepart.date: Uma expressão que retorna DateTime ou DateTimeOffset, ou Time com precisão = [] 0-7, ou uma cadeia de caracteres em um formato de data.Valor Retornado Novo DateTime, ou DateTimeOffset, ou valor de Time com precisão = [] 0-7.Exemplo SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime)) |
DATEDIFF(datepart,startdate,enddate) |
Retorna o número de limites de data e hora entre duas datas especificadas. Argumentos datepart: String que representa a parte de data para calcular a diferença.startdate: Uma data de início para o cálculo é uma expressão que retorna DateTime, ou DateTimeOffset, ou valor de Time com precisão = [] 0-7, ou uma cadeia de caracteres em um formato de data.enddate: Uma data de término para o cálculo é uma expressão que retorna DateTime ou DateTimeOffset, ou valor de Time com precisão = [] 0-7, ou uma cadeia de caracteres em um formato de data.Valor Retornado Um Int32.Exemplo SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),cast('6/20/2006' as DateTime)) |
DATENAME(datepart, date) |
Retorna uma cadeia de caracteres que representa o datepart especificado de data especificada. Argumentos datepart: String que representa a parte de data para retornar um novo valor.date: Uma expressão que retorna DateTime, ou DateTimeOffset, ou valor de Time com precisão = [] 0-7, ou uma cadeia de caracteres em um formato de data.Valor Retornado A cadeia de caracteres que representa o datepart especificado de data especificada. Exemplo SqlServer.DATENAME('year', cast('6/9/2006' as DateTime)) |
DATEPART(datepart, date) |
Retorna um inteiro que representa o datepart especificado de data especificada. Argumentos datepart: String que representa a parte de data para retornar um novo valor.date: Uma expressão que retorna DateTime, ou DateTimeOffset, ou valor de Time com precisão = [] 0-7, ou uma cadeia de caracteres em um formato de data.Valor Retornado O datepart especificado de data especificada, como Int32.Exemplo SqlServer.DATEPART('year', cast('6/9/2006' as DateTime)) |
DAY(date) |
Retorna o dia da data especificada como um número inteiro. Argumentos date: uma expressão de tipo DateTime ou DateTimeOffset com precisão = 0-7.Valor Retornado O dia de data especificada como Int32.Exemplo SqlServer.DAY(cast('6/9/2006' as DateTime)) |
GETDATE() |
Gerencia a data e hora no formato interno do SQL Server para valores de datetime. Valor Retornado A data e hora atuais do sistema como DateTime com uma precisão de 3.Exemplo SqlServer.GETDATE() |
GETUTCDATE() |
Gerencia o valor datetime no formato UTC (Tempo Universal Coordenado ou o horário de Greenwich) atuais. Valor Retornado O valor de DateTime com uma precisão de 3 no formato UTC.Exemplo SqlServer.GETUTCDATE() |
MONTH(date) |
Retorna o mês de data especificada como um número inteiro. Argumentos date: uma expressão de tipo DateTime ou DateTimeOffset com precisão = 0-7.Valor Retornado O mês de data especificada como Int32.Exemplo SqlServer.MONTH(cast('6/9/2006' as DateTime)) |
YEAR(date) |
Retorna o ano de data especificada como um número inteiro. Argumentos date: uma expressão de tipo DateTime ou DateTimeOffset com precisão = 0-7.Valor Retornado O ano de data especificada como Int32.Exemplo SqlServer.YEAR(cast('6/9/2006' as DateTime)) |
SYSDATETIME() |
Retorna um valor de DateTime com uma precisão de 7.Valor Retornado Um valor de DateTime com uma precisão de 7.Exemplo SqlServer.SYSDATETIME() |
SYSUTCDATE() |
Gerencia o valor datetime no formato UTC (Tempo Universal Coordenado ou o horário de Greenwich) atuais. Valor Retornado O valor de DateTime com precisão = 7 no formato UTC.Exemplo SqlServer.SYSUTCDATE() |
SYSDATETIMEOFFSET() |
Retorna DateTimeOffset com uma precisão de 7.Valor Retornado Um valor de DateTimeOffset com precisão de 7 no formato UTC.Exemplo SqlServer.SYSDATETIMEOFFSET() |
Para obter mais informações sobre as funções de data e hora que o SqlClient dá suporte, consulte Funções e tipos de dados de data e hora (Transact-SQL).