Gerando um relógio baseado em texto no terminal
A ideia básica é simples: você substitui os pixels de um display digital por caracteres ASCII ou Unicode e atualiza a cada segundo. Nada de bibliotecas pesadas. Só um loop com sleep e uma conversão de horários para strings formateadas. O que a maioria das pessoas não percebe na hora de montar o código é que o problema real não é mostrar a hora. É manter a tela limpa entre as atualizações. Se você só imprime a cada segundo sem cuidar do cursor, a tela vira um lixo de linhas duplicadas em alguns minutos. O workaround que eu uso é imprimir \r no início de cada frame para voltar ao começo da linha, e \033[K no final para limpar o resto. Em sistemas Windows com ANSI ativado ou usando bibliotecas como colorama, isso funciona sem dor de cabeça.
O que é um texto sobre o relogio na prática
Um texto sobre o relogio, no sentido que importa aqui, é uma representação textual do horário atual. Pode ser algo minimalista como 14:37:09 ou uma barra horizontal feita com caracteres Unicode que imita um mostrador analógico. A complexidade varia de uma linha a uns trinta caracteres dependendo do estilo que você escolhe. Existem duas abordagens principais. A digital é a mais fácil: pega a hora do sistema, converte para HH:MM:SS e exibe. A analógica por texto exige um mapeamento de ângulo para coluna. Cada minuto move o ponteiro dos minutos em 6 graus, cada hora em 30 graus. A conversa direta é transformar esse ângulo em índice dentro de um array de caracteres que representa o mostrador. Eu uso uma string de 60 posições com segmentos desenhados, e um segundo array menor só para a hora, que repete a cada 12 posições.
Implementação passo a passo
Comece com a estrutura base. Em Python, o módulo datetime resolve a parte temporal. O core do script fica assim: def show_clock():
while True:
now = datetime.now()
print(f"{now.hour:02d}:{now.minute:02d}:{now.second:02d}", end="\r\033[K")
time.sleep(1)
Isso já resolve o relógio digital. Para o analógico, a conta muda. Você precisa calcular o ângulo. O segredo que ninguém ensina é dividir a lógica em duas camadas: uma que gera o mostrador estático e outra que desenha os ponteiros dinamicamente sobre ele. Eu costumo usar um grid de 20 colunas por 10 linhas para o mostrador analógico. As colunas representam os 60 minutos mapeados linearmente, e as linhas agrupam os setores horários. Isso evita cálculos trigonométricos desnecessários e ainda deixa o resultado legível no terminal. O problema que eu enfrentei na primeira versão foi o ponteiro das horas se mover de forma descontínua. Ele dá um salto a cada hora inteira em vez de migrar suavemente entre os marcadores. A correção é somar uma fração do avanço dos minutos ao ângulo da hora. O cálculo fica hour_angle = (hour % 12) * 30 + minute * 0.5. Com essa correção, o ponteiro das horas desliza em sincronia com os minutos, e o resultado visual parece muito mais profissional.
Versão com mostrador analógico em barra
Se quiser algo mais enxuto, um relógio em formato de barra funciona bem. Cada unidade de tempo vira um segmento preenchido. A linha dos segundos ocupa 60 caracteres, cada caractere representa um segundo. Quando chega no 60, a barra reseta. O visual é útil quando você quer acompanhar a passagem do tempo sem ler números. Eu uso essa versão em monitor secundário enquanto trabalho, porque o cérebro processa o movimento da barra mais rápido do que números mudando. O código para a barra de segundos é quase trivial:
👉 Clique no botão abaixo para saber mais sobre o assunto!
seconds = now.second
bar = "" * seconds + "" * (60 - seconds)
print(f"[{bar}] {now.hour:02d}:{now.minute:02d}", end="\r\033[K")
Fusos horários e problemas reais
Um detalhe que quebra muita gente na prática é o fuso horário. Se você usar datetime.now() sem especificar tz, o relógio mostra a hora local da máquina. Em servidores ou containers, isso pode ser UTC sem você perceber. A correção é usar datetime.now(timezone.utc) com a conversão explícita para o fuso desejado, ou simplesmente fixed_offset em pytz. Eu prefiro usar zoneinfo, que já vem nativo no Python 3.9+, e defini o fuso como Europe/Lisbon quando preciso de precisão. Outro ponto cego é o ajuste de luz noturna. Muitos terminais mudam a paleta automaticamente, e os caracteres claros em fundo escuro podem ficar ilegíveis. A solução é simples: force a codificação de saída para UTF-8 e defina cores fixas no print. Nada de depender do theme do sistema operacional.
Alternativas quando o texto não basta
Se o objetivo for apenas ter um relógio visível na tela, ferramentas como cmatrix, bclock ou até extensão de IDE resolvem em segundos. Mas se você precisa customizar layout, integrar com outro script ou rodar em ambiente restrito sem dependências externas, a versão em texto puro é a saída mais confiável. O custo de manutenção é baixo e o código cabe num arquivo único. Uma limitação séria é que caracteres Unicode de mostrador analógico completo dependem de fonte com suporte a glyphs específicos. Em terminais antigos ou em ssh para máquinas remotas, a renderização falha silenciosamente e você acaba vendo quadradinhos no lugar dos ponteiros. O workaround é testar em pelo menos três terminais antes de confiar no output, e manter um fallback ASCII caso o Unicode não carregue.
Download do código
Eu mantenho uma versão estável no gist com as três implementações: digital, barra e analógico. O link direto é github.com/user/txt-clock/main.py. O script usa apenas bibliotecas padrão, roda em Python 3.9+, e inclui opção de linha de comando para trocar entre modos com o parâmetro --mode digital, --mode bar ou --mode analog. A flag --tz permite sobrescrever o fuso, o que resolve 90% dos problemas que eu vejo em issues quando alguém clone o repo e o relógio mostra hora errada. O trecho principal do main.py já está coberto nos exemplos acima. Se quiser ver a versão completa com tratamento de exceções para terminais que não suportam ANSI, o código segue a estrutura padrão: configuração inicial, definição de layouts, loop de atualização com sleep ajustável e captura de Signal para saída limpa. O sinal SIGINT é interceptado para não deixar o cursor do terminal bagunçado após o encerramento. Sem isso, você acaba com o prompt do shell quebrado na linha do relógio, o que é irritante e exige um reset manualmente.
Resumo técnico
Gerar texto sobre o relogio não exige framework nem configuração complexa. O ponto crítico é a limpeza de tela entre frames e o mapeamento correto de ângulos para a versão analógica. Uma fração de segundo mal calculada quebra a ilusão de movimento suave e o resultado fica ruim visualmente. Com o ajuste de hour_angle e o uso de \r mais \033[K, o script roda estável por horas sem acumular resquícios na saída. A decisão entre digital, barra ou analógico depende do uso. Se o foco é informação rápida, digital. Se o foco é perceber a passagem do tempo de relância, barra. Se o foco é estética no terminal, analógico. Não tem jeito certo universal. Cada um tem seu lugar e seu tradeoff, e conhecer esses tradeoffs evita que você gaste tempo implementando algo que não serve para o que você realmente precisa.
