Esta postagem contém uma lista de funções de data e hora Transact-SQL disponíveis no SQL Server (a partir do SQL Server 2017).
Isso inclui funções que retornam a data ou partes da data, bem como funções que manipulam e/ou formatam a data.
Valores de data/hora do sistema
As funções a seguir retornam a data e hora do sistema. Os valores de data/hora retornados por essas funções são todos derivados do sistema operacional em que a instância do SQL Server é executada.
Maior precisão
- SYSDATETIME()
- SYSDATETIMEOFFSET()
- SYSUTCDATETIME()
Precisão menor
- CURRENT_TIMESTAMP
- GETDATA()
- GETUTCDATE()
Partes de Data/Hora de Retorno
Essas funções retornam a parte aplicável da data especificada, a partir da data especificada.
Por exemplo, você pode usar
MONTH()
para retornar o componente do mês da data especificada. - DATENAME ( datepart , data )
- DATEPART ( datepart , data )
- DIA ( data )
- MÊS ( data )
- ANO ( data )
Retorne um valor de data/hora de suas partes
Estas funções permitem construir um valor de data e/ou hora a partir das várias partes que compõem a data/hora. Basta fornecer as várias partes e a função retornará a data/hora no tipo de dados aplicável.
Por exemplo, você pode passar os valores de ano, mês e dia para o
DATEFROMPARTS()
função e retornará uma data valor constituído por essas partes. - DATAFROMPARTS ( ano , mês , dia )
- DATETIME2FROMPARTS ( ano , mês , dia , hora , minuto , segundos , frações , precisão )
- DATETIMEFROMPARTS ( ano , mês , dia , hora , minuto , segundos , milissegundos )
- DATETIMEOFFSETFROMPARTS ( ano , mês , dia , hora , minuto , segundos , frações , hora_deslocamento , minuto_deslocamento , precisão )
- SMALDATETIMEFROMPARTS ( ano , mês , dia , hora , minuto )
- TIMEFROMPARTS ( hora , minuto , segundos , frações , precisão )
Retorne a diferença entre dois valores de data/hora
As seguintes funções podem ser usadas para retornar a diferença entre dois valores de data/hora diferentes.
- DATEDIFF ( datapart , data de início , data de término )
- DATEDIFF_BIG ( datapart , data de início , data de término )
Observe que essas funções fazem essencialmente a mesma coisa. A diferença está no valor de retorno.
Modificar valores de data/hora
- DATEADD (datepart , número , data )
- EOMONTH ( data_inicial [, month_to_add ] )
- SWITCHOFFSET (DATETIMEOFFSET , fuso horário )
- TODATETIMEOFFSET (expressão , fuso horário )
Definir ou retornar funções de formato de sessão
- @@DATEFIRST
- SET DATEFIRST { número | @ var_número }
- SET DATEFORMAT { formato | @ format_var }
- @@LANGUAGE
- DEFINIR IDIOMA { [ N ] ' idioma ' | @ language_var }
- sp_helplanguage [ [ @idioma = ] ' idioma ' ]
Validar um valor de data/hora
Esta função permite verificar se o argumento passado para ela possui um valor de data ou hora válido.
- ISDATE ( expressão )
Funções/artigos relacionados
- Funções escalares ODBC para data e hora
- Como formatar a data e a hora no SQL Server