Como alterar o fuso horário da sua aplicação

Perguntas e Sintomas Comuns:

• "A hora do meu projeto/bot está errada."
• "Meu sistema está registrando logs com 3 horas de diferença (para mais ou para menos)."
• "Como mudar o fuso horário (timezone) para o horário de Brasília?"
• "Por que o horário do servidor não é o do Brasil?"

Por que a hora do projeto está diferente?

Os servidores da Square Cloud estão localizados em Nova York, EUA. Por padrão, o fuso horário é configurado em UTC-0.

Neste artigo, ensinamos como você pode personalizar o fuso horário da sua aplicação para qualquer região desejada, corrigindo diferenças de horário no seu código.

Como configurar o fuso horário correto

As seções a seguir fornecem exemplos de código para aplicar a conversão de fuso horário em JavaScript e Python:

JavaScript

1. Usando a API Nativa

const date = new Date();
const dateString = date.toLocaleString("pt-BR", { timeZone: "America/Sao_Paulo" });
console.log(dateString);

2. Usando a biblioteca Moment.js

const moment = require('moment');
require('moment-timezone');

const date = moment();
const time = date.tz('America/Sao_Paulo');

// Define the format string for date and time representation
// YYYY: Ano com quatro dígitos (ex.: 2022)
// MM: Mês com dois dígitos (ex.: 01 para janeiro)
// DD: Dia do mês com dois dígitos (ex.: 01)
// HH: Hora em formato 24h com dois dígitos (ex.: 13)
// mm: Minuto com dois dígitos (ex.: 05)
// ss: Segundo com dois dígitos (ex.: 09)
const formattedTime = time.format('YYYY-DD-MM HH:mm:ss');
console.log(formattedTime); // Exibe a data e hora no fuso "America/Sao_Paulo"

Python

1. Usando biblioteca Nativa (timedelta)

from datetime import datetime, timedelta

# Cria um objeto datetime
now = datetime.now()

# Define a diferença de fuso horário (-3 horas para America/Sao_Paulo)
time_difference = timedelta(hours=-3)

# Aplica a diferença para alterar o fuso horário
time = now + time_difference

# Formata data e hora
formatted_time = time.strftime('%Y-%d-%m %H:%M:%S')
print(formatted_time)  # Exibe a data e hora no fuso "America/Sao_Paulo"

2. Usando a biblioteca Pytz

from datetime import datetime
import pytz

# Cria um objeto datetime em UTC
now = datetime.now(pytz.utc)

# Define o fuso "America/Sao_Paulo"
tz = pytz.timezone('America/Sao_Paulo')

# Converte para o fuso definido
time = now.astimezone(tz)

# Formata data e hora
formatted_time = time.strftime('%Y-%d-%m %H:%M:%S')
print(formatted_time)  # Exibe a data e hora no fuso "America/Sao_Paulo"

Atualizado em: 20/05/2026