Fuso Horário do .NET

Resolve questões de fuso horário para código .NET e C# com orientação segura para produção e trechos prontos para copiar e colar.

Comece Com o Caminho Certo

Identifique o tipo de solicitação primeiro:

• Pesquisa de endereço ou local
• Pesquisa de ID de fuso horário
• Conversão UTC/local
• Compatibilidade de fuso horário multiplataforma
• Agendamento ou tratamento de horário de verão (DST)
• Design de API ou persistência

Se a biblioteca for incerta, use TimeZoneConverter para trabalho multiplataforma. Se o cenário envolver agendamentos recorrentes ou regras estritas de horário de verão, prefira NodaTime.

Resolva Endereços e Locais

Se o usuário fornecer um endereço, cidade, região, país ou documento contendo nomes de lugares:

1. Extraia cada local da entrada.
2. Leia references/timezone-index.md para mapeamentos comuns do Windows e IANA.
3. Se o local exato não estiver listado, infira a zona IANA correta pela geografia e, em seguida, mapeie-a para o ID do Windows.
4. Retorne ambos os IDs e um exemplo C# pronto para uso.

Para cada local resolvido, forneça:

Location: <resolved place>
Windows ID: <windows id>
IANA ID: <iana id>
UTC offset: <standard offset and DST offset when relevant>
DST: <yes/no>

Em seguida, inclua um trecho multiplataforma como:

using TimeZoneConverter;

TimeZoneInfo tz = TZConvert.GetTimeZoneInfo("Asia/Colombo");
DateTime local = TimeZoneInfo.ConvertTimeFromUtc(DateTime.UtcNow, tz);

Se vários locais estiverem presentes, inclua um bloco por local e, em seguida, um trecho combinado de vários fusos horários.

Se um local for ambíguo, liste as possíveis correspondências de fuso horário e peça ao usuário para escolher a correta.

Pesquise IDs de Fuso Horário

Use references/timezone-index.md para mapeamentos do Windows para IANA.

Sempre forneça ambos os formatos:

• ID do Windows para TimeZoneInfo.FindSystemTimeZoneById() no Windows
• ID IANA para Linux, contêineres, NodaTime e TimeZoneConverter

Gere Código

Use references/code-patterns.md e escolha o menor padrão que se encaixa:

• Padrão 1: TimeZoneInfo para código apenas para Windows
• Padrão 2: TimeZoneConverter para conversão multiplataforma
• Padrão 3: NodaTime para aritmética estrita de fuso horário e agendamento sensível ao horário de verão
• Padrão 4: DateTimeOffset para APIs e transferência de dados
• Padrão 5: Persistência e apresentação do ASP.NET Core
• Padrão 6: trabalhos recorrentes e agendadores
• Padrão 7: carimbos de data/hora de horário de verão ambíguos e inválidos

Sempre inclua orientação de pacote ao recomendar bibliotecas de terceiros.

Avise Sobre Armadilhas Comuns

Mencione o aviso relevante quando aplicável:

• TimeZoneInfo.FindSystemTimeZoneById() é específico da plataforma para IDs de fuso horário.
• Evite armazenar DateTime.Now em bancos de dados; armazene UTC em vez disso.
• Trate DateTimeKind.Unspecified como um risco de bug, a menos que seja uma entrada deliberada.
• Transições de horário de verão podem pular ou repetir horários locais.
• Ambientes Azure Windows e Azure Linux podem esperar formatos de ID de fuso horário diferentes.

Formato da Resposta

Para solicitações de endereço e local:

1. Retorne o bloco de fuso horário resolvido para cada local.
2. Declare a implementação recomendada em uma frase.
3. Inclua um trecho C# pronto para copiar e colar.

Para solicitações de código e arquitetura:

1. Declare a abordagem recomendada em uma frase.
2. Forneça os IDs de fuso horário, se relevante.
3. Inclua o trecho de código mínimo funcional.
4. Mencione o requisito de pacote, se necessário.
5. Adicione um aviso de armadilha, se importar.

Mantenha as respostas concisas e focadas no código.

Referências

• references/timezone-index.md: mapeamentos comuns de fuso horário do Windows e IANA
• references/code-patterns.md: padrões de fuso horário .NET prontos para uso