revisão e ajustes #11

Author: rcmoutinho

book/03-localization/sections/04-formats.asc

@@ -1,3 +1,4 @@
+
 :java-package: src/org/j6toj8/localization
 :section-java-package: ../../../{java-package}
 
@@ -10,13 +11,13 @@ Format dates, numbers, and currency values for localization with the NumberForma
 Formatar datas, números e valores monetários para localização utilizando as classes NumberFormat e DateFormat, incluindo padrões de formato de número e data.
 --------------------------------------------------
 
-Ainda dentro das ideias de Localização e Internacionalização, é comum a necessidade de apresentar datas, números e valores monetários em diferentes formatos. 
+Ainda dentro do assunto de Localização e Internacionalização, é comum a necessidade de apresentar datas, números e valores monetários em diferentes formatos.
 
 O exame de certificação compreende cinco classes principais de formatação:
 
 * `NumberFormat` -> Formatação geral de números, valores monetários, percentuais e números inteiros com arredondamento, possivelmente baseados em `Locale`.
 * `DecimalFormat` -> Formatação de números quando há necessidade de definições mais específicas ou personalizadas do formato.
-* `DateFormat` -> Formatação de data e hora antes do Java 8 utilizando formato predefinidos.
+* `DateFormat` -> Formatação de data e hora antes do Java 8 utilizando formatos predefinidos.
 * `SimpleDateFormat` -> Formatação de data e hora antes do Java 8 utilizando formatos mais específicos ou personalizados.
 * `DateTimeFormatter` -> Formatação de data e hora após o Java 8.
 
@@ -32,7 +33,7 @@ include::{section-java-package}/formats/numberformat/NumberFormat_Instance.java[
 +
 Lembre-se que, se não for informado o `Locale`, será utilizado o padrão. O ideal é sempre informar o `Locale`.
 
-. O `NumberFormat` por ser utilizado para transformar números em Strings.
+. O `NumberFormat` pode ser utilizado para transformar números em Strings.
 +
 [source,java,indent=0]
 .{java-package}/formats/numberformat/NumberFormat_NumberToString.java
@@ -66,9 +67,9 @@ en_US: 100005
 fr_FR: 1000.05
 ----
 +
-Perceba que dependendo do `Locale`, estamos representando um número diferente, e isso muda o resultado do parse.
+Perceba que dependendo do `Locale` estamos representando um número diferente, e isso muda o resultado do parse.
 
-. O `NumberFormat` por ser utilizado para transformar Strings em valores monetários, e vice-versa.
+. O `NumberFormat` pode ser utilizado para transformar Strings em valores monetários, e vice-versa.
 +
 [source,java,indent=0]
 .{java-package}/formats/numberformat/NumberFormat_Currency.java
@@ -89,7 +90,7 @@ Unparseable number: "R$ 1000,05"
 +
 Perceba que novamente o resultado muda de acordo com o `Locale`. Além disso, não é possível converter a representação da moeda brasileira com um `Locale` `en_US` ou `fr_FR`.
 
-. O `NumberFormat` por ser utilizado para transformar Strings em percentuais, e vice-versa.
+. O `NumberFormat` pode ser utilizado para transformar Strings em percentuais, e vice-versa.
 +
 [source,java,indent=0]
 .{java-package}/formats/numberformat/NumberFormat_Percent.java
@@ -125,16 +126,18 @@ pt_BR: 0.802
 en_US: 8.02
 ----
 +
-No `Locale pt_BR`, temos o resultado esperado. Porém, no `Locale en_US` o `80,2%` se torna `802%`, pois a vírgula não é usada como separador de decimal.
+No `Locale pt_BR` temos o resultado esperado. Porém, no `Locale en_US` o `80,2%` se torna `802%` pois a vírgula não é usada como separador de decimal.
 
 ==== DecimalFormat
 
 Enquanto `NumberFormat` permite utilizar formatos predefinidos, `DecimalFormat` permite uma personalização maior. Um exemplo de formato para o `DecimalFormat` é `\#\##,\###.\###`.
 
-* `#` preenche a posição com um número, ou omite se não houver nada.
-* `0` preenche a posição com um número, ou 0 se não houver nada.
-* `.` indica onde é a posição do separador decimal.
-* `,` indica onde é a posição do separador de grupos.
+* `#` -> preenche a posição com um número, ou omite se não houver nada.
+* `0` -> preenche a posição com um número, ou 0 se não houver nada.
+* `.` -> indica onde é a posição do separador decimal.
+* `,` -> indica onde é a posição do separador de grupos.
+
+//-- ASC: força uma nova lista não associada aos bullets acima
 
 . É possível obter uma instância de `DecimalFormat` utilizando o construtor.
 +
@@ -158,7 +161,7 @@ include::{section-java-package}/formats/decimalformat/DecimalFormat_Instance.jav
 +
 Estou executando o código onde o `Locale` padrão é `pt_BR`, por isso a saída no console apresenta vírgulas para separar grupos e pontos para separar os decimais.
 
-. Para utilizar um `Locale` específico, é necessário instanciar um `NumberFormat` e fazer um _cast_ para `DecimalFormat`.
+. Para utilizar um `Locale` específico é necessário instanciar um `NumberFormat` e fazer um _cast_ para `DecimalFormat`.
 +
 [source,java,indent=0]
 .{java-package}/formats/decimalformat/DecimalFormat_Locale.java
@@ -231,7 +234,7 @@ Perceba que ocorreu uma exceção ao tentar converter uma data utilizando um for
 
 ==== SimpleDateFormat
 
-A classe `SimpleDateFormat` permite criar formatos mais personalizados para apresentar Data e Hora, como `dd/MM/yyyy HH:mm:ss`. Seguem as letras mais importantes utilizadas na formatação para o exame:
+A classe `SimpleDateFormat` permite criar formatos mais personalizados para apresentar Data e Hora, como `dd/MM/yyyy HH:mm:ss`. A seguir, as letras mais importantes utilizadas na formatação para o exame:
 
 * `y` -> Ano (2019, 19)
 * `M` -> Mês (8, 08, Ago, Agosto)
@@ -248,6 +251,8 @@ Em geral (existem exceções), quanto mais letras forem utilizadas, mais extenso
 * `MMM` -> Ago
 * `MMMM` -> Agosto
 
+//-- ASC: força uma nova lista não associada aos bullets acima
+
 . É possível criar formatos personalizados para formatar um `Date` utilizando o construtor de `SimpleDateFormat`.
 +
 [source,java,indent=0]
@@ -285,7 +290,7 @@ Perceba a exceção ao tentar utilizar o formato incorreto.
 
 ==== DateTimeFormatter
 
-O Java 8 traz a classe `DateTimeFormatter`, que possui várias formas de formatar e transformar `Data/Hora` em `String`, e vice-versa.
+O Java 8 traz a classe `DateTimeFormatter` que possui várias formas de formatar e transformar `Data/Hora` em `String`, e vice-versa.
 
 . É possível obter instâncias predefinidas de `DateTimeFormatter`, que representam formatos `ISO` ou `RFC`.
 +
@@ -353,10 +358,10 @@ include::{section-java-package}/formats/datetimeformatter/DateTimeFormatter_Cust
 06 08 19 - 11 40 00
 ----
 +
-Para criar um `DateTimeFormatter` personalizado, é necessário conhecer o que cada letra do formato representa. Volte na seção de `SimpleDateFormat` caso não se lembre.
+Para criar um `DateTimeFormatter` personalizado é necessário conhecer o que cada letra do formato representa. Volte na seção de `SimpleDateFormat` caso não se lembre.
 +
 
-. Não é possível formatar uma Data/Hora caso o objeto fornecido não tenha os campos necessários, como tentar apresentar a Data e fornecer um `LocalTime`.
+. Não é possível formatar uma Data/Hora caso o objeto fornecido não tenha os campos necessários. Um exemplo seria tentar apresentar a Data e fornecer um `LocalTime`.
 +
 [source,java,indent=0]
 .{java-package}/formats/datetimeformatter/DateTimeFormatter_Error.java

src/org/j6toj8/localization/formats/datetimeformatter/DateTimeFormatter_Error.java

@@ -15,8 +15,9 @@ public static void main(String[] args) {
 
     System.out.println(localDate.format(DateTimeFormatter.ISO_LOCAL_DATE));
     System.out.println(localDT.format(DateTimeFormatter.ISO_LOCAL_DATE));
-    System.out.println(localTime.format(DateTimeFormatter.ISO_LOCAL_DATE)); // lança exceção pois não possui campos de
-                                                                            // data
+
+    // lança exceção pois não possui campos de data
+    System.out.println(localTime.format(DateTimeFormatter.ISO_LOCAL_DATE));
     // end::code[]
   }
 }

src/org/j6toj8/localization/formats/decimalformat/DecimalFormat_Instance.java

@@ -32,8 +32,7 @@ public static void main(String[] args) {
     DecimalFormat instance6 = new DecimalFormat("000000.000");
     System.out.println("000000.000: " + instance6.format(d));
 
-    // omite todas as posições vazias, não utiliza separador e não apresenta casas
-    // decimais
+    // omite todas as posições vazias, não utiliza separador e não apresenta casas decimais
     DecimalFormat instance7 = new DecimalFormat("###");
     System.out.println("###: " + instance7.format(d));
     // end::code[]