Exibição de hora - formatação

1. Classe DateTimeFormatter

A classe especial DateTimeFormatterencontra seu caminho na API Date Time. Seu objetivo é tornar o mais fácil possível para os programadores converter uma data e hora no formato exato que desejam. E estamos felizes em informar que os criadores do Java tiveram sucesso.

Usá-lo é muito fácil. Primeiramente, você precisa criar uma DateTimeFormatterclasse e passar em um padrão que especifique como ela irá exibir a data e hora:

DateTimeFormatter dtf = DateTimeFormatter.ofPattern(pattern);

Onde dtfé uma DateTimeFormattervariável. é um método estático da classe. E padrão é uma string que especifica o padrão que será usado para exibir a data e a hora.DateTimeFormatter.ofPattern()DateTimeFormatter

Exemplos

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("MM-dd-yy");
String text = dtf.format( LocalDateTime.now() );
System.out.println(text);

02-22-19

No exemplo acima, utilizamos o ofPattern()método para criar um DateTimeFormatterobjeto baseado no padrão. E na próxima linha, usamos o format()método para converter um LocalDateTimeobjeto em uma string. Você vê o resultado na tela.

Você pode passar quase qualquer objeto da API Date Time para o format()método.

A estática ofPattern()também é muito simples: pega um padrão como argumento e retorna um DateTimeFormatterobjeto. A parte mais interessante é encontrada no padrão.

2. Padrão de formatação

A string passada como padrão é usada como padrão ao exibir informações. MM é substituído pelo número do mês, dd pelo dia do mês e yy pelo número do ano. O caso das cartas é importante.

A tabela completa para esses padrões de tempo é esta:

Não é particularmente difícil de lembrar.

Mas por que o padrão no exemplo inclui letras repetidas MM, dd e yy? Bem, é aqui que fica mais interessante.

Ideia geral

O número de letras afeta o comprimento do texto. Quanto mais letras houver, mais longo será o texto.

Se a letra H for especificada uma vez, 9 horas serão exibidas como 9, mas se a letra H for especificada duas vezes seguidas, 9 horas serão exibidas como 09.

Se a letra y for especificada 2 vezes seguidas, o ano será escrito com 2 dígitos. Se ocorrer 4 vezes seguidas, serão usados ​​4 dígitos.

Se a letra M for especificada 2 vezes seguidas, o número do mês será gravado. Se 3 vezes seguidas, o nome do mês (suas 3 primeiras letras) é usado. Se 4 vezes seguidas, o nome completo do mês é usado.

Exemplo:

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("MMMM-dd-yyyy");
String text = dtf.format( LocalDateTime.now() );
System.out.println(text);

February-22-2019

3. Tabela completa de padrões

A tabela completa é bem grande e super interessante:

By the way, esta não é realmente uma versão completa. Você pode encontrar a versão mais completa aqui .

4. Tempo de análise

A DateTimeFormatterclasse também é interessante por sua capacidade não apenas de converter uma data e hora em uma string de acordo com um determinado padrão, mas também de realizar a operação inversa!

Analisar uma string é o processo de dividi-la em tokens significativos.

Aqui está o que parece:

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("MMMM-dd-yyyy");
LocalDate date = LocalDate.parse("February-23-2019", dtf);
System.out.println(date);

February-23-2019

Primeiro, criamos um DateTimeFormatterobjeto e definimos o padrão usado para análise.

Em seguida, chamamos o método LocalDate.parse()or LocalTime.parse()ou LocalDateTime.parse()e passamos a string a ser analisada junto com o DateTimeFormatterobjeto, que entende como analisar o texto passado e qual padrão deve ser utilizado para isso.

Outro exemplo: desta vez vamos analisar o tempo.

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("HH:mm:ss");
LocalTime time = LocalTime.parse("23:59:59", dtf);
System.out.println(time);

23:59:59