br-timezone

Determine o fuso horário no Brasil de acordo com o Estado ou Cidade

Usage no npm install needed!

<script type="module">
  import brTimezone from 'https://cdn.skypack.dev/br-timezone';
</script>

README

Fusos horários BR

Determine o fuso horário no Brasil de acordo com o Estado ou Cidade.

Atualmente o Brasil observa quatro fusos horários1, mas os seus códigos estão obsoletos2,3,4,5. Existem outros códigos de fusos horários com nomes de localidades específicas, e que são utilizados em suas proximidades.

Esse pacote oferece uma função que retorna um código de fuso horário com base na sigla de um Estado (ou Distrito Federal), e opcionalmente em um código de município do IBGE.

Apenas alguns municípios estão mapeados para um fuso horário, a maioria sendo relacionada à Lei Nº 12.876, de 30 de Outubro de 2013, que definiu que alguns municípios ao sudoeste do Estado do Amazonas devem seguir o Horário do Acre. Todos os Estados estão mapeados para um fuso horário.

Atenção: alguns Estados podem estar mapeados para um fuso horário que não é o utilizado na prática. Sugestões de melhorias são bem-vindas!

Instalação

npm install br-timezone

Uso

import { getBrTimezone } from 'br-timezone'

console.log(getBrTimezone('SP')) // 'America/Sao_Paulo'

console.log(getBrTimezone('SE')) // 'America/Maceio'

console.log(getBrTimezone('AM', '1304062')) // 'America/Rio_Branco'

console.log(getBrTimezone('PE', '2605459')) // 'America/Noronha'

Licença

MIT License