itDateTime

Aceita uma combinação de data e hora. As partes da data e da hora são separadas por um único espaço ou por T (ISO 8601 apenas em maiúsculas; o t minúsculo não é aceite).

Prioridade do separador

O T é testado em primeiro lugar. Se um T aparecer antes do primeiro espaço (ou se não houver espaço), o T é utilizado como separador. Isto trata corretamente entradas como 2026-03-25T2:30 PM, em que a própria parte da hora contém um espaço.

Parte da data

Segue as mesmas regras que itDate: são aceites os formatos compacto, ISO e de recurso local.

Parte da hora

Segue as mesmas regras que itTime: hh:mm, hh:mm:ss, segundos fracionários (1–6 dígitos) e AM/PM são todos aceites. A saída SQL é sempre no formato de 24 horas.

Exemplos

2026-03-25 09:30:00
2026-03-25T09:30:00
25/03/2026 09:30
2026-03-25T2:30 PM
25032026 0930

Values[]

A data da localidade string seguida de um espaço e da hora no formato de 24 horas hh:mm:ss[.fff].

2026-03-25 09:30:00.500   →   Valores[0]: 25-03-2026 09:30:00.500  (pt-PT)

SQLValues[]

O literal de data e hora SQL depende do dialeto. Consulte Dialetos SQL para ver a tabela completa de formatos.

2026-03-25 09:30:00 →
  sqlElevateDB, sqlPostgreSQL:  TIMESTAMP '2026-03-25 09:30:00'
  sqlFirebird: TIMESTAMP '2026-03-25 09:30:00'
  sqlMySQL, sqlDBISAM,
  sqlMSSQLServer, sqlSQLite:    '2026-03-25 09:30:00'
  sqlOracle: TO_TIMESTAMP('2026-03-25 09:30:00','AAAA-MM-DD HH24:MI:SS')
  sqlAccess: #2026-03-25 09:30:00#  (ms omitido)
  sqlBDEParadox: "25.03.2026 09:30:00"  (ms omitido)

Quando os milissegundos são diferentes de zero, o Firebird utiliza quatro dígitos fracionários que representam dez milésimos de segundo (ms × 10), por exemplo, 500 ms → .5000. Todos os outros dialetos que suportam precisão inferior a um segundo utilizam três dígitos (milissegundos). O sqlAccess e o sqlBDEParadox omitem completamente os milissegundos.

Intervalo

Entrada: 2026-01-01 00:00~2026-12-31 23:59:59
  →   otRange
  →   BETWEEN TIMESTAMP '2026-01-01 00:00:00' AND TIMESTAMP '2026-12-31 23:59:59'  (sqlElevateDB)

A data e hora à esquerda não pode ser posterior à data e hora à direita; caso contrário, é devolvido ERR_INVALID_RANGE.