Funções de data e hora

O Provedor de Dados do .NET Framework para SQL Server (SqlClient) fornece funções de data e hora que executam operações sobre um valor de entrada System.DateTime e retornam um resultado string, numérico ou de valor System.DateTime. Essas funções estão no namespace sqlServer, que está disponível quando você usa SqlClient. A propriedade de namespace de um provedor permite que o Entity Framework descubra qual prefixo é usado por esse provedor para constructos específicos, como tipos e funções. A tabela a seguir mostra as funções de data e hora do 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: um String que representa a parte da data na qual retornar um novo valor. number: Int32, Int64, Decimal ou Double valor usado para incrementar datepart. date: Uma expressão que retorna um DateTime, ou DateTimeOffset, ou Time com precisão = [0-7], ou uma cadeia de caracteres em um formato de data. valor retornado Um novo valor DateTime, ou DateTimeOffset, ou valor 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 inicial para o cálculo é uma expressão que retorna um valor DateTime, ou valor DateTimeOffset, ou valor Time com precisão = [0-7], ou uma cadeia de caracteres em formato de data. enddate:Uma data de término para o cálculo é uma expressão que retorna um valor DateTime, DateTimeOffset, Time com precisão = [0-7], ou uma cadeia de caracteres em 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: um String que representa a parte da data na qual retornar um novo valor. date: uma expressão que retorna um DateTime, ou DateTimeOffset, ou Time valor 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: um String que representa a parte da data na qual retornar um novo valor. date: uma expressão que retorna um DateTime, ou DateTimeOffset, ou Time valor 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 inteiro. argumentos date:Uma expressão do 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()	Produz o valor de datetime no formato UTC (Tempo Universal Coordenado ou Tempo Médio de Greenwich). valor retornado O valor de DateTime com uma precisão de 3 no formato UTC. Exemplo SqlServer.GETUTCDATE()
MONTH(date)	Retorna o mês da data especificada como um inteiro. argumentos date:Uma expressão do 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 da data especificada como um inteiro. argumentos date:Uma expressão do 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 DateTime valor com uma precisão de 7. valor retornado Um DateTime valor com uma precisão de 7. Exemplo SqlServer.SYSDATETIME()
SYSUTCDATE()	Produz o valor de datetime no formato UTC (Tempo Universal Coordenado ou Tempo Médio de Greenwich). 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 compatíveis com o SqlClient, consulte Tipos e Funções de Dados de Data e Hora (Transact-SQL).

Consulte também

• Funções do SqlClient para Entity Framework