Dia Da Semana De Iansã

O que é o dia da semana de iansã

Iansã é uma biblioteca open source brasileira focada em localização de datas e calendários para o português do Brasil. O módulo mais usado lida justamente com a tradução e formatação do dia da semana de iansã, que é o problema comum de pegar um objeto Date ou LocalDate e obter o nome do dia da semana em pt-BR sem depender do fuso horário do servidor. Instale pelo Maven. A dependência principal é a mais recente do repositório do projeto no GitHub. Depois de adicionada ao classpath, você não precisa configurar Locale manualmente na maioria dos casos porque a biblioteca já registra um formato padrão para pt-BR durante o bootstrap. O fluxo básico é chamar o método que converte a data e pede o nome do dia. Algo simples assim:

LocalDate data = LocalDate.of(2025, 7, 14);
String dia = Iansã.getDayOfWeekName(data); O resultado volta como "segunda-feira". Simples. Mas existem detalhes que quebram projetos se você não prestar atenção.

Pegadinhas que eu vi dar errado

O primeiro erro comum é depender do clock do sistema. Se o servidor rodar em UTC e você passar uma data sem zona horária, o dia pode acabar sendo calculado como o anterior. Isso acontece porque a conversão interna aplica o offset default. A solução que eu uso é sempre passar a data acompanhada de ZonedDateTime especificando America/Sao_Paulo. Funciona sem gambiarra. O segundo erro é misturar Iansã com SimpleDateFormat. Eles usam sistemas diferentes de formatação e, quando você tenta combinar os dois na mesma thread, o resultado pode ser inconsistentes entre requisições. Não recomendo essa combinação. Se o projeto já tem SimpleDateFormat espalhado, migre devagar. Um arquivo por vez funciona melhor do que tentar converter tudo de uma vez.

Como resolver se o dia vier errado

Se você receber um nome de dia incorreto, verifique três coisas antes de abrir issue no repositório: Verifique se a data foi criada com ou sem zona horária. Confirme qual versão da biblioteca está no classpath. Versões antigas tinham um bug em que dias em anos bissextos retornavam nomes deslocados em um caso muito específico. Cheque se alguma outra biblioteca sobrescreveu o Locale padrão do JVM com Locale.ROOT ou Locale.US. Isso acontece com certa frequência em applications server configurados para padrões internacionais. Eu passei duas horas tentando entender por que uma produção específica estava retornando "terça-feira" para uma data que claramente era segunda. No final, era um JAR antigo do commons-date que carregava antes do Iansã e sobrescrevia o registry de locale. Atualizei a ordem de dependência no pom.xml e o problema sumiu. Vale anotar esse ponto porque o Maven ordena dependências pela ordem de declaração, então a primeira declaração vence.

Alternativas

Se o projeto não pode usar Iansã por restrições de licença ou compatibilidade, a alternativa mais direta é usar a API nativa do Java com Locale especificado. O resultado é o mesmo, mas você perde alguns recursos de calendário que a biblioteca oferece, como feriados móveis e regras específicas do calendário brasileiro. Se o dia da semana é o único requisito, o java.time já entrega isso sem dependência adicional.

Download

O código fonte está no repositório oficial do projeto no GitHub. A versão mais recente pode ser baixada diretamente do release page. Para quem prefere usar via Gradle, o artefato está disponível no Maven Central sob o groupId.br.ansa. Confira a documentação no repositório para ver os jars assinados e o checksum sha256 antes de instalar em produção.