Compartilhar via


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ãode 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ãodo 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 seguinte instrução SQL 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 seguinte instrução SQL retorna o nome de cada funcionário e o número de anos em que foram empregados:

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.