Todos os produtos
Search

Este produto

    AnalyticDB:Funções de data e hora

    Central de documentação

    AnalyticDB:Funções de data e hora

    Última atualização: Aug 20, 2026

    As funções de data e hora permitem processar valores temporais. Com elas, é possível obter a data e a hora atuais, formatar valores temporais, calcular intervalos e extrair partes específicas, como ano, mês ou dia. Este tópico descreve a sintaxe das funções de data e hora e apresenta exemplos de uso no AnalyticDB for MySQL.

    • ADDDATE: adiciona um intervalo de tempo à data especificada.

    • ADDTIME: soma um intervalo de tempo ao horário indicado.

    • CONVERT_TZ: converte o valor do fuso horário definido em from_tz para o fuso horário definido em to_tz e retorna o resultado.

    • CURDATE: retorna a data atual.

    • CURTIME: retorna a hora atual.

    • DATE: extrai a parte da data de uma expressão date ou datetime.

    • DATE_FORMAT: formata uma data como string conforme o padrão especificado.

    • SUBDATE/DATE_SUB: subtrai o intervalo definido de uma data.

    • DATEDIFF: calcula a diferença entre duas datas.

    • DAY/DAYOFMONTH: indica o dia do mês de uma data. Valores válidos: 1 a 31.

    • DAYNAME: informa o dia da semana de uma data, como segunda-feira.

    • DAYOFWEEK: devolve o dia da semana como valor numérico para uma data.

    • DAYOFYEAR: obtém o dia do ano correspondente a uma data.

    • EXTRACT: separa componentes individuais de uma data ou hora, como ano, mês, dia, hora ou minuto.

    • FROM_DAYS: gera um valor DATE com base no parâmetro N, que define a quantidade de dias.

    • FROM_UNIXTIME: produz um timestamp UNIX no formato solicitado.

    • HOUR: extrai a parte da hora de um valor temporal.

    • LAST_DAY: identifica o último dia do mês para uma data ou datetime.

    • LOCALTIME/LOCALTIMESTAMP/NOW: fornece o timestamp atual.

    • MAKEDATE: constrói uma data a partir dos parâmetros year e dayofyear.

    • MAKETIME: monta um horário usando os parâmetros hour, minute e second.

    • MINUTE: isola os minutos de um valor temporal.

    • MONTH: recupera o mês de uma data.

    • MONTHNAME: retorna o nome completo do mês de uma data.

    • PERIOD_ADD: acrescenta N meses ao período P.

    • PERIOD_DIFF: calcula a quantidade de meses entre dois períodos.

    • QUARTER: aponta o trimestre do ano referente a uma data.

    • SEC_TO_TIME: transforma segundos em um valor de tempo.

    • SECOND: obtém os segundos do horário informado.

    • STR_TO_DATE: interpreta uma string como data ou datetime segundo o formato definido.

    • SUBTIME: remove o intervalo expr2 do horário expr1.

    • SYSDATE: fornece a hora do sistema.

    • TIME: extrai a parte horária da expressão date ou datetime indicada por expr e a retorna como string.

    • TIME_FORMAT: converte um horário em string conforme o formato desejado.

    • TIME_TO_SEC: transforma um horário em total de segundos.

    • TIMEDIFF: subtrai o horário expr2 do horário expr1.

    • TIMESTAMP: converte a expressão date ou datetime definida por expr em um valor datetime.

    • TIMESTAMPADD: adiciona um intervalo a uma expressão date ou datetime.

    • TIMESTAMPDIFF: devolve o resultado da subtração entre duas expressões date ou datetime.

    • TO_DAYS: conta os dias decorridos desde o ano 0 até a data informada.

    • TO_SECONDS: totaliza os segundos transcorridos desde o ano 0 até o horário especificado.

    • UNIX_TIMESTAMP: retorna o timestamp da hora atual no formato UNIX, representando os segundos decorridos desde 00:00:00 de 1º de janeiro de 1970 em UTC.

    • UTC_DATE: fornece a data em UTC.

    • UTC_TIME: fornece a hora em UTC.

    • UTC_TIMESTAMP: fornece o timestamp em UTC.

    • WEEK: determina o número da semana de uma data.

    • WEEKDAY: indica o dia da semana de uma data.

    • WEEKOFYEAR: calcula a semana civil de uma data.

    • YEAR: extrai o ano de uma data.

    • YEARWEEK: combina o ano e a semana de uma data.

    ADDDATE

    ADDDATE(date,INTERVAL expr unit)
ADDDATE(expr,days)

    • Tipos de parâmetros:

      adddate(date, INTERVAL expr unit)
adddate(timestamp, INTERVAL expr unit)
adddate(datetime, INTERVAL expr unit)
adddate(varchar, INTERVAL expr unit)
adddate(date, varchar)
adddate(date, bigint)
adddate(datetime, bigint)
adddate(datetime, varchar)
adddate(timestamp, varchar)
adddate(timestamp, bigint)
adddate(varchar, bigint)
adddate(varchar, varchar)

    • Tipo de dado do valor retornado: DATE.

    • Descrição: Esta função adiciona um intervalo de tempo à data especificada.

      • Valores válidos para unit: second, minute, hour, day, month, year, minute_second, hour_second, hour_minute, day_second, day_minute, day_hour e year_month. Valor padrão de unit: day.

      • days e expr: A função retorna a soma de expr com days.

    • Exemplos:

      Exemplo 1

      select adddate(date '2022-01-22',interval '3' day);

      O retorno será:

      +----------------------------------------------+
| adddate(DATE '2022-01-22', INTERVAL  '3' DAY)|
+----------------------------------------------+
| 2022-01-25                                   |

      Exemplo 2

      select adddate(timestamp '2022-01-22',interval '3' day);

      O retorno será:

      +---------------------------------------------------+
| adddate(TIMESTAMP '2022-01-22', INTERVAL  '3' DAY)|
+---------------------------------------------------+
| 2022-01-25 00:00:00                               |

      Exemplo 3

      select adddate(datetime '2022-01-22',interval '3' day);

      O retorno será:

      +--------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' DAY |
+--------------------------------------------------+
| 2022-01-25 00:00:00                              |

      Exemplo 4

      select adddate('2022-01-22',interval '3' day);

      O retorno será:

      +-----------------------------------------+
| adddate('2022-01-22', INTERVAL  '3' DAY)|
+-----------------------------------------+
| 2022-01-25                              |

      Exemplo 5

      select adddate(datetime '2022-01-22',interval '3' second);

      O retorno será:

      +-----------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' SECOND)|
+-----------------------------------------------------+
|                                 2022-01-22 00:00:03 |

      Exemplo 6

      select adddate(datetime '2022-01-22',interval '3' minute);

      O retorno será:

      +-----------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' MINUTE)|
+-----------------------------------------------------+
|                                 2022-01-22 00:03:00 |

      Exemplo 7

      select adddate(datetime '2022-01-22',interval '3' hour);

      O retorno será:

      +---------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' HOUR |
+---------------------------------------------------+
|                               2022-01-22 03:00:00 |

      Exemplo 8

      select adddate(datetime '2022-01-22',interval '3' month);

      O retorno será:

      +----------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' MONTH)|
+----------------------------------------------------+
|                                2022-04-22 00:00:00 |

      Exemplo 9

      select adddate(datetime '2022-01-22',interval '3' year);

      O retorno será:

      +---------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' YEAR)|
+---------------------------------------------------+
|                               2025-01-22 00:00:00 |

      Exemplo 10

      select adddate(datetime '2022-01-22',interval '01:01:10' hour_second) as result;

      O retorno será:

      +---------------------+
| result              |
+---------------------+
| 2022-01-22 01:01:10 |

      Exemplo 11

      select adddate(datetime '2022-01-22',interval '00:10' hour_minute) as result;

      O retorno será:

      +---------------------+
| result              |
+---------------------+
| 2022-01-22 00:10:00 |

      Exemplo 12

      select adddate(datetime '2022-01-22',interval '1 01:01:10' day_second) as result;

      O retorno será:

      +---------------------+
| result              |
+---------------------+
| 2022-01-23 01:01:10 |

      Exemplo 13

      select adddate(datetime '2022-01-22',interval '01:10' minute_second) as result;

      O retorno será:

      +---------------------+
| result              |
+---------------------+
| 2022-01-22 00:01:10 |

      Exemplo 14

      select adddate(datetime '2022-01-22',interval '1 01:01' day_minute) as result;

      O retorno será:

      +---------------------+
| result              |
+---------------------+
| 2022-01-23 01:01:00 |

      Exemplo 15

      select adddate(datetime '2022-01-22',interval '1 01' day_hour) as result;

      O retorno será:

      +---------------------+
| result              |
+---------------------+
| 2022-01-23 01:00:00 |

      Exemplo 16

      select adddate(datetime '2022-01-22 12:32:1',interval '2 2' year_month) as result;

      O retorno será:

      +---------------------+
| result              |
+---------------------+
| 2024-03-22 12:32:01 |

      Exemplo 17

      select adddate('2022-01-22','3');

      O retorno será:

      +---------------------------+
| adddate('2022-01-22', '3')|
+---------------------------+
| 2022-01-25                |

      Exemplo 18

      select adddate('2022-01-22',3);

      O retorno será:

      +-------------------------+
| adddate('2022-01-22', 3)|
+-------------------------+
| 2022-01-25              |

      Exemplo 19

      select adddate(datetime '2022-01-22 12:12:32',3);

      O retorno será:

      +-------------------------------------------+
| adddate(DATETIME '2022-01-22 12:12:32', 3)|
+-------------------------------------------+
|                       2022-01-25 12:12:32 |

      Exemplo 20

      select adddate(datetime '2022-01-22 12:12:32','3');

      O retorno será:

      +---------------------------------------------+
| adddate(DATETIME '2022-01-22 12:12:32', '3')|
+---------------------------------------------+
|                         2022-01-25 12:12:32 |

      Exemplo 21

      select adddate(timestamp '2022-01-22 12:12:32','3');

      O retorno será:

      +----------------------------------------------+
| adddate(TIMESTAMP '2022-01-22 12:12:32', '3')|
+----------------------------------------------+
|                          2022-01-25 12:12:32 |

      Exemplo 22

      select adddate(timestamp '2022-01-22 12:12:32',3);

      O retorno será:

      +--------------------------------------------+
| adddate(TIMESTAMP '2022-01-22 12:12:32', 3)|
+--------------------------------------------+
|                        2022-01-25 12:12:32 |

      Exemplo 23

      select adddate('2022-01-22 12:12:32',3);

      O retorno será:

      +----------------------------------+
| adddate('2022-01-22 12:12:32', 3)|
+----------------------------------+
| 2022-01-25 12:12:32              |

      Exemplo 24

      select adddate('2022-01-22 12:12:32','3');

      O retorno será:

      +------------------------------------+
| adddate('2022-01-22 12:12:32', '3')|
+------------------------------------+
| 2022-01-25 12:12:32                |

    ADDTIME

    ADDTIME(expr1,expr2)

    • Descrição: Esta função soma o tempo definido em expr2 ao tempo definido em expr1 e retorna o resultado.

    • Tipos de parâmetros:

      addtime(date,varchar)
addtime(time,varchar)
addtime(datetime,varchar)
addtime(timestamp,varchar)
addtime(varchar,varchar)

    • Tipo de dado do valor retornado: VARCHAR.

    • Exemplos:

      Exemplo 1

      select addtime(date '2022-01-01','01:01:01');

      O retorno será:

      +----------------------------------------+
| addtime(DATE '2022-01-01', '01:01:01') |
+----------------------------------------+
| 2022-01-01 01:01:01                    |

      Exemplo 2

      select addtime(time '01:00:00','01:01:01');

      O retorno será:

      +--------------------------------------+
| addtime(TIME '01:00:00', '01:01:01') |
+--------------------------------------+
| 02:01:01                             |

      Exemplo 3

      select addtime(datetime '2022-01-22 00:00:00','01:01:01');

      O retorno será:

      +----------------------------------------------------+
| addtime(DATETIME '2022-01-22 00:00:00', '01:01:01')|
+----------------------------------------------------+
| 2022-01-22 01:01:01                                |

      Exemplo 4

      select addtime(timestamp '2022-01-22 00:00:00','01:01:01');

      O retorno será:

      +-----------------------------------------------------+
| addtime(TIMESTAMP '2022-01-22 00:00:00', '01:01:01')|
+-----------------------------------------------------+
| 2022-01-22 01:01:01                                 |

      Exemplo 5

      select addtime('2022-01-22 00:00:00','01:01:01');

      O retorno será:

      +-------------------------------------------+
| addtime('2022-01-22 00:00:00', '01:01:01')|
+-------------------------------------------+
| 2022-01-22 01:01:01                       |

    CONVERT_TZ

    CONVERT_TZ(dt,from_tz,to_tz)

    • Descrição: Esta função converte o valor datetime dt do fuso horário definido em from_tz para o fuso horário definido em to_tz e retorna o resultado.

    • Tipos de parâmetros:

      convert_tz(varchar, varchar, varchar)

    • Tipo de dado do valor retornado: DATETIME.

    • Exemplos:

      Exemplo 1

      select convert_tz('2022-01-01 12:00:00','+00:00','+10:00');

      O retorno será:

      +-------------------------------------------------------+
| convert_tz('2022-01-01 12:00:00', '+00:00', '+10:00') |
+-------------------------------------------------------+
|                                   2022-01-01 22:00:00 |

      Exemplo 2

      select convert_tz('2022-01-01 12:00:00','GMT','MET');

      O retorno será:

      +-------------------------------------------------+
| convert_tz('2022-01-01 12:00:00', 'GMT', 'MET') |
+-------------------------------------------------+
|                             2022-01-01 13:00:00 |

    CURDATE

    CURDATE()

    • Descrição: Esta função retorna a data atual.

    • Tipo de dado do valor retornado: DATE.

    • Exemplo:

      select curdate;

      O retorno será:

      +------------+
| curdate()  |
+------------+
| 2022-01-01 |

    CURTIME

    CURTIME()

    • Descrição: Esta função retorna a hora atual.

    • Tipo de dado do valor retornado: TIME.

    • Exemplo:

      select curtime();

      O retorno será:

      +--------------+
| curtime()    |
+--------------+
| 14:39:22.109 |

    DATE

    DATE(expr)

    • Descrição: Esta função extrai a parte da data de uma expressão date ou datetime.

    • Tipos de parâmetros:

      date(timestamp)
date(datetime)
date(varchar)

    • Tipo de dado do valor retornado: DATE.

    • Exemplos:

      Exemplo 1

      select date(timestamp '2022-01-01 01:02:03');

      O retorno será:

      +---------------------------------------+
| date(TIMESTAMP '2022-01-01 01:02:03') |
+---------------------------------------+
| 2022-01-01                            |

      Exemplo 2

      select date(datetime '2022-01-01 01:02:03');

      O retorno será:

      +--------------------------------------+
| date(DATETIME '2022-01-01 01:02:03') |
+--------------------------------------+
| 2022-01-01                           |

      Exemplo 3

      select date('2022-01-01 01:02:03');

      O retorno será:

      +-----------------------------+
| date('2022-01-01 01:02:03') |
+-----------------------------+
| 2022-01-01                  |

    DATE_FORMAT

    DATE_FORMAT(date,format)

    • Descrição: Esta função retorna uma data como string no format especificado. A tabela a seguir descreve os especificadores de format.

      %a

      Nome abreviado do dia da semana. Valores válidos: Sun a Sat.

      %b

      Nome abreviado do mês. Valores válidos: Jan a Dec.

      %c

      Mês em formato numérico. Valores válidos: 0 a 12.

      %d

      Dia do mês em formato numérico. Valores válidos: 00 a 31.

      %e

      Dia do mês em formato numérico. Valores válidos: 0 a 31.

      %f

      Microssegundos. Valores válidos: 000000 a 999999.

      %H

      Hora. Valores válidos: 00 a 23.

      %h

      Hora. Valores válidos: 01 a 12.

      %I

      Hora. Valores válidos: 01 a 12.

      %i

      Minutos em formato numérico. Valores válidos: 00 a 59.

      %j

      Dia do ano. Valores válidos: 001 a 366.

      %k

      Hora. Valores válidos: 0 a 23.

      %l

      Hora. Valores válidos: 1 a 12.

      %M

      Nome do mês. Valores válidos: January a December.

      %m

      Mês em formato numérico. Valores válidos: 00 a 12.

      %p

      Abreviação do período de 12 horas do dia. Valores válidos: AM e PM.

      %r

      Hora no formato de 12 horas (hh:mm:ss AM ou hh:mm:ss PM).

      %S

      Segundo. Valores válidos: 00 a 59.

      %s

      Segundo. Valores válidos: 00 a 59.

      %T

      Hora no formato de 24 horas (hh:mm:ss).

      %v

      Número da semana no ano. Este especificador aplica-se ao modo 3 da função WEEK() e é usado com %x.

      Nota

      A segunda-feira é considerada o primeiro dia da semana.

      %W

      Nome do dia da semana. Valores válidos: Sunday a Saturday.

      %x

      Ano da semana em formato numérico. Este especificador é usado com %v e o valor contém quatro dígitos.

      Nota

      A segunda-feira é considerada o primeiro dia da semana.

      %Y

      Ano no formato de quatro dígitos.

      %y

      Ano no formato de dois dígitos.

      %%

      O sinal de porcentagem (%).

    • Tipos de parâmetro:

      date_format(timestamp, varchar)
date_format(varchar, varchar) 
date_format(datetime, varchar)
date_format(date, varchar)

    • Tipo de dados do valor de retorno: VARCHAR.

    • Exemplos:

      Exemplo 1

      select date_format(timestamp '2022-01-27 13:23:00', '%W %M %Y')as result;

      As seguintes informações são retornadas:

      +-----------------------+
| result                |
+-----------------------+
| Thursday January 2022 |

      Exemplo 2

      select date_format('2022-01-27 13:23:00', '%W %M %Y')as result;

      As seguintes informações são retornadas:

      +-----------------------+
| result                |
+-----------------------+
| Thursday January 2022 |

      Exemplo 3

      select date_format(datetime '2022-01-27 13:23:00', '%W %M %Y')as result;

      As seguintes informações são retornadas:

      +-----------------------+
| result                |
+-----------------------+
| Thursday January 2022 |

      Exemplo 4

      select date_format(date '2022-01-27', '%W %M %Y')as result;

      As seguintes informações são retornadas:

      +-----------------------+
| result                |
+-----------------------+
| Thursday January 2022 |

    SUBDATE/DATE_SUB

    DATE_SUB(date,INTERVAL expr unit)

    • Descrição: Esta função subtrai o intervalo especificado por INTERVAL da data especificada por date.

      Valores válidos de unit: second, minute, hour, day, month, year, minute_second, hour_second, hour_minute, day_second, day_minute, day_hour e year_month. Valor padrão de unit: day.

    • Tipos de parâmetro:

      subdate(date, INTERVAL expr unit)
subdate(timestamp, INTERVAL expr unit)
subdate(datetime, INTERVAL expr unit)
subdate(varchar, INTERVAL expr unit)
subdate(date, bigint)
subdate(date, varchar)
subdate(datetime, bigint)
subdate(datetime, varchar)
subdate(timestamp, bigint)
subdate(timestamp, varchar)
subdate(varchar, bigint)
subdate(varchar, varchar)

    • Tipo de dados do valor de retorno: DATE.

    • Exemplos:

      Exemplo 1

      select date_sub(date '2022-01-22',interval '3' day);

      As seguintes informações são retornadas:

      +-----------------------------------------------+
| date_sub(DATE '2022-01-22', INTERVAL  '3' DAY)|
+-----------------------------------------------+
| 2022-01-19                                    |

      Exemplo 2

      select date_sub(timestamp '2022-01-22 00:00:00',interval '3' day)as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-19 00:00:00 |

      Exemplo 3

      select date_sub(datetime '2022-01-22 00:00:00',interval '3' day)as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-19 00:00:00 |

      Exemplo 4

      select date_sub('2022-01-22 00:00:00',interval '3' day);

      As seguintes informações são retornadas:

      +---------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' DAY)|
+---------------------------------------------------+
| 2022-01-19 00:00:00                               |

      Exemplo 5

      select date_sub('2022-01-22 00:00:00',interval '3' second);

      As seguintes informações são retornadas:

      +------------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' SECOND)|
+------------------------------------------------------+
| 2022-01-21 23:59:57                                  |

      Exemplo 6

      select date_sub('2022-01-22 00:00:00',interval '3' minute);

      As seguintes informações são retornadas:

      +------------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' MINUTE)|
+------------------------------------------------------+
| 2022-01-21 23:57:00                                  |

      Exemplo 7

      select date_sub('2022-01-22 00:00:00',interval '3' hour);

      As seguintes informações são retornadas:

      +----------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' HOUR)|
+----------------------------------------------------+
| 2022-01-21 21:00:00                                |

      Exemplo 8

      select date_sub('2022-01-22 00:00:00',interval '3' month);

      As seguintes informações são retornadas:

      +-----------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' MONTH)|
+-----------------------------------------------------+
| 2021-10-22 00:00:00                                 |

      Exemplo 9

      select date_sub('2022-01-22 00:00:00',interval '3' year);

      As seguintes informações são retornadas:

      +----------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' YEAR)|
+----------------------------------------------------+
| 2019-01-22 00:00:00                                |

      Exemplo 10

      select date_sub('2022-01-22 00:00:00',interval '01:10' minute_second)as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-21 23:58:50 |

      Exemplo 11

      select date_sub('2022-01-22 00:00:00',interval '01:01:10' hour_second)as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-21 22:58:50 |

      Exemplo 12

      select date_sub('2022-01-22 00:00:00',interval '01:01' hour_minute)as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-21 22:59:00 |

      Exemplo 13

      select date_sub('2022-01-22 00:00:00',interval '1 01:01:10' day_second)as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-20 22:58:50 |

      Exemplo 14

      select date_sub('2022-01-22 00:00:00',interval '1 01:01' day_minute)as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-20 22:59:00 |

      Exemplo 15

      select date_sub('2022-01-22 00:00:00',interval '1 01' day_hour)as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-20 23:00:00 |

      Exemplo 16

      select date_sub('2022-01-22 00:00:00',interval '2 2' year_month)as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2019-11-22 00:00:00 |

      Exemplo 17

      select date_sub(date '2022-01-22 00:00:00',3);

      As seguintes informações são retornadas:

      +----------------------------------------+
| date_sub(DATE '2022-01-22 00:00:00', 3)|
+----------------------------------------+
| 2022-01-19                             |

      Exemplo 18

      select date_sub(date '2022-01-22 00:00:00','3');

      As seguintes informações são retornadas:

      +------------------------------------------+
| date_sub(DATE '2022-01-22 00:00:00', '3')|
+------------------------------------------+
| 2022-01-19                               |

      Exemplo 19

      select date_sub(datetime '2022-01-22 00:00:00',3);

      As seguintes informações são retornadas:

      +--------------------------------------------+
| date_sub(DATETIME '2022-01-22 00:00:00', 3)|
+--------------------------------------------+
|                        2022-01-19 00:00:00 |

      Exemplo 20

      select date_sub(datetime '2022-01-22 00:00:00','3');

      As seguintes informações são retornadas:

      +----------------------------------------------+
| date_sub(DATETIME '2022-01-22 00:00:00', '3')|
+----------------------------------------------+
|                          2022-01-19 00:00:00 |

      Exemplo 21

      select date_sub(timestamp '2022-01-22 00:00:00',3);

      As seguintes informações são retornadas:

      +---------------------------------------------+
| date_sub(TIMESTAMP '2022-01-22 00:00:00', 3)|
+---------------------------------------------+
|                         2022-01-19 00:00:00 |

      Exemplo 22

      select date_sub(timestamp '2022-01-22 00:00:00','3');

      As seguintes informações são retornadas:

      +-----------------------------------------------+
| date_sub(TIMESTAMP '2022-01-22 00:00:00', '3')|
+-----------------------------------------------+
|                           2022-01-19 00:00:00 |

      Exemplo 23

      select date_sub('2022-01-22 00:00:00',3);

      As seguintes informações são retornadas:

      +-----------------------------------+
| date_sub('2022-01-22 00:00:00', 3)|
+-----------------------------------+
| 2022-01-19 00:00:00               |

      Exemplo 24

      select date_sub('2022-01-22 00:00:00','3');

      As seguintes informações são retornadas:

      +-------------------------------------+
| date_sub('2022-01-22 00:00:00', '3')|
+-------------------------------------+
| 2022-01-19 00:00:00                 |

    DATEDIFF

    DATEDIFF(expr1,expr2)

    • Descrição: Esta função subtrai a data especificada por expr2 da data especificada por expr1.

    • Tipos de parâmetro:

      datediff(varchar, varchar) 
datediff(datetime, varchar)
datediff(varchar, datetime)
datediff(datetime, datetime)
datediff(varchar, timestamp)
datediff(timestamp, timestamp)
datediff(timestamp, varchar)
datediff(date, date)
datediff(date, varchar)
datediff(varchar, date)

    • Tipo de dados do valor de retorno: BIGINT.

    • Exemplos:

      Exemplo 1

      select datediff('2022-01-22 23:59:59','2022-1-21');

      As seguintes informações são retornadas:

      +-----------------------------------------------+
| datediff('2022-01-22 23:59:59','2022-1-21')   |
+-----------------------------------------------+
|                                             1 |

      Exemplo 2

      select datediff(datetime '2022-01-22 23:59:59','2022-1-21')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|      1 |

      Exemplo 3

      select datediff('2022-01-22 23:59:59',datetime '2022-1-21')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|      1 |

      Exemplo 4

      select datediff(datetime '2022-01-22 23:59:59',datetime '2022-1-21')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|      1 |

      Exemplo 5

      select datediff('2022-01-22 23:59:59',timestamp '2022-1-21')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|      1 |

      Exemplo 6

      select datediff(timestamp '2022-01-22 23:59:59',timestamp '2022-1-21')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|      1 |

      Exemplo 7

      select datediff(timestamp '2022-01-22 23:59:59','2022-1-21')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|      1 |

      Exemplo 8

      select datediff(date '2022-01-22 23:59:59',date '2022-01-21')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|      1 |

      Exemplo 9

      select datediff(date '2022-01-22 23:59:59','2022-01-21')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|      1 |

      Exemplo 10

      select datediff('2022-01-22',date '2021-01-21');

      As seguintes informações são retornadas:

      +-------------------------------------------+
| datediff('2022-01-22', DATE '2021-01-21') |
+-------------------------------------------+
|                                      366  |

    DAY/DAYOFMONTH

    DAY(date)
DAYOFMONTH(date)

    • Descrição: Retorna o dia do mês para a data especificada por date. Valores válidos: 1 to 31.

    • Tipos de parâmetro:

      dayofmonth(timestamp)
dayofmonth(datetime)
dayofmonth(date)
dayofmonth(time)
dayofmonth(varchar)

    • Tipo de dados do valor de retorno: BIGINT.

    • Exemplos:

      Exemplo 1

      select dayofmonth(timestamp '2022-01-22 12:23:09');

      As seguintes informações são retornadas:

      +---------------------------------------------+
| dayofmonth(TIMESTAMP '2022-01-22 12:23:09') |
+---------------------------------------------+
|                                          22 |

      Exemplo 2

      select dayofmonth(date '2022-01-22');

      As seguintes informações são retornadas:

      +-------------------------------+
| dayofmonth(DATE '2022-01-22') |
+-------------------------------+
|                            22 |

      Exemplo 3

      select dayofmonth(time '17:01:10');

      A seguinte informação mostrando a data atual é retornada:

      +-----------------------------+
| dayofmonth(TIME '17:01:10') |
+-----------------------------+
|                          22 |

      Exemplo 4

      select dayofmonth(datetime '2022-01-22 00:00:00');

      As seguintes informações são retornadas:

      +--------------------------------------------+
| dayofmonth(DATETIME '2022-01-22 00:00:00') |
+--------------------------------------------+
|                                         22 |

      Exemplo 5

      select day('2022-01-22');

      As seguintes informações são retornadas:

      +-------------------+
| day('2022-01-22') |
+-------------------+
|                22 |

    DAYNAME

    DAYNAME(date)

    • Descrição: Retorna o dia da semana para uma data, como Monday.

    • Tipos de parâmetro:

      dayname(timestamp)
dayname(datetime)
dayname(date)
dayname(varchar)

    • Tipo de dados do valor de retorno: VARCHAR.

    • Exemplos:

      Exemplo 1

      select dayname(timestamp '2022-01-22 00:00:00');

      As seguintes informações são retornadas:

      +------------------------------------------+
| dayname(TIMESTAMP '2022-01-22 00:00:00') |
+------------------------------------------+
| Saturday                                 |

      Exemplo 2

      select dayname(datetime '2022-01-22 00:00:00');

      As seguintes informações são retornadas:

      +-----------------------------------------+
| dayname(DATETIME '2022-01-22 00:00:00') |
+-----------------------------------------+
| Saturday                                |

      Exemplo 3

      select dayname(date '2022-01-22');

      As seguintes informações são retornadas:

      +----------------------------+
| dayname(DATE '2022-01-22') |
+----------------------------+
| Saturday                   |

      Exemplo 4

      select dayname('2022-01-22');

      As seguintes informações são retornadas:

      +-----------------------+
| dayname('2022-01-22') |
+-----------------------+
| Saturday              |

    DAYOFWEEK

    DAYOFWEEK(date)

    • Descrição: Retorna o dia da semana como um valor numérico para uma data, onde 1 representa domingo, 2 representa segunda-feira e 7 representa sábado.

    • Tipos de parâmetro:

      dayofweek(timestamp)
dayofweek(datetime)
dayofweek(date)
dayofweek(varchar)

    • Tipo de dados do valor de retorno: BIGINT.

    • Exemplos:

      Exemplo 1

      select dayofweek(timestamp '2022-01-22 00:00:00');

      As seguintes informações são retornadas:

      +--------------------------------------------+
| dayofweek(TIMESTAMP '2022-01-22 00:00:00') |
+--------------------------------------------+
|                                          7 |

      Exemplo 2

      select dayofweek(datetime '2022-01-22 00:00:00');

      As seguintes informações são retornadas:

      +-------------------------------------------+
| dayofweek(DATETIME '2022-01-22 00:00:00') |
+-------------------------------------------+
|                                         7 |

      Exemplo 3

      select dayofweek(date '2022-01-22');

      As seguintes informações são retornadas:

      +------------------------------+
| dayofweek(DATE '2022-01-22') |
+------------------------------+
|                            7 |

      Exemplo 4

      select dayofweek('2022-01-22');

      As seguintes informações são retornadas:

      +-------------------------+
| dayofweek('2022-01-22') |
+-------------------------+
|                       7 |

    DAYOFYEAR

    DAYOFYEAR(date)

    • Descrição: Retorna o dia do ano para uma data. Valores válidos: 1 to 366.

    • Tipos de parâmetro:

      dayofyear(timestamp)
dayofyear(datetime) 
dayofyear(date) 
dayofyear(varchar)

    • Tipo de dados do valor de retorno: BIGINT.

    • Exemplos:

      Exemplo 1

      select dayofyear(timestamp '2022-02-01 00:12:12');

      As seguintes informações são retornadas:

      +--------------------------------------------+
| dayofyear(TIMESTAMP '2022-02-01 00:12:12') |
+--------------------------------------------+
|                                         32 |

      Exemplo 2

      select dayofyear(datetime '2022-02-01 00:12:12');

      As seguintes informações são retornadas:

      +-------------------------------------------+
| dayofyear(DATETIME '2022-02-01 00:12:12') |
+-------------------------------------------+
|                                        32 |

      Exemplo 3

      select dayofyear(date '2022-02-01');

      As seguintes informações são retornadas:

      +------------------------------+
| dayofyear(DATE '2022-02-01') |
+------------------------------+
|                           32 |

      Exemplo 4

      select dayofyear('2022-02-01');

      As seguintes informações são retornadas:

      +-------------------------+
| dayofyear('2022-02-01') |
+-------------------------+
|                      32 |

    EXTRACT

    EXTRACT(unit FROM date)

    • Descrição: Esta função retorna uma ou mais partes separadas de uma data ou hora na unit especificada. Por exemplo, é possível obter o ano, mês, dia, hora ou minuto de um valor de data ou hora.

      Valores válidos para unit: second, minute, hour, day, month, year, minute_second, hour_second, hour_minute, day_second, day_minute, day_hour e year_month.

    • Tipos de parâmetro de entrada suportados: VARCHAR, TIMESTAMP, DATETIME e TIME.

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select extract(second from '2022-01-22 00:12:34');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|    34 |

      Exemplo 2

      select extract(minute from '2022-01-22 00:12:34');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|    12 |

      Exemplo 3

      select extract(hour from '2022-01-22 00:12:34');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|     0 |

      Exemplo 4

      select extract(day from '2022-01-22 00:12:34');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|    22 |

      Exemplo 5

      select extract(month from '2022-01-22 00:12:34');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|     1 |

      Exemplo 6

      select extract(year from timestamp '2022-01-22');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|  2022 |

      Exemplo 7

      select extract(year from datetime  '2022-01-22');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|  2022 |

      Exemplo 8

      select extract(year from time '15:23:22');

      O resultado exibe o ano atual conforme mostrado abaixo.

      +-------+
| _col0 |
+-------+
|  2022 |

      Exemplo 9

      select extract(minute_second from '2022-01-22 00:12:34');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|  1234 |

      Exemplo 10

      select extract(hour_second from '2022-01-22 12:12:34');

      As seguintes informações são retornadas:

      +--------+
| _col0  |
+--------+
| 121234 |

      Exemplo 11

      select extract(hour_minute from '2022-01-22 12:12:34');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|  1212 |

      Exemplo 12

      select extract(day_second from '2022-01-22 12:12:34');

      As seguintes informações são retornadas:

      +----------+
| _col0    |
+----------+
| 22121234 |

      Exemplo 13

      select extract(day_minute from '2022-01-22 00:12:34');

      As seguintes informações são retornadas:

      +--------+
| _col0  |
+--------+
| 220012 |

      Exemplo 14

      select extract(day_hour from '2022-01-22 12:12:34');

      As seguintes informações são retornadas:

      +-------+
| _col0 |
+-------+
|  2212 |

      Exemplo 15

      select extract(year_month from '2022-01-22 00:12:34');

      As seguintes informações são retornadas:

      +--------+
| _col0  |
+--------+
| 202201 |

    FROM_DAYS

    FROM_DAYS(N)

    • Descrição: Retorna um valor DATE com base no parâmetro N, que especifica o número de dias.

    • Tipos de parâmetro:

      from_days(varchar) 
from_days(bigint)

    • Tipo de dados do valor retornado: DATE.

    • Exemplos:

      Exemplo 1

      select from_days(738565);

      As seguintes informações são retornadas:

      +-------------------+
| from_days(738565) |
+-------------------+
|  2022-02-14       |

      Exemplo 2

      select from_days('738565');

      As seguintes informações são retornadas:

      +---------------------+
| from_days('738565') |
+---------------------+
|  2022-02-14         |

    FROM_UNIXTIME

    FROM_UNIXTIME(unix_timestamp[,format])

    • Descrição: Converte o timestamp UNIX especificado por unix para o format definido.

      O parâmetro format segue as mesmas regras de format da função DATE_FORMAT.

    • Tipos de parâmetro:

      from_unixtime(varchar, varchar)
from_unixtime(varchar)
from_unixtime(double, varchar)
from_unixtime(double)

    • Tipo de dados do valor retornado: DATETIME.

    • Exemplos:

      Exemplo 1

      select from_unixtime('1647738565','%Y %M %h:%i:%s %x');

      As seguintes informações são retornadas:

      +--------------------------------------------------+
| from_unixtime('1647738565', '%Y %M %h:%i:%s %x') |
+--------------------------------------------------+
|    2022 March 09:09:25 2022                      |

      Exemplo 2

      select from_unixtime('1647738565');

      As seguintes informações são retornadas:

      +-----------------------------+
| from_unixtime('1647738565') |
+-----------------------------+
|         2022-03-20 09:09:25 |

      Exemplo 3

      select from_unixtime(1647738456);

      As seguintes informações são retornadas:

      +---------------------------+
| from_unixtime(1647738456) |
+---------------------------+
|       2022-03-20 09:07:36 |

      Exemplo 4

      select from_unixtime(1647738456,'%Y %M %h:%i:%s %x');

      As seguintes informações são retornadas:

      +------------------------------------------------+
| from_unixtime(1647738456, '%Y %M %h:%i:%s %x') |
+------------------------------------------------+
|     2022 March 09:07:36 2022                   |

    HOUR

    HOUR(time)

    • Descrição: Extrai a parte correspondente à hora de um valor de tempo.

    • Tipos de parâmetro:

      hour(timestamp)
hour(datetime)
hour(date)
hour(time)
hour(varchar)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select hour(timestamp '2022-01-22 10:05:03');

      As seguintes informações são retornadas:

      +---------------------------------------+
| hour(TIMESTAMP '2022-01-22 10:05:03') |
+---------------------------------------+
|                                    10 |

      Exemplo 2

      select hour(datetime '2022-01-22 10:05:03');

      As seguintes informações são retornadas:

      +--------------------------------------+
| hour(DATETIME '2022-01-22 10:05:03') |
+--------------------------------------+
|                                   10 |

      Exemplo 3

      select hour(date '2022-01-22');

      As seguintes informações são retornadas:

      +-------------------------+
| hour(DATE '2022-01-22') |
+-------------------------+
|                       0 |

      Exemplo 4

      select hour(time '10:05:03');

      As seguintes informações são retornadas:

      +-----------------------+
| hour(TIME '10:05:03') |
+-----------------------+
|                    10 |

      Exemplo 5

      select hour('10:05:03');

      As seguintes informações são retornadas:

      +------------------+
| hour('10:05:03') |
+------------------+
|       10         |

    LAST_DAY

    LAST_DAY(date)

    • Descrição: Obtém o último dia do mês referente a uma data ou datetime fornecido.

    • Tipos de parâmetro:

      last_day(varchar)
last_day(timestamp)
last_day(datetime)
last_day(date)

    • Tipo de dados do valor retornado: DATE.

    • Exemplos:

      Exemplo 1

      select last_day('2022-01-22');

      As seguintes informações são retornadas:

      +------------------------+
| last_day('2022-01-22') |
+------------------------+
| 2022-01-31             |

      Exemplo 2

      select last_day(timestamp '2022-01-22 12:12:12');

      As seguintes informações são retornadas:

      +-------------------------------------------+
| last_day(TIMESTAMP '2022-01-22 12:12:12') |
+-------------------------------------------+
| 2022-01-31                                |

      Exemplo 3

      select last_day(datetime '2022-01-22 12:12:12');

      As seguintes informações são retornadas:

      +------------------------------------------+
| last_day(DATETIME '2022-01-22 12:12:12') |
+------------------------------------------+
| 2022-01-31                               |

      Exemplo 4

      select last_day(date '2022-01-22');

      As seguintes informações são retornadas:

      +-----------------------------+
| last_day(DATE '2022-01-22') |
+-----------------------------+
| 2022-01-31                  |

    LOCALTIME/LOCALTIMESTAMP/NOW

    localtime
localtime()
localtimestamp
localtimestamp()
now()

    • Descrição: Fornece o timestamp atual do sistema.

    • Tipo de dados do valor retornado: DATETIME.

    • Exemplos:

      Exemplo 1

      select now();

      As seguintes informações são retornadas:

      +---------------------+
| now()               |
+---------------------+
| 2022-01-22 16:28:37 |

      Exemplo 2

      select localtime;

      As seguintes informações são retornadas:

      +---------------------+
| localtime()         |
+---------------------+
| 2022-01-22 16:28:37 |

      Exemplo 3

      select localtime();

      As seguintes informações são retornadas:

      +---------------------+
| localtime()         |
+---------------------+
| 2022-01-22 16:28:37 |

      Exemplo 4

      select localtimestamp;

      As seguintes informações são retornadas:

      +---------------------+
| localtimestamp()    |
+---------------------+
| 2022-01-22 17:28:37 |

      Exemplo 5

      select localtimestamp();

      As seguintes informações são retornadas:

      +---------------------+
| localtimestamp()    |
+---------------------+
| 2022-01-22 17:38:13 |

    MAKEDATE

    MAKEDATE(year,dayofyear)

    • Descrição: Gera uma data utilizando os parâmetros year e dayofyear.

    • Tipos de parâmetro:

      makedate(bigint, bigint)
makedate(varchar, varchar)

    • Tipo de dados do valor retornado: DATE.

    • Exemplos:

      Exemplo 1

      select makedate(2022,31), makedate(2022,32);

      As seguintes informações são retornadas:

      +--------------------+--------------------+
| makedate(2022, 31) | makedate(2022, 32) |
+--------------------+--------------------+
| 2022-01-31         | 2022-02-01         |

      Exemplo 2

      select makedate('2022','31'), makedate('2022','32');

      As seguintes informações são retornadas:

      +------------------------+------------------------+
| makedate('2022', '31') | makedate('2022', '32') |
+------------------------+------------------------+
| 2022-01-31             | 2022-02-01             |

    MAKETIME

    MAKETIME(hour,minute,second)

    • Descrição: Cria um valor de tempo a partir dos parâmetros hour, minute e second.

    • Tipos de parâmetro:

      maketime(bigint, bigint, bigint)
maketime(varchar, varchar, varchar)

    • Tipo de dados do valor retornado: TIME.

    • Exemplos:

      Exemplo 1

      select maketime(12,15,30);

      As seguintes informações são retornadas:

      +----------------------+
| maketime(12, 15, 30) |
+----------------------+
| 12:15:30             |

      Exemplo 2

      select maketime('12','15','30');

      As seguintes informações são retornadas:

      +----------------------------+
| maketime('12', '15', '30') |
+----------------------------+
| 12:15:30                   |

    MINUTE

    MINUTE(time)

    • Descrição: Recupera a parte dos minutos de um valor temporal.

    • Tipos de parâmetro:

      minute(timestamp)
minute(datetime)
minute(date)
minute(time)
minute(varchar)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select minute(timestamp '2022-02-03 10:05:03');

      As seguintes informações são retornadas:

      +-----------------------------------------+
| minute(TIMESTAMP '2022-02-03 10:05:03') |
+-----------------------------------------+
|                                       5 |

      Exemplo 2

      select minute(datetime '2022-02-03 10:05:03');

      As seguintes informações são retornadas:

      +----------------------------------------+
| minute(DATETIME '2022-02-03 10:05:03') |
+----------------------------------------+
|                                      5 |

      Exemplo 3

      select minute(date '2022-02-03');

      As seguintes informações são retornadas:

      +---------------------------+
| minute(DATE '2022-02-03') |
+---------------------------+
|                         0 |

      Exemplo 4

      select minute(time '12:12:12');

      As seguintes informações são retornadas:

      +-------------------------+
| minute(TIME '12:12:12') |
+-------------------------+
|                      12 |

      Exemplo 5

      select minute('2022-02-03 10:05:03');

      As seguintes informações são retornadas:

      +-------------------------------+
| minute('2022-02-03 10:05:03') |
+-------------------------------+
|                             5 |

    MONTH

    MONTH(date)

    • Descrição: Identifica o componente mensal de uma data.

    • Tipos de parâmetro:

      month(timestamp)
month(datetime)
month(date)
month(time)
month(varchar)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select month(timestamp '2022-02-03 00:00:00');

      As seguintes informações são retornadas:

      +----------------------------------------+
| month(TIMESTAMP '2022-02-03 00:00:00') |
+----------------------------------------+
|                                      2 |

      Exemplo 2

      select month(datetime '2022-02-03 00:00:00');

      As seguintes informações são retornadas:

      +---------------------------------------+
| month(DATETIME '2022-02-03 00:00:00') |
+---------------------------------------+
|                                     2 |

      Exemplo 3

      select month(date '2022-02-03');

      As seguintes informações são retornadas:

      +--------------------------+
| month(DATE '2022-02-03') |
+--------------------------+
|                        2 |

      Exemplo 4

      A função MONTH também pode retornar o mês em que uma instrução SQL é executada. No exemplo a seguir, o valor 5 é retornado para uma instrução SQL executada em maio de 2021.

      select month(time '12:12:12');

      As seguintes informações são retornadas:

      +------------------------+
| month(TIME '12:12:12') |
+------------------------+
|                      5 |

      Exemplo 5

      select month('2022-02-03');

      As seguintes informações são retornadas:

      +---------------------+
| month('2022-02-03') |
+---------------------+
|                   2 |

    MONTHNAME

    MONTHNAME(date)

    • Descrição: Devolve o nome completo do mês correspondente a uma data.

    • Tipos de parâmetro:

      monthname(timestamp)
monthname(datetime)
monthname(date)
monthname(varchar)

    • Tipo de dados do valor retornado: VARCHAR.

    • Exemplos:

      Exemplo 1

      select monthname(timestamp '2022-02-03 00:00:00');

      As seguintes informações são retornadas:

      +--------------------------------------------+
| monthname(TIMESTAMP '2022-02-03 00:00:00') |
+--------------------------------------------+
| February                                   |

      Exemplo 2

      select monthname(datetime '2022-02-03 00:00:00');

      As seguintes informações são retornadas:

      +-------------------------------------------+
| monthname(DATETIME '2022-02-03 00:00:00') |
+-------------------------------------------+
| February                                  |

      Exemplo 3

      select monthname(date '2022-02-03');

      As seguintes informações são retornadas:

      +------------------------------+
| monthname(DATE '2022-02-03') |
+------------------------------+
| February                     |

      Exemplo 4

      select monthname('2022-02-03');

      As seguintes informações são retornadas:

      +-------------------------+
| monthname('2022-02-03') |
+-------------------------+
| February                |

    PERIOD_ADD

    PERIOD_ADD(P,N)

    • Descrição: Adiciona um número de meses definido por N ao período indicado por P.

    • Tipos de parâmetro:

      period_add(bigint, bigint)
period_add(varchar, varchar) 
period_add(varchar, bigint)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select period_add(202201,2);

      As seguintes informações são retornadas:

      +-----------------------+
| period_add(202201, 2) |
+-----------------------+
|                202203 |

      Exemplo 2

      select period_add('202201','2');

      As seguintes informações são retornadas:

      +---------------------------+
| period_add('202201', '2') |
+---------------------------+
|                    202203 |

      Exemplo 3

      select period_add('202201',2);

      As seguintes informações são retornadas:

      +-------------------------+
| period_add('202201', 2) |
+-------------------------+
|                  202203 |

    PERIOD_DIFF

    PERIOD_DIFF(P1,P2)

    • Descrição: Calcula a diferença em meses entre dois períodos, P1 e P2.

    • Tipos de parâmetro:

      period_diff(bigint, bigint)
period_diff(varchar, varchar)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select period_diff(202202,202103);

      As seguintes informações são retornadas:

      +----------------------------+
| period_diff(202202,202103) |
+----------------------------+
|                         11 |

      Exemplo 2

      select period_diff('202202','202103');

      As seguintes informações são retornadas:

      +---------------------------------+
| period_diff('202202', '202103') |
+---------------------------------+
|                              11 |

    QUARTER

    QUARTER(date)

    • Descrição: Indica o trimestre do ano para uma determinada data. Valores válidos: 1 to 4.

    • Tipos de parâmetro:

      quarter(datetime)
quarter(varchar)
quarter(timestamp)
quarter(date)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select quarter(datetime '2022-04-01 12:12:12');

      As seguintes informações são retornadas:

      +-----------------------------------------+
| quarter(DATETIME '2022-04-01 12:12:12') |
+-----------------------------------------+
|                                       2 |

      Exemplo 2

      select quarter('2022-04-01');

      As seguintes informações são retornadas:

      +-----------------------+
| quarter('2022-04-01') |
+-----------------------+
|                     2 |

      Exemplo 3

      select quarter(timestamp '2022-04-01 12:12:12');

      As seguintes informações são retornadas:

      +------------------------------------------+
| quarter(TIMESTAMP '2022-04-01 12:12:12') |
+------------------------------------------+
|                                        2 |

      Exemplo 4

      select quarter(date '2022-04-01');

      As seguintes informações são retornadas:

      +----------------------------+
| quarter(DATE '2022-04-01') |
+----------------------------+
|                          2 |

    SEC_TO_TIME

    SEC_TO_TIME(seconds)

    • Descrição: Esta função converte uma quantidade de segundos especificada por seconds em um valor de tempo.

    • Tipos de parâmetros:

      sec_to_time(bigint)
sec_to_time(varchar)

    • Tipo de dados do valor retornado: TIME.

    • Exemplos:

      Exemplo 1

      select sec_to_time(2378);

      As seguintes informações são retornadas:

      +-------------------+
| sec_to_time(2378) |
+-------------------+
| 00:39:38          |

      Exemplo 2

      select sec_to_time('2378');

      As seguintes informações são retornadas:

      +---------------------+
| sec_to_time('2378') |
+---------------------+
| 00:39:38            |

    SECOND

    SECOND(time)

    • Descrição: Retorna a parte dos segundos do tempo especificado. Valores válidos: 0 to 59.

    • Tipos de parâmetros:

      second(timestamp)
second(datetime)
second(date)
second(time)
second(varchar)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select second(timestamp '2022-03-12 12:13:14');

      As seguintes informações são retornadas:

      +-----------------------------------------+
| second(TIMESTAMP '2022-03-12 12:13:14') |
+-----------------------------------------+
|                                      14 |

      Exemplo 2

      select second(datetime '2022-03-12 12:13:14');

      As seguintes informações são retornadas:

      +----------------------------------------+
| second(DATETIME '2022-03-12 12:13:14') |
+----------------------------------------+
|                                     14 |

      Exemplo 3

      select second(date '2022-03-12');

      As seguintes informações são retornadas:

      +---------------------------+
| second(DATE '2022-03-12') |
+---------------------------+
|                         0 |

      Exemplo 3

      select second(time '12:13:14');

      As seguintes informações são retornadas:

      +-------------------------+
| second(TIME '12:13:14') |
+-------------------------+
|                      14 |

      Exemplo 4

      select second('12:12:23');

      As seguintes informações são retornadas:

      +--------------------+
| second('12:12:23') |
+--------------------+
|                 23 |

    STR_TO_DATE

    STR_TO_DATE(str,format)

    • Descrição: Converte uma string em uma data ou datetime no formato especificado.

      O parâmetro format segue o mesmo padrão de format da função DATE_FORMAT.

    • Tipos de parâmetros:

      str_to_date(varchar, varchar)

    • Tipo de dados do valor retornado: DATETIME.

    • Exemplos:

      Exemplo 1

      select str_to_date('2022-01-06 10:20:30','%Y-%m-%d %H:%i:%s') as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-06 10:20:30 |

    SUBTIME

    SUBTIME(expr1,expr2)

    • Descrição: Subtrai o intervalo especificado por expr2 do tempo especificado por expr1.

    • Tipos de parâmetros:

      subtime(date, varchar)
subtime(datetime, varchar)
subtime(timestamp, varchar)
subtime(time, varchar)
subtime(varchar, varchar)

    • Tipo de dados do valor retornado: DATETIME.

    • Exemplos:

      Exemplo 1

      select subtime(date '2022-10-31','0:1:1');

      As seguintes informações são retornadas:

      +-------------------------------------+
| subtime(DATE '2022-10-31', '0:1:1') |
+-------------------------------------+
|                 2022-10-30 23:58:59 |

      Exemplo 2

      select subtime(datetime '2022-10-31 12:12:12','0:1:1');

      As seguintes informações são retornadas:

      +--------------------------------------------------+
| subtime(DATETIME '2022-10-31 12:12:12', '0:1:1') |
+--------------------------------------------------+
|                              2022-10-31 12:11:11 |

      Exemplo 3

      select subtime(timestamp '2022-10-31 12:12:12','0:1:1');

      As seguintes informações são retornadas:

      +---------------------------------------------------+
| subtime(TIMESTAMP '2022-10-31 12:12:12', '0:1:1') |
+---------------------------------------------------+
|                               2022-10-31 12:11:11 |

      Exemplo 4

      select subtime(time '12:12:12','0:1:1');

      As seguintes informações são retornadas:

      +-----------------------------------+
| subtime(TIME '12:12:12', '0:1:1') |
+-----------------------------------+
| 12:11:11                          |
+-----------------------------------+

      Exemplo 5

      select subtime('2022-10-31 23:59:59','0:1:1');

      As seguintes informações são retornadas:

      +-----------------------------------------+
| subtime('2022-10-31 23:59:59', '0:1:1') |
+-----------------------------------------+
| 2022-10-31 23:58:58                     |

    SYSDATE

    SYSDATE()

    • Descrição: Retorna a hora atual do sistema.

    • Tipo de dados do valor retornado: DATETIME.

    • Exemplos:

      Exemplo 1

      select sysdate();

      As seguintes informações são retornadas:

      +---------------------+
| sysdate()           |
+---------------------+
| 2022-02-26 00:47:21 |

    TIME

    TIME(expr)

    • Descrição: Extrai a parte do tempo da expressão de data ou datetime especificada por expr e a retorna como uma string.

    • Tipos de parâmetros:

      time(varchar)
time(datetime)
time(timestamp)

    • Tipo de dados do valor retornado: VARCHAR.

    • Exemplos:

      Exemplo 1

      select time('2022-01-31 01:02:03');

      As seguintes informações são retornadas:

      +-----------------------------+
| time('2022-01-31 01:02:03') |
+-----------------------------+
| 01:02:03                    |

      Exemplo 2

      select time(datetime '2022-01-31 01:02:03');

      As seguintes informações são retornadas:

      +--------------------------------------+
| time(DATETIME '2022-01-31 01:02:03') |
+--------------------------------------+
| 01:02:03                             |

      Exemplo 3

      select time(timestamp '2022-01-31 01:02:03');

      As seguintes informações são retornadas:

      +---------------------------------------+
| time(TIMESTAMP '2022-01-31 01:02:03') |
+---------------------------------------+
| 01:02:03                              |

    TIME_FORMAT

    TIME_FORMAT(time,format)

    • Descrição: Formata o tempo especificado por time como uma string no format definido.

      O parâmetro format segue o mesmo padrão de format da função DATE_FORMAT.

    • Tipos de parâmetros:

      time_format(varchar, varchar) 
time_format(timestamp, varchar)
time_format(datetime, varchar)
time_format(time, varchar) 
time_format(date, varchar)

    • Tipo de dados do valor retornado: VARCHAR.

    • Exemplos:

      Exemplo 1

      select time_format('12:00:00', '%H %k %h %I %l');

      As seguintes informações são retornadas:

      +-------------------------------------------+
| time_format('12:00:00', '%H %k %h %I %l') |
+-------------------------------------------+
| 12 12 12 12 12                            |

      Exemplo 2

      select time_format(timestamp '2022-01-22 23:00:00','%H %k %h %I %l')as result;

      As seguintes informações são retornadas:

      +----------------+
| result         |
+----------------+
| 23 23 11 11 11 |

      Exemplo 3

      select time_format(datetime '2022-01-22 23:00:00','%H %k %h %I %l')as result;

      As seguintes informações são retornadas:

      +----------------+
| result         |
+----------------+
| 23 23 11 11 11 |

      Exemplo 4

      select time_format(time '23:00:00','%H %k %h %I %l');

      As seguintes informações são retornadas:

      +------------------------------------------------+
| time_format(TIME '23:00:00', '%H %k %h %I %l') |
+------------------------------------------------+
| 23 23 11 11 11                                 |

      Exemplo 5

      select time_format(date '2022-01-22','%H %k %h %I %l');

      As seguintes informações são retornadas:

      +--------------------------------------------------+
| time_format(DATE '2022-01-22', '%H %k %h %I %l') |
+--------------------------------------------------+
| 00 0 12 12 12                                    |

    TIME_TO_SEC

    TIME_TO_SEC(time)

    • Descrição: Converte o tempo especificado por time em uma quantidade total de segundos.

    • Tipos de parâmetros:

      time_to_sec(varchar)
time_to_sec(datetime)
time_to_sec(timestamp)
time_to_sec(date)
time_to_sec(time)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select time_to_sec(datetime '2022-01-22 22:23:00');

      As seguintes informações são retornadas:

      +---------------------------------------------+
| time_to_sec(DATETIME '2022-01-22 22:23:00') |
+---------------------------------------------+
|                                       80580 |

      Exemplo 2

      select time_to_sec(timestamp '2022-01-22 22:23:00');

      As seguintes informações são retornadas:

      +----------------------------------------------+
| time_to_sec(TIMESTAMP '2022-01-22 22:23:00') |
+----------------------------------------------+
|                                        80580 |

      Exemplo 3

      select time_to_sec(date '2022-01-22');

      As seguintes informações são retornadas:

      +--------------------------------+
| time_to_sec(DATE '2022-01-22') |
+--------------------------------+
|                              0 |

      Exemplo 4

      select time_to_sec(time '12:12:12');

      As seguintes informações são retornadas:

      +------------------------------+
| time_to_sec(TIME '12:12:12') |
+------------------------------+
|                        43932 |

      Exemplo 5

      select time_to_sec('22:23:00');

      As seguintes informações são retornadas:

      +-------------------------+
| time_to_sec('22:23:00') |
+-------------------------+
|                   80580 |

    TIMEDIFF

    TIMEDIFF(expr1,expr2)

    • Descrição: Subtrai o tempo especificado por expr2 do tempo especificado por expr1. Esta função é equivalente à função SUBTIME.

    • Tipos de parâmetros:

      timediff(time, varchar)
timediff(time, time)
timediff(varchar, varchar)

    • Tipo de dados do valor retornado: DATETIME.

    • Exemplos:

      Exemplo 1

      select timediff(time '12:00:00','10:00:00');

      As seguintes informações são retornadas:

      +---------------------------------------+
| timediff(TIME '12:00:00', '10:00:00') |
+---------------------------------------+
| 02:00:00                              |

      Exemplo 2

      select timediff('12:00:00','10:00:00');

      As seguintes informações são retornadas:

      +----------------------------------+
| timediff('12:00:00', '10:00:00') |
+----------------------------------+
| 02:00:00                         |

      Exemplo 3

      select timediff(time '12:00:00',time '10:00:00');

      As seguintes informações são retornadas:

      +--------------------------------------------+
| timediff(TIME '12:00:00', TIME '10:00:00') |
+--------------------------------------------+
| 02:00:00                                   |

    TIMESTAMP

    TIMESTAMP(expr)

    • Descrição: Retorna a expressão de data ou datetime especificada por expr como um valor datetime.

    • Tipos de parâmetros:

      timestamp(date)
timestamp(varchar)

    • Tipo de dados do valor retornado: DATETIME.

    • Exemplos:

      Exemplo 1

      select timestamp(date '2022-01-22');

      As seguintes informações são retornadas:

      +------------------------------+
| timestamp(DATE '2022-01-22') |
+------------------------------+
| 2022-01-22 00:00:00          |

      Exemplo 2

      select timestamp('2022-01-22');

      As seguintes informações são retornadas:

      +-------------------------+
| timestamp('2022-01-22') |
+-------------------------+
|     2022-01-22 00:00:00 |

    TIMESTAMPADD

    TIMESTAMPADD(unit,interval,datetime_expr)

    • Descrição: Adiciona o intervalo especificado por interval à expressão de data ou datetime indicada por datetime_expr. O parâmetro unit define a unidade do interval.

      Valores válidos para unit: second, minute, hour, day, week, month, quarter e year.

    • Tipos de parâmetros:

      timestampadd(varchar, varchar, timestamp) 
timestampadd(varchar, bigint, timestamp)
timestampadd(varchar, varchar, date)
timestampadd(varchar, bigint, date)
timestampadd(varchar, varchar, datetime)
timestampadd(varchar, bigint, datetime) 
timestampadd(varchar, varchar, varchar)
timestampadd(varchar, bigint, varchar)

    • Tipo de dados do valor retornado: DATETIME.

    • Exemplos:

      Exemplo 1

      select timestampadd(second,'1',timestamp '2022-01-02 12:12:12')as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

      Exemplo 2

      select timestampadd(second,1,timestamp '2022-01-02 12:12:12')as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

      Exemplo 3

      select timestampadd(second,'1',date '2022-01-02 12:12:12')as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-02 00:00:01 |

      Exemplo 4

      select timestampadd(second,1,date '2022-01-02 12:12:12')as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-02 00:00:01 |

      Exemplo 5

      select timestampadd(second,'1',datetime '2022-01-02 12:12:12')as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

      Exemplo 6

      select timestampadd(second,1,datetime '2022-01-02 12:12:12')as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

      Exemplo 7

      select timestampadd(second,'1','2022-01-02 12:12:12')as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

      Exemplo 8

      select timestampadd(second,1,'2022-01-02 12:12:12')as result;

      As seguintes informações são retornadas:

      +---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

      Exemplo 9

      select timestampadd(second,1,'2022-01-02 12:12:12');

      As seguintes informações são retornadas:

      +--------------------------------------------------+
| timestampadd('second', 1, '2022-01-02 12:12:12') |
+--------------------------------------------------+
| 2022-01-02 12:12:13                              |

      Exemplo 10

      select timestampadd(minute,8820,'2022-02-24 09:00:00');

      As seguintes informações são retornadas:

      +-----------------------------------------------------+
| timestampadd('MINUTE', 8820, '2022-02-24 09:00:00') |
+-----------------------------------------------------+
| 2022-03-02 12:00:00                                 |

      Exemplo 11

      select timestampadd(hour,1,'2022-01-02 12:12:12');

      As seguintes informações são retornadas:

      +------------------------------------------------+
| timestampadd('hour', 1, '2022-01-02 12:12:12') |
+------------------------------------------------+
| 2022-01-02 13:12:12                            |

      Exemplo 12

      select timestampadd(day,1,'2022-01-02 12:12:12');

      As seguintes informações são retornadas:

      +-----------------------------------------------+
| timestampadd('day', 1, '2022-01-02 12:12:12') |
+-----------------------------------------------+
| 2022-01-03 12:12:12                           |

      Exemplo 13

      select timestampadd(week,1,'2022-01-02 12:12:12');

      As seguintes informações são retornadas:

      +------------------------------------------------+
| timestampadd('week', 1, '2022-01-02 12:12:12') |
+------------------------------------------------+
| 2022-01-09 12:12:12                            |

      Exemplo 14

      select timestampadd(month,1,'2022-01-02 12:12:12');

      As seguintes informações são retornadas:

      +-------------------------------------------------+
| timestampadd('month', 1, '2022-01-02 12:12:12') |
+-------------------------------------------------+
| 2022-02-02 12:12:12                             |

      Exemplo 15

      select timestampadd(year,1,'2022-01-02 12:12:12');

      As seguintes informações são retornadas:

      +------------------------------------------------+
| timestampadd('year', 1, '2022-01-02 12:12:12') |
+------------------------------------------------+
| 2023-01-02 12:12:12                            |

      Exemplo 16

      select timestampadd(quarter,1,'2022-01-02 12:12:12');

      As seguintes informações são retornadas:

      +---------------------------------------------------+
| timestampadd('quarter', 1, '2022-01-02 12:12:12') |
+---------------------------------------------------+
| 2022-04-02 12:12:12                               |

    TIMESTAMPDIFF

    TIMESTAMPDIFF(unit,datetime_expr1,datetime_expr2)

    • Descrição: Calcula a diferença entre duas expressões de data ou datetime, subtraindo datetime_expr1 de datetime_expr2. O parâmetro unit determina a unidade do resultado.

      Valores válidos para unit: second, minute, hour, day, week, month, quarter e year.

      Esta função pode ser utilizada da mesma forma que TIMESTAMPADD.

    • Tipos de parâmetros:

      timestampdiff(varchar, timestamp, timestamp)
timestampdiff(varchar, date, date)
timestampdiff(varchar, datetime, datetime)
timestampdiff(varchar, varchar, varchar)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select timestampdiff(second,datetime '2022-02-01 10:12:13',datetime '2022-03-01 10:12:13')as result;

      As seguintes informações são retornadas:

      +----------+
|  result  |
+----------+
|  2419200 |

      Exemplo 2

      select timestampdiff(minute,datetime '2022-02-01 10:12:13',datetime '2022-03-01 10:12:13')as result;

      As seguintes informações são retornadas:

      +---------+
|  result |
+---------+
|  40320  |

      Exemplo 3

      select timestampdiff(hour,datetime '2022-02-01 10:12:13',datetime '2022-03-01 10:12:13')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|   672  |

      Exemplo 4

      select timestampdiff(day,timestamp '2022-02-01',timestamp '2022-03-01')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|    28  |

      Exemplo 5

      select timestampdiff(day,date '2022-02-01',date '2022-03-01');

      As seguintes informações são retornadas:

      +------------------------------------------------------------+
| timestampdiff('day', DATE '2022-02-01', DATE '2022-03-01') |
+------------------------------------------------------------+
|                                                         28 |

      Exemplo 6

      select timestampdiff(day,datetime '2022-02-01 10:12:13',datetime '2022-03-01 10:12:13')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|    28  |

      Exemplo 7

      select timestampdiff(day,'2022-02-01','2022-03-01');

      As seguintes informações são retornadas:

      +--------------------------------------------------+
| timestampdiff('day', '2022-02-01', '2022-03-01') |
+--------------------------------------------------+
|                                              28  |

      Exemplo 8

      select timestampdiff(week,'2022-02-01','2022-03-01');

      As seguintes informações são retornadas:

      +---------------------------------------------------+
| timestampdiff('week', '2022-02-01', '2022-03-01') |
+---------------------------------------------------+
|                                                4  |

      Exemplo 9

      select timestampdiff(quarter,'2022-02-01','2022-03-01');

      As seguintes informações são retornadas:

      +------------------------------------------------------+
| timestampdiff('quarter', '2022-02-01', '2022-03-01') |
+------------------------------------------------------+
|                                                   0  |

      Exemplo 10

      select timestampdiff(month,'2022-02-01','2022-03-01');

      As seguintes informações são retornadas:

      +----------------------------------------------------+
| timestampdiff('month', '2022-02-01', '2022-03-01') |
+----------------------------------------------------+
|                                                 1  |

      Exemplo 11

      select timestampdiff(year,datetime '2022-02-01 10:12:13',datetime '2020-05-01 10:12:13')as result;

      As seguintes informações são retornadas:

      +--------+
| result |
+--------+
|     -1 |

    TO_DAYS

    TO_DAYS(date)

    • Descrição: Esta função retorna o número de dias desde o ano 0 com base na data especificada por date.

    • Tipos de parâmetro:

      to_days(date)
to_days(time)
to_days(varchar)
to_days(timestamp)
to_days(datetime)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select to_days(date '2022-02-12');

      As seguintes informações são retornadas:

      +----------------------------+
| to_days(DATE '2022-02-12') |
+----------------------------+
|                     738563 |

      Exemplo 2

      select to_days(time '12:12:12');

      O resultado abaixo mostra o número de dias desde o ano 0 com base na data atual:

      +--------------------------+
| to_days(TIME '12:12:12') |
+--------------------------+
|                   738563 |

      Exemplo 3

      select to_days(now());

      As seguintes informações são retornadas:

      +----------------+
| to_days(now()) |
+----------------+
|         738563 |

      Exemplo 4

      Nota

      Este exemplo é equivalente ao Exemplo 3.

      select to_days(curdate());

      As seguintes informações são retornadas:

      +--------------------+
| to_days(curdate()) |
+--------------------+
|             738563 |

      Exemplo 5

      select to_days(datetime '2022-02-12 12:12:12');

      As seguintes informações são retornadas:

      +-----------------------------------------+
| to_days(DATETIME '2022-02-12 12:12:12') |
+-----------------------------------------+
|                                  738563 |

      Exemplo 6

      select to_days('2022-02-12 12:12:12');

      As seguintes informações são retornadas:

      +--------------------------------+
| to_days('2022-02-12 12:12:12') |
+--------------------------------+
|                         738563 |

      Exemplo 7

      select to_days(timestamp '2022-02-12 12:12:12');

      As seguintes informações são retornadas:

      +------------------------------------------+
| to_days(TIMESTAMP '2022-02-12 12:12:12') |
+------------------------------------------+
|                                   738563 |

    TO_SECONDS

    TO_SECONDS(expr)

    • Descrição: Esta função retorna o número de segundos decorridos desde o ano 0 com base no horário especificado por expr.

    • Tipos de parâmetro:

      to_seconds(date)
to_seconds(datetime)
to_seconds(timestamp)
to_seconds(varchar)
to_seconds(time)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select to_seconds(date '2022-02-02');

      As seguintes informações são retornadas:

      +-------------------------------+
| to_seconds(DATE '2022-02-02') |
+-------------------------------+
|                   63810979200 |

      Exemplo 2

      select to_seconds(datetime '2022-02-02 09:09:00');

      As seguintes informações são retornadas:

      +--------------------------------------------+
| to_seconds(DATETIME '2022-02-02 09:09:00') |
+--------------------------------------------+
|                                63811012140 |

      Exemplo 3

      select to_seconds(timestamp '2022-02-02 09:09:00');

      As seguintes informações são retornadas:

      +---------------------------------------------+
| to_seconds(TIMESTAMP '2022-02-02 09:09:00') |
+---------------------------------------------+
|                                 63811012140 |

      Exemplo 4

      Ao executar a instrução SQL a seguir, o sistema adiciona o valor de curdate() a '09:09:00'.

      select to_seconds(time '09:09:00');

      As seguintes informações são retornadas:

      +-----------------------------+
| to_seconds(TIME '09:09:00') |
+-----------------------------+
|                 63811012140 |

      Exemplo 5

      select to_seconds('2022-02-02');

      As seguintes informações são retornadas:

      +--------------------------+
| to_seconds('2022-02-02') |
+--------------------------+
|              63810979200 |

    UNIX_TIMESTAMP

    UNIX_TIMESTAMP([date])

    • Descrição: UNIX_TIMESTAMP() retorna o número de segundos decorridos desde 00:00:00 January 1, 1970 in UTC até o momento atual. Já UNIX_TIMESTAMP(date) retorna o número de segundos decorridos desde 00:00:00 January 1, 1970 in UTC até o horário especificado por date.

    • Tipos de parâmetro:

      unix_timestamp()
unix_timestamp(varchar)
unix_timestamp(timestamp)
unix_timestamp(date)
unix_timestamp(datetime)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select unix_timestamp();

      As seguintes informações são retornadas:

      +------------------+
| unix_timestamp() |
+------------------+
|       1654759686 |

      Exemplo 2

      select unix_timestamp(timestamp '2022-02-08 12:12:12');

      As seguintes informações são retornadas:

      +-------------------------------------------------+
| unix_timestamp(TIMESTAMP '2022-02-08 12:12:12') |
+-------------------------------------------------+
|                                      1644293532 |

      Exemplo 3

      select unix_timestamp(date '2022-02-08');

      As seguintes informações são retornadas:

      +-----------------------------------+
| unix_timestamp(DATE '2022-02-08') |
+-----------------------------------+
|                        1644249600 |

      Exemplo 4

      select unix_timestamp(datetime '2022-02-08 12:12:12');

      As seguintes informações são retornadas:

      +------------------------------------------------+
| unix_timestamp(DATETIME '2022-02-08 12:12:12') |
+------------------------------------------------+
|                                     1644293532 |

      Exemplo 5

      select unix_timestamp('2022-02-08 12:12:12');

      As seguintes informações são retornadas:

      +---------------------------------------+
| unix_timestamp('2022-02-08 12:12:12') |
+---------------------------------------+
|                            1644293532 |

    UTC_DATE

    UTC_DATE()

    • Descrição: Retorna a data UTC.

    • Tipo de dados do valor retornado: VARCHAR.

    • Exemplo:

      select utc_date();

      As seguintes informações são retornadas:

      +------------+
| utc_date() |
+------------+
| 2022-05-27 |

    UTC_TIME

    UTC_TIME()

    • Descrição: Retorna o horário UTC.

    • Tipo de dados do valor retornado: VARCHAR.

    • Exemplo:

      select utc_time();

      As seguintes informações são retornadas:

      +------------+
| utc_time() |
+------------+
| 05:53:19   |

    UTC_TIMESTAMP

    utc_timestamp()

    • Descrição: Retorna o timestamp UTC.

    • Tipo de dados do valor retornado: VARCHAR.

    • Exemplo:

      select utc_timestamp();

      As seguintes informações são retornadas:

      +---------------------+
| utc_timestamp()     |
+---------------------+
| 2022-05-27 15:55:15 |

    WEEK

    WEEK(date[,mode])

    • Descrição: Retorna o número da semana para a data especificada por date, indicando em qual semana do ano date se enquadra.

      • date define a data para a qual você deseja obter o número da semana.

      • mode é um parâmetro opcional que determina o modo de cálculo do número da semana. Por padrão, o primeiro dia da semana é domingo. Também é possível definir se a semana começa na segunda-feira ou no domingo. A tabela a seguir descreve os formatos suportados por mode.

      mode

      Primeiro dia da semana

      Valores válidos para o número da semana

      Descrição

      0

      Domingo

      0 a 53

      A primeira semana do ano começa no primeiro domingo. A semana que inclui os dias anteriores ao primeiro domingo é considerada a Semana 0.

      1

      Segunda-feira

      0 a 53

      Se o período de 1º de janeiro até a primeira segunda-feira tiver mais de três dias, a semana que inclui os dias anteriores à primeira segunda-feira é considerada a primeira semana do ano. Caso contrário, essa semana é considerada a Semana 0.

      2

      Domingo

      1 a 53

      A primeira semana do ano começa no primeiro domingo. A semana que inclui os dias anteriores ao primeiro domingo é considerada a última semana do ano anterior.

      3

      Segunda-feira

      1 a 53

      Se o período de 1º de janeiro até a primeira segunda-feira tiver mais de três dias, a semana que inclui os dias anteriores à primeira segunda-feira é considerada a primeira semana do ano. Caso contrário, essa semana é considerada a última semana do ano anterior.

      4

      Domingo

      0 a 53

      Se o período de 1º de janeiro até o primeiro domingo tiver mais de três dias, a semana que inclui os dias anteriores ao primeiro domingo é considerada a primeira semana do ano. Caso contrário, essa semana é considerada a Semana 0.

      5

      Segunda-feira

      0 a 53

      A primeira semana do ano começa na primeira segunda-feira. A semana que inclui os dias anteriores à primeira segunda-feira é considerada a Semana 0.

      6

      Domingo

      1 a 53

      Se o período de 1º de janeiro até o primeiro domingo tiver mais de três dias, a semana que inclui os dias anteriores ao primeiro domingo é considerada a primeira semana do ano. Caso contrário, essa semana é considerada a última semana do ano anterior.

      7

      Segunda-feira

      1 a 53

      A primeira semana do ano começa na primeira segunda-feira. A semana que inclui os dias anteriores à primeira segunda-feira é considerada a última semana do ano anterior.

    • Tipos de parâmetro:

      week(varchar)
week(varchar, bigint)
week(date)
week(date, bigint)
week(datetime)
week(datetime, bigint)
week(timestamp)
week(timestamp, bigint)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select week('2022-02-27');

      As seguintes informações são retornadas:

      +--------------------+
| week('2022-02-27') |
+--------------------+
|                 9  |

      Exemplo 2

      select week('2022-02-20',1);

      As seguintes informações são retornadas:

      +-----------------------+
| week('2022-02-20', 1) |
+-----------------------+
|                     7 |

      Exemplo 3

      select week(date '2022-02-20');

      As seguintes informações são retornadas:

      +-------------------------+
| week(DATE '2022-02-20') |
+-------------------------+
|                       8 |

      Exemplo 4

      select week(date '2022-02-20',1);

      As seguintes informações são retornadas:

      +----------------------------+
| week(DATE '2022-02-20', 1) |
+----------------------------+
|                          7 |

      Exemplo 5

      select week(datetime '2022-02-20 00:00:00',1);

      As seguintes informações são retornadas:

      +-----------------------------------------+
| week(DATETIME '2022-02-20 00:00:00', 1) |
+-----------------------------------------+
|                                       7 |

      Exemplo 6

      select week(datetime '2022-02-20 00:00:00');

      As seguintes informações são retornadas:

      +--------------------------------------+
| week(DATETIME '2022-02-20 00:00:00') |
+--------------------------------------+
|                                    8 |

      Exemplo 7

      select week(timestamp '2022-02-20 00:00:00');

      As seguintes informações são retornadas:

      +---------------------------------------+
| week(TIMESTAMP '2022-02-20 00:00:00') |
+---------------------------------------+
|                                     8 |

      Exemplo 8

      select week(timestamp '2022-02-20 00:00:00',1);

      As seguintes informações são retornadas:

      +------------------------------------------+
| week(TIMESTAMP '2022-02-20 00:00:00', 1) |
+------------------------------------------+
|                                        7 |

    WEEKDAY

    WEEKDAY(date)

    • Descrição: Retorna o dia da semana para a data especificada por date. O resultado é um número inteiro correspondente ao dia da semana, conforme o mapeamento: 0 = segunda-feira, 1 = terça-feira, 2 = quarta-feira, 3 = quinta-feira, 4 = sexta-feira, 5 = sábado e 6 = domingo.

    • Tipos de parâmetro:

      weekday(timestamp)
weekday(datetime)
weekday(date)
weekday(varchar)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select weekday(timestamp '2022-02-20 00:09:00');

      As seguintes informações são retornadas:

      +------------------------------------------+
| weekday(TIMESTAMP '2022-02-20 00:09:00') |
+------------------------------------------+
|                                        6 |

      Exemplo 2

      select weekday(datetime '2022-02-20 00:09:00');

      As seguintes informações são retornadas:

      +-----------------------------------------+
| weekday(DATETIME '2022-02-20 00:09:00') |
+-----------------------------------------+
|                                       6 |

      Exemplo 3

      select weekday(date '2022-02-20 00:09:00');

      As seguintes informações são retornadas:

      +-------------------------------------+
| weekday(DATE '2022-02-20 00:09:00') |
+-------------------------------------+
|                                   6 |

      Exemplo 4

      select weekday('2022-02-20');

      As seguintes informações são retornadas:

      +-----------------------+
| weekday('2022-02-20') |
+-----------------------+
|                     6 |

    WEEKOFYEAR

    WEEKOFYEAR(date)

    • Descrição: Retorna a semana do calendário para a data especificada por date. Valores válidos: 1 to 53.

    • Tipos de parâmetro:

      weekofyear(timestamp)
weekofyear(datetime)
weekofyear(date)
weekofyear(varchar)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select weekofyear(timestamp '2022-02-27 09:00:00');

      As seguintes informações são retornadas:

      +---------------------------------------------+
| weekofyear(TIMESTAMP '2022-02-27 09:00:00') |
+---------------------------------------------+
|                                          8  |

      Exemplo 2

      select weekofyear(datetime '2022-02-27 09:00:00');

      As seguintes informações são retornadas:

      +--------------------------------------------+
| weekofyear(DATETIME '2022-02-27 09:00:00') |
+--------------------------------------------+
|                                         8  |

      Exemplo 3

      select weekofyear(date '2022-02-27');

      As seguintes informações são retornadas:

      +-------------------------------+
| weekofyear(DATE '2022-02-27') |
+-------------------------------+
|                            8  |

      Exemplo 4

      select weekofyear('2022-02-27');

      As seguintes informações são retornadas:

      +--------------------------+
| weekofyear('2022-02-27') |
+--------------------------+
|                       8  |

    YEAR

    YEAR(date)

    • Descrição: Extrai a parte referente ao ano da data especificada por date.

    • Tipos de parâmetro:

      year(timestamp)
year(datetime)
year(date)
year(time)
year(varchar)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select year(timestamp '2022-02-27 00:00:00');

      As seguintes informações são retornadas:

      select year(timestamp '2019-05-27 00:00:00');
+---------------------------------------+
| year(TIMESTAMP '2022-02-27 00:00:00') |
+---------------------------------------+
|                                  2022 |

      Exemplo 2

      select year(datetime '2022-02-27 00:00:00')

      As seguintes informações são retornadas:

      +--------------------------------------+
| year(DATETIME '2022-02-27 00:00:00') |
+--------------------------------------+
|                                 2022 |

      Exemplo 3

      select year(date '2022-02-27');

      As seguintes informações são retornadas:

      +-------------------------+
| year(DATE '2022-02-27') |
+-------------------------+
|                    2022 |

      Exemplo 4

      Ao executar a instrução SQL a seguir, o sistema adiciona o valor de curdate() a '00:00:00' e retorna o resultado como uma string.

      select year(time '00:00:00');

      As seguintes informações são retornadas:

      +-----------------------+
| year(TIME '00:00:00') |
+-----------------------+
|                  2022 |

      Exemplo 5

      select year('2022-02-27');

      As seguintes informações são retornadas:

      +--------------------+
| year('2022-02-27') |
+--------------------+
|               2022 |

    YEARWEEK

    YEARWEEK(date)
YEARWEEK(date,mode)

    • Descrição: Retorna o ano e a semana de uma data.

      O ano no resultado pode diferir do ano no parâmetro de data para a primeira e a última semanas do ano.

      O parâmetro mode nesta função opera da mesma forma que o parâmetro mode na função WEEK. Na sintaxe com apenas um parâmetro, o valor de mode é 0.

    • Tipos de parâmetro:

      yearweek(timestamp)
yearweek(timestamp, bigint)
yearweek(datetime)
yearweek(datetime, bigint)
yearweek(date, bigint) 
yearweek(date) 
yearweek(varchar)
yearweek(varchar, bigint)

    • Tipo de dados do valor retornado: BIGINT.

    • Exemplos:

      Exemplo 1

      select yearweek(timestamp '2022-02-27 00:00:00');

      As seguintes informações são retornadas:

      +-------------------------------------------+
| yearweek(TIMESTAMP '2022-02-27 00:00:00') |
+-------------------------------------------+
|                                    202209 |

      Exemplo 2

      select yearweek(timestamp '2022-02-27 00:00:00',1);

      As seguintes informações são retornadas:

      +----------------------------------------------+
| yearweek(TIMESTAMP '2022-02-27 00:00:00', 1) |
+----------------------------------------------+
|                                       202208 |

      Exemplo 3

      select yearweek(datetime '2022-02-27 00:00:00');

      As seguintes informações são retornadas:

      +------------------------------------------+
| yearweek(DATETIME '2022-02-27 00:00:00') |
+------------------------------------------+
|                                   202209 |

      Exemplo 4

      select yearweek(datetime '2022-02-27 00:00:00',1);

      As seguintes informações são retornadas:

      +---------------------------------------------+
| yearweek(DATETIME '2022-02-27 00:00:00', 1) |
+---------------------------------------------+
|                                      202208 |

      Exemplo 5

      select yearweek(date '2022-02-27',1);

      As seguintes informações são retornadas:

      +--------------------------------+
| yearweek(DATE '2022-02-27', 1) |
+--------------------------------+
|                         202208|

      Exemplo 6

      select yearweek(date '2022-02-27');

      As seguintes informações são retornadas:

      +-----------------------------+
| yearweek(DATE '2022-02-27') |
+-----------------------------+
|                      202209 |

      Exemplo 7

      select yearweek('2022-02-27');

      As seguintes informações são retornadas:

      +------------------------+
| yearweek('2022-02-27') |
+------------------------+
|                 202209 |

      Exemplo 8

      select yearweek('2022-02-27',1);

      As seguintes informações são retornadas:

      +---------------------------+
| yearweek('2022-02-27', 1) |
+---------------------------+
|                    202208 |