CKTIS / Java
DateTimeFormatter.ofPattern: padrão de data e hora com Locale.ENGLISH
Cria um formatador para `yyyy-MM-dd HH:mm z` com `Locale.ENGLISH` explícito e descobre de onde vem o fuso horário apresentado no resultado.
Versão: Java SE 21
Sintaxe
import java.time.format.DateTimeFormatter;
import java.util.Locale;
DateTimeFormatter.ofPattern(String pattern)
DateTimeFormatter.ofPattern(String pattern, Locale locale)
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm z", Locale.ENGLISH)O método estático DateTimeFormatter.ofPattern do pacote java.time.format cria um formatador imutável, seguro para utilização por várias threads e reutilizável para formatação e análise de texto. ofPattern(String) usa a configuração regional predefinida de Locale.Category.FORMAT; ofPattern(String, Locale) usa a que forneceres, como Locale.ENGLISH. Ambas as sobrecargas lançam uma IllegalArgumentException ao criar o formatador se o padrão for inválido. Na análise, ambas usam por predefinição o modo de resolução SMART.
As letras do padrão distinguem maiúsculas de minúsculas. Em yyyy-MM-dd HH:mm z, yyyy representa o ano da era com pelo menos quatro algarismos. MM e dd são o mês e o dia do mês; HH e mm são a hora (00–23) e os minutos. Estes quatro campos são preenchidos com um zero inicial quando necessário para terem dois algarismos. Já uuuu representa o ano proléptico, que admite o ano 0.
Ao formatar, um único z apresenta o nome curto do fuso e tem em conta a hora de verão quando é possível determinar se está em vigor. Locale.ENGLISH escolhe o idioma desse texto, não o fuso. Nenhuma das sobrecargas impõe um fuso: ZonedDateTime fornece-o, mas LocalDateTime por si só não basta. Os nomes dos fusos regionais podem variar conforme os dados de localização do ambiente de execução e não são necessariamente únicos. Com um ZoneOffset fixo, z apresenta o identificador do desvio em vez de um nome.
Exemplos
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.util.Locale;
public class Main {
public static void main(String[] args) {
DateTimeFormatter formatter =
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm z", Locale.ENGLISH);
ZonedDateTime dateTime =
ZonedDateTime.of(2024, 2, 9, 7, 5, 0, 0, ZoneOffset.ofHours(2));
System.out.println(formatter.format(dateTime));
}
}
Resultado
2024-02-09 07:05 +02:00
O resultado `2024-02-09 07:05 +02:00` resulta de uma data, uma hora e um desvio fixo indicados explicitamente. `+02:00` é o identificador do desvio, não um nome de fuso em inglês. O exemplo não usa o relógio do sistema, nem o fuso ou a configuração regional predefinidos.
Lições relacionadas
- Java · Lição 59 · Intermédio · Versão: 2
Fontes
- DateTimeFormatter (Java SE 21 & JDK 21) — overloads, pattern letters, and resolver style
- DateTimeFormatterBuilder (Java SE 21 & JDK 21) — formatting and parsing zone text
- ZonedDateTime (Java SE 21 & JDK 21) — constructing a zoned date-time
- ZoneOffset (Java SE 21 & JDK 21) — offset ID
- LocaleServiceProvider (Java SE 21 & JDK 21) — locale data providers