09. Datas, horários e internacionalização

Este capítulo nasce das 24 questões publicadas sobre Datas, horários e internacionalização. A leitura do acervo revelou 6 núcleos de conhecimento, aqui reorganizados como uma explicação progressiva: primeiro o vocabulário e o modelo mental, depois os mecanismos, as decisões de implementação, os limites e a forma de verificar o comportamento do sistema.

A disciplina percorre PHP desde sintaxe e tipos até aplicações web seguras e operáveis. Os capítulos conectam linguagem, requisição HTTP, orientação a objetos, dados, frameworks, testes, desempenho e implantação. Este é o capítulo 9 de 40 da disciplina PHP. Ele retoma Arquivos, streams e uploads e utiliza essa base para avançar. Na sequência, estudaremos Expressões regulares e mbstring.

O fio condutor

O desenvolvimento de software começa com um problema e avança por decisões que precisam permanecer compreensíveis e verificáveis. Requisitos orientam modelos; modelos orientam código e arquitetura; testes verificam comportamento; e a operação devolve informações para o próximo ciclo. Uma falha importante no início tende a se espalhar pelas etapas seguintes.

Neste capítulo, use Datas, horários e internacionalização para acompanhar quatro perguntas: qual problema precisa ser resolvido, como o mecanismo funciona, que consequências a escolha produz e como o resultado será verificado. Essa sequência transforma termos técnicos em decisões que podem ser explicadas e testadas.

Parte 1 — Fundamentos e vocabulário

Começamos por Parte 1 — Fundamentos e vocabulário, pois essa base organiza os conceitos e exemplos que aparecerão no restante do capítulo.

DateTimeImmutable retorna nova instância em alterações, ao passo que DateTime modifica o

O ponto de partida é estabelecer o significado do conceito e o problema que ele procura organizar. DateTimeImmutable retorna nova instância em alterações, ao passo que DateTime modifica o próprio objeto. O núcleo do assunto é a separação entre instante, fuso horário, calendário e apresentação. A conclusão precisa respeitar a redação efetiva — inclusive eventual negação — sem aplicar offsets fixos ou perder o fuso relevante ao domínio. Na prática, essa leitura evita ambiguidades em horário de verão, ordenação e conversão entre usuários. A regra ganha sentido quando suas consequências orientam a implementação.

Para aplicar DateTimeImmutable retorna nova instância em alterações, ao passo que DateTime modifica o, acompanhe a execução desde a entrada até a saída e anote pré-condições, mudança de estado, custo e falhas possíveis. Assim o conceito deixa de ser um rótulo e passa a orientar decisões.

Use como teste da compreensão: Em uma revisão de código PHP, avalie: DateTimeImmutable retorna nova instância em alterações, ao passo que DateTime modifica o próprio objeto. Depois verifique a afirmação com execução controlada, teste automatizado, análise do contrato, medição ou documentação da versão correspondente. A evidência deve reproduzir a propriedade afirmada, inclusive nos casos de erro e de fronteira.

Como tratar instantes para usuários em fusos diferentes? — Persistir o instante em UTC e

A partir dessa distinção, o próximo elemento completa o fluxo. Como tratar instantes para usuários em fusos diferentes? — Persistir o instante em UTC e converter na apresentação, preservando o fuso quando ele integra o domínio.: evita ambiguidades e mantém semântica. O núcleo do assunto é a separação entre instante, fuso horário, calendário e apresentação. A conclusão precisa respeitar a redação efetiva — inclusive eventual negação — sem aplicar offsets fixos ou perder o fuso relevante ao domínio. Na prática, essa leitura evita ambiguidades em horário de verão, ordenação e conversão entre usuários. Observe como definição, mecanismo e efeito permanecem ligados.