Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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