Ajuste do Time Zone do Java

---
title: Ajuste do Time Zone do Java
slug: ajuste-time-zone-java
sistema:
  - Servidor Nota Fiscal Eletrônica [24]
categoria: user_manual
tipo: how-to
publico: "Técnicos responsáveis pela manutenção do Servidor de Notas Teorema em Linux ou Windows"
autor: Willian Stefanes de Oliveira
setor: Qualidade
modulo: Servidor de Notas
keywords:
  - time zone
  - java
  - tzupdater
  - horário de verão
  - servidor de notas
  - linux
aprovado_em: 16/12/2022
release: ""
versao_pipeline: 2.7.0
ultima_revisao: "2026-06-13"
chamado: ""
---

## Visão Geral

O Java mantém seu próprio banco de fuso horário (Time Zone), independente do horário configurado no sistema operacional. Quando o Servidor de Notas Teorema é executado em Linux com uma versão de Java desatualizada, o fuso pode permanecer configurado para o horário de verão — causando divergências de data e hora na emissão de Nota Fiscal Eletrônica (NF-e). Este procedimento descreve como atualizar o Time Zone do Java usando o utilitário TZUpdater da Oracle, tanto em Linux quanto em Windows.

> **Pré-requisito:** Java instalado na máquina. O procedimento deve ser executado por um técnico com acesso ao terminal (Linux) ou Prompt de Comando como Administrador (Windows).

## Atualizar o Time Zone do Java no Linux

### Baixar o TZUpdater

Acesse a página de downloads do TZUpdater em:
[https://www.oracle.com/java/technologies/javase-tzupdater-downloads.html](https://www.oracle.com/java/technologies/javase-tzupdater-downloads.html)

![Página "Java SE TZUpdater Downloads" no site da Oracle, exibindo a seção "Java SE Timezone Updater 2.3.2" com a tabela contendo o produto "TZUpdater", tamanho "0.15 MB" e botão de download "tzupdater-2_3_2.zip"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/ajuste-time-zone-java/ajuste-time-zone-java-01.png)

Aceite o contrato de licença marcando a opção "I reviewed and accept the Java SE Timezone Updater License Agreement" e clique em **Download tzupdater-2.3.2.zip**.

![Diálogo de aceitação da licença do TZUpdater com checkbox "I reviewed and accept the Java SE Timezone Updater License Agreement" marcado e botão "Download tzupdater-2.3.2.zip" destacado; no canto superior direito da janela do Firefox aparece o arquivo "tzupdater-2.3.2.zip" concluído no painel de downloads](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/ajuste-time-zone-java/ajuste-time-zone-java-02.png)

### Criar a pasta e salvar o arquivo

Dentro do diretório `/home/teorema/Teorema/`, crie uma pasta chamada `tzupdater-2.3.2` e salve o arquivo `tzupdater.jar` extraído do zip nessa pasta.

![Gerenciador de arquivos Linux mostrando o conteúdo da pasta "/home/teorema/Teorema/tzupdater-2.3.2" com três itens: README, tzdata2022g.tar.gz e tzupdater.jar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/ajuste-time-zone-java/ajuste-time-zone-java-03.png)

### Abrir o terminal na pasta

Com a pasta `tzupdater-2.3.2` aberta no gerenciador de arquivos, clique com o botão direito em uma área vazia e selecione **Abrir no Terminal**.

![Gerenciador de arquivos Linux com menu de contexto aberto na pasta tzupdater-2.3.2, exibindo as opções "Criar pasta", "Criar documento", "Abrir no Terminal" (destacado), "Abrir como Administrador", "Organizar itens", "Organizar por nome", "Colar", "Ampliar", "Reduzir", "Tamanho normal" e "Propriedades"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/ajuste-time-zone-java/ajuste-time-zone-java-04.png)

### Executar o TZUpdater

No terminal, execute o comando abaixo para atualizar o Time Zone do Java automaticamente:

```bash
java -jar tzupdater.jar -f -l https://www.iana.org/time-zones/repository/tzdata-latest.tar.gz
```

![Terminal Linux com o comando "java -jar tzupdater.jar -f -l https://www.iana.org/time-zones/repository/tzdata-latest.tar.gz" executado no diretório ~/Teorema/tzupdater-2.3.2; saída exibe a linha "Using https://www.iana.org/time-zones/repository/tzdata-latest.tar.gz as source for tzdata bundle."](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/ajuste-time-zone-java/ajuste-time-zone-java-05.png)

> **Nota:** A mensagem `Using https://www.iana.org/time-zones/repository/tzdata-latest.tar.gz as source for tzdata bundle.` indica que a atualização foi realizada com sucesso.

## Atualizar o Time Zone do Java no Windows

Abra o Prompt de Comando como Administrador, navegue até o diretório onde está o `tzupdater.jar` e execute:

```cmd
cd C:\Program Files\Java
java -jar .\tzupdater.jar -f -l https://www.iana.org/time-zones/repository/tzdata-latest.tar.gz
```

Quando concluído com sucesso, o Prompt de Comando exibe a mensagem `Using https://www.iana.org/time-zones/repository/tzdata-latest.tar.gz as source for tzdata bundle.` e retorna ao prompt sem erros.

![Prompt de Comando do Windows executado como Administrador, mostrando os comandos "cd C:\Program Files\Java" e "java -jar .\tzupdater.jar -f -l https://www.iana.org/time-zones/repository/tzdata-latest.tar.gz", seguidos da saída "Using https://www.iana.org/time-zones/repository/tzdata-latest.tar.gz as source for tzdata bundle." e retorno ao prompt C:\Program Files\Java>](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/ajuste-time-zone-java/ajuste-time-zone-java-06.png)

## Informações do documento

> Autor: Willian Stefanes de Oliveira
> Setor: Qualidade
> Módulo: Servidor de Notas
> Chamado:
> Versão do Sistema: D 22.04a
> Versão do documento: 01
> Revisão: Andreia Burko Bley
> Aprovado em: 16/12/2022

---

> 📎 **Arquivos originais:** [Manual Ajuste do Time Zone do Java.docx](https://drive.google.com/uc?export=download&id=1bn_M7uGE-G7y8ADwsR1l9dt0n1ftWNER) · [Manual Ajuste do Time Zone do Java.pdf](https://drive.google.com/uc?export=download&id=1J-py706tGpskw44qvRPC8q3zgOvbpDWN)