Funções de hora, data e intervalo

A tabela a seguir lista as funções de data e hora incluídas no conjunto de funções escalares ODBC. Um aplicativo pode determinar quais funções de data e hora têm suporte de um driver chamando SQLGetInfo com um tipo de informação de SQL_TIMEDATE_FUNCTIONS.

Os argumentos indicados como timestamp_exp podem ser o nome de uma coluna, o resultado de outra função escalar ou um ODBC-time-escape, ODBC-date-escape ou ODBC-timestamp-escape, em que o tipo de dados subjacente pode ser representado como SQL_CHAR, SQL_VARCHAR, SQL_TYPE_TIME, SQL_TYPE_DATE ou SQL_TYPE_TIMESTAMP.

Os argumentos indicados como date_exp podem ser o nome de uma coluna, o resultado de outra função escalar ou um ODBC-date-escape ou ODBC-timestamp-escape, em que o tipo de dados subjacente pode ser representado como SQL_CHAR, SQL_VARCHAR, SQL_TYPE_DATE ou SQL_TYPE_TIMESTAMP.

Os argumentos indicados como time_exp podem ser o nome de uma coluna, o resultado de outra função escalar ou um ODBC-time-escape ou ODBC-timestamp-escape, em que o tipo de dados subjacente pode ser representado como SQL_CHAR, SQL_VARCHAR, SQL_TYPE_TIME ou SQL_TYPE_TIMESTAMP.

As funções escalares CURRENT_DATE, CURRENT_TIME e CURRENT_TIMESTAMP timedate foram adicionadas no ODBC 3.0 para se alinharem ao SQL-92.

Função	Descrição
CURRENT_DATE( ) (ODBC 3.0)	Retorna a data atual.
CURRENT_TIME[( precisão de tempo )] (ODBC 3.0)	Retorna a hora local atual. O argumento de precisão de tempo determina a precisão de segundos do valor retornado.
CURRENT_TIMESTAMP [( precisão do carimbo de data/hora )] (ODBC 3.0)	Retorna a data local atual e a hora local como um valor de carimbo de data/hora. O argumento timestamp-precision determina a precisão de segundos do carimbo de data/hora retornado.
CURDATE( ) (ODBC 1.0)	Retorna a data atual.
CURTIME( ) (ODBC 1.0)	Retorna a hora local atual.
DAYNAME( date_exp ) (ODBC 2.0)	Retorna uma cadeia de caracteres que contém o nome específico da fonte de dados do dia (por exemplo, de domingo a sábado ou domingo a sábado para uma fonte de dados que usa inglês ou Sonntag a Samstag para uma fonte de dados que usa alemão) para a parte do dia de date_exp.
DAYOFMONTH( date_exp ) (ODBC 1.0)	Retorna o dia do mês com base no campo de mês em date_exp como um valor inteiro no intervalo de 1 a 31.
DAYOFWEEK( date_exp ) (ODBC 1.0)	Retorna o dia da semana com base no campo da semana em date_exp como um valor inteiro no intervalo de 1 a 7, em que 1 representa domingo.
DAYOFYEAR( date_exp ) (ODBC 1.0)	Retorna o dia do ano com base no campo de ano em date_exp como um valor inteiro no intervalo de 1 a 366.
EXTRACT( extração-campo FROM extração-fonte ) (ODBC 3.0)	Retorna a parte do campo de extração da fonte de extração. O argumento extract-source é uma expressão datetime ou interval. O argumento extract-field pode ser uma das seguintes palavras-chave: ANO MÊS DIA HORA MINUTO SEGUNDO A precisão do valor retornado é definida pela implementação. A escala é 0, a menos que SECOND seja especificado, caso em que a escala não é menor que a precisão de segundos fracionários do campo de origem de extração.
HORA( time_exp ) (ODBC 1.0)	Retorna a hora com base no campo de hora em time_exp como um valor inteiro no intervalo de 0 a 23.
MINUTO( time_exp ) (ODBC 1.0)	Retorna o minuto com base no campo de minuto em time_exp como um valor inteiro no intervalo de 0 a 59.
MÊS( date_exp ) (ODBC 1.0)	Retorna o mês com base no campo de mês em date_exp como um valor inteiro no intervalo de 1 a 12.
NOMEDOMÊS( date_exp ) (ODBC 2.0)	Retorna uma cadeia de caracteres que contém o nome específico da fonte de dados do mês (por exemplo, janeiro a dezembro ou janeiro a dezembro para uma fonte de dados que usa inglês ou janeiro a dezembro para uma fonte de dados que usa alemão) para a parte do mês de date_exp.
AGORA( ) (ODBC 1.0)	Retorna a data e a hora atuais como um valor de carimbo de data/hora.
TRIMESTRE( date_exp ) (ODBC 1.0)	Retorna o trimestre em date_exp como um valor inteiro no intervalo de 1 a 4, em que 1 representa 1º de janeiro a 31 de março.
SEGUNDO( time_exp ) (ODBC 1.0)	Retorna o segundo com base no segundo campo em time_exp como um valor inteiro no intervalo de 0 a 59.
TIMESTAMPADD( intervalo, integer_exp, timestamp_exp ) (ODBC 2.0)	Retorna o carimbo de data/hora calculado adicionando intervalos de integer_exp do tipo intervalo a timestamp_exp. Os valores válidos de intervalo são as seguintes palavras-chave: SQL_TSI_FRAC_SECOND SQL_TSI_SECOND SQL_TSI_MINUTE SQL_TSI_HOUR SQL_TSI_DAY SQL_TSI_WEEK SQL_TSI_MONTH SQL_TSI_QUARTER SQL_TSI_YEAR onde os segundos fracionários são expressos em bilionésimos de segundo. Por exemplo, a instrução SQL a seguir retorna o nome de cada funcionário e sua data de aniversário de um ano: SELECT NAME, {fn TIMESTAMPADD(SQL_TSI_YEAR, 1, HIRE_DATE)} FROM EMPLOYEES Se timestamp_exp for um valor de tempo e intervalo especificar dias, semanas, meses, trimestres ou anos, a parte de data de timestamp_exp será definida como a data atual antes de calcular o carimbo de data/hora resultante. Se timestamp_exp for um valor de data e o intervalo especificar fracionários de segundos, segundos, minutos ou horas, a parte de tempo de timestamp_exp será definida como 0 antes de calcular o carimbo de data/hora resultante. Um aplicativo determina quais intervalos uma fonte de dados dá suporte chamando SQLGetInfo com a opção SQL_TIMEDATE_ADD_INTERVALS.
TIMESTAMPDIFF( intervalo, timestamp_exp1, timestamp_exp2 ) (ODBC 2.0)	Retorna o número inteiro de intervalos do tipo interval pelo qual timestamp_exp2 é maior que timestamp_exp1. Os valores válidos de intervalo são as seguintes palavras-chave: SQL_TSI_FRAC_SECOND SQL_TSI_SECOND SQL_TSI_MINUTE SQL_TSI_HOUR SQL_TSI_DAY SQL_TSI_WEEK SQL_TSI_MONTH SQL_TSI_QUARTER SQL_TSI_YEAR onde os segundos fracionários são expressos em bilionésimos de segundo. Por exemplo, a instrução SQL a seguir retorna o nome de cada funcionário e o número de anos que ele está empregado: SELECT NAME, {fn TIMESTAMPDIFF(SQL_TSI_YEAR, {fn CURDATE()}, HIRE_DATE)} FROM EMPLOYEES Se uma das expressões de carimbo de data/hora for um valor de hora e o intervalo especificar dias, semanas, meses, trimestres ou anos, a parte de data desse carimbo de data/hora será definida como a data atual antes de calcular a diferença entre os carimbos de data/hora. Se uma das expressões de carimbo de data/hora for um valor de data e intervalo especificar segundos, segundos, minutos ou horas fracionários, a parte de tempo desse carimbo de data/hora será definida como 0 antes de calcular a diferença entre os carimbos de data/hora. Um aplicativo determina quais intervalos uma fonte de dados dá suporte chamando SQLGetInfo com a opção SQL_TIMEDATE_DIFF_INTERVALS.
SEMANA( date_exp ) (ODBC 1.0)	Retorna a semana do ano com base no campo de semana em date_exp como um valor inteiro no intervalo de 1 a 53.
ANO( date_exp ) (ODBC 1.0)	Retorna o ano com base no campo ano em date_exp como um valor inteiro. O intervalo depende da fonte de dados.