Datas

funcional

Leia datas do seu jeito: escolha um padrão e fuso horário, ou transforme números de época em datas reais.

Fica muito mais fácil confiar nas datas quando o formato e o fuso horário estão claros. Defina ambos em Configurações › Resultados › Data.

OpçãoEscolhasPadrão
Padrão de formataçãoPadrão de texto livre (yyyy, MM, dd, HH, mm, ss)yyyy-MM-dd HH:mm:ss
Fuso horárioSempre UTC / Nativo (como armazenado) / Sempre local / Fuso horário específicoSempre UTC
ID do fuso horárioSeletor de zonas IANA pesquisável, exibido quando «Fuso horário específico» está selecionado - a zona é validada enquanto você digita e uma pré-visualização ao vivo mostra o deslocamento UTC atualUTC
AlinhamentoEsquerda / Centro / DireitaEsquerda
Mostrar timestamps inteiros como datasDesativado / Pelo nome da coluna / Pelo nome e intervalo de valoresDesativado

As datas usam o padrão que você escolher; não há modo relativo “há 2 horas”. Para converter um número de epoch em uma data, use uma epoch= substituição de formato.

SQLly
Painel de configuração de formatação de data do SQLlyPainel de configuração de formatação de data do SQLly
O painel de formatação de data/hora nas Configurações.

Escrevendo um padrão

O padrão reconhece seis tokens: yyyy (ano com quatro dígitos), MM (mês), dd (dia), HH (hora de 24 horas), mm (minuto), e ss (segundo). Todo o resto - traços, barras, pontos, espaços, um literal T - é copiado exatamente como digitado. Para um valor de 2026-03-14 09:05:07:

PadrãoA grade mostra
yyyy-MM-dd HH:mm:ss2026-03-14 09:05:07
dd/MM/yyyy HH:mm14/03/2026 09:05
MM.dd.yyyy03.14.2026
yyyy-MM-ddTHH:mm:ss2026-03-14T09:05:07

Nomes de meses, anos com dois dígitos e um relógio de 12 horas não são tokens. Segundos fracionários nunca são descartados: quando um valor os possui e seu padrão inclui ss, eles são adicionados, então 12:00:00.500 permanece 12:00:00.500.

Fusos horários

Tome um timestamptz valor de 2026-01-01T12:00:00+00:00 com o formato padrão:

Configuração de fuso horárioA grade mostra
Sempre UTC2026-01-01 12:00:00
Fuso horário específico: Europe/Berlin2026-01-01 13:00:00
Fuso horário específico: Asia/Tokyo2026-01-01 21:00:00
Sempre localO mesmo instante no fuso horário do seu computador
Nativo (como armazenado)O texto exatamente como o banco de dados enviou
  • Valores com deslocamento (timestamptz, datetimeoffset) convertem exatamente, o instante é o mesmo, apenas a leitura do relógio muda.
  • Valores sem deslocamento (datetime, datetime2, timestamp) são tratados como UTC antes da conversão. Se o seu banco de dados armazena horários de relógio local nessas colunas, escolha Sempre UTC ou Nativo (como armazenado) para que eles não sejam deslocados.
  • Nativo (como armazenado) pula o padrão também: você vê o texto próprio do motor, sem alterações.
  • Um ID de zona desconhecido é sinalizado em Configurações e a grade volta para o UTC. Na pré-visualização no navegador, Sempre local também mostra UTC.

Zonas por coluna e por conexão

A configuração acima é a padrão. Dois outros lugares podem escolher uma zona, e o mais específico vence:

  1. A zone= opção na diretiva de formato.
  2. Uma substituição de coluna. Substituições de data e Epoch em Configurações › Resultados › Substituições de coluna têm uma opção de Fuso Horário: Seguir a configuração global (o padrão para novas substituições), Sempre UTC, Sempre local, Nativo (como armazenado, apenas Data) ou um fuso horário específico escolhido na mesma lista pesquisável.
  3. A conexão. No editor de conexão, Fuso horário de exibição pode ser Usar configuração do app (o padrão), UTC, Horário local ou qualquer zona com nome. As grades dessa conexão a usam em qualquer lugar onde a configuração desta página se aplicaria, útil quando um servidor guarda horários do relógio local e outro guarda UTC.
  4. A configuração de Fuso horário desta página.

O que fica intocado

  • Colunas apenas de data e apenas de hora (date, time) são mostrados como o banco de dados os enviou, nunca deslocados nem remodelados pelo padrão das Configurações, mover uma data simples entre fusos mudaria o dia. Um date= sobrescrita (abaixo) ainda pode reformatar uma coluna apenas de data.
  • Colunas de texto que por acaso contêm datas permanecem como texto. A formatação segue o tipo de coluna declarado; CAST a coluna para um tipo de data/hora na sua consulta, ou dê à coluna uma date= sobrescrita, se você quiser que ela seja tratada como tal.
  • NULL mostra-se em itálico NULL.

Uma coluna de cada vez

Clique com o botão direito no cabeçalho de uma coluna de data ou hora e escolha Formatar › Definir substituição de formatação… para dar só a essa coluna um padrão próprio. A escolha é salva na consulta como uma date= diretiva, que usa strftime tokens como %Y, %m, %d, %H, %M, %S, %b (nome curto do mês), e %:z (deslocamento UTC). Para um datetimeoffset valor de 2026-07-14T09:30:15+02:00 com a configuração padrão Sempre UTC:

EscolhaDiretivaA grade mostra
Data (2026-07-14)date=%Y-%m-%d2026-07-14
Data e horadate=%Y-%m-%d %H:%M:%S2026-07-14 07:30:15
Data, hora e deslocamentodate=%Y-%m-%d %H:%M:%S %:z2026-07-14 07:30:15 +00:00
Digitado manualmentedate=%d/%m/%Y %H:%M14/07/2026 07:30
  • A configuração do fuso horário ainda se aplica. A diretiva escolhe o padrão; o instante é mostrado no fuso horário de exibição da coluna, como acima. Sob Nativo (como armazenado) um valor com deslocamento mantém o próprio, então a opção de deslocamento mostra 2026-07-14 09:30:15 +02:00.
  • Valores somente de data são reformatados também (date=%d.%m.%Y transforma 2026-07-14 em 14.07.2026) mas nunca deslocados entre fusos.
  • Erros são inofensivos. Um valor que não é lido como data, ou um padrão com um token que o SQLly não reconhece, deixa a célula como o banco de dados a enviou.
  • Apenas exibição. Copiar e exportar levam o valor original do banco de dados, não o texto reformatado.
-- sqlly format: column=OrderDate; date=%d %b %Y
SELECT OrderID, OrderDate FROM dbo.Orders;

Números de época

Timestamps Unix armazenados como inteiros podem ser mostrados como datas por coluna. Clique com o botão direito no cabeçalho, escolha Formatar › Definir substituição de formatação…, e escolha Segundos de época → data/hora ou Milissegundos de época → data/hora, ou escreva você mesmo:

-- sqlly format: column=created_at; epoch=auto
SELECT id, created_at FROM events;

Com essa linha, 1767268800 aparece como 2026-01-01 12:00:00 (UTC). auto trata valores de 100.000.000.000 ou mais como milissegundos e os menores, como segundos. Um valor que ficaria fora dos anos 1-9999 - normalmente sinal de unidade errada - é mantido como o número simples. Para um padrão de saída diferente, adicione uma substituição de Epoch para a coluna em Configurações › Resultados › Substituições de coluna, onde você pode escolher a unidade e selecionar um padrão de data/hora e fuso horário.

As colunas de época são exibidas no mesmo fuso horário de exibição das datas (acima), nem sempre em UTC. Para pular a configuração por coluna, defina Mostrar timestamps inteiros como datas: Por nome da coluna mostra colunas de inteiros nomeadas como created_at, updated_ts, login_time, signup_epoch, ou timestamp como datas (durações como response_time ou elapsed_time são mantidas intactas); Por nome e faixa de valores também deixa qualquer valor fora de 2000-2100 (como segundos ou milissegundos) como número puro. Uma sobrescrita na coluna ou uma diretiva de formato sempre prevalece, e copiar, editar e exportar mantêm o número bruto.