feat(localization): 🎸 locale, translated

Refers: #5

Author: rcmoutinho

book/03-localization/sections/01-locale.asc

@@ -1,44 +1,42 @@
 :java-package: src/org/j6toj8/localization
 :section-java-package: ../../../{java-package}
 
-=== Localização (Locale)
+=== Locale
 
-.Objetivo
+.Objective
 --------------------------------------------------
 Describe the advantages of localizing an application and developing code that defines, reads, and sets the locale with a Locale object.
--
-Descrever as vantagens de localizar uma aplicação e desenvolver código que defina, leia e aplique a localidade em um objeto Locale.
 --------------------------------------------------
 
-É esperado que o candidato saiba compreender e analisar aspectos de Internacionalização e Localização, incluindo o uso da da classe `Locale`.
+The candidate is expected to be able to understand and analyze aspects of Internationalization and Localization, including the use of the `Locale` class.
 
-Alguns aspectos de uma aplicação podem depender do país e da linguagem. Por exemplo:
+Some aspects of an application may depend on country and language. For example:
 
-* Formatos de escrita de data
-** O dia 6 de Agosto de 2019 seria representado no Brasil por `06/08/2019`, porém nos EUA seria `08/06/2019`.
-* Formatos de escrita de valores monetários
-** Dez Reais no Brasil seriam representados por `R$ 10`, enquanto na França Dez Euros seriam `10 €`.
-* Formatos de separação de casas decimais ou milhares
-** No Brasil utiliza-se vírgula para separar decimais e pontos para milhares: `100.245,03`. Nos EUA, utiliza-se o inverso: `100,245.03`.
+* Date writing formats
+** August 6, 2019, would be represented in Brazil by `06/08/2019`, but in the USA would be `08/06/2019`.
+* Currency value writing formats
+** Ten Reais in Brazil would be represented by `R$ 10`, while in France Ten Euros would be `10 €`.
+* Decimal or Thousand Separation Formats
+** In Brazil comma is used to separate decimals and points to thousands: `100.245,03`. In the USA, it is the opposite: `100,245.03`.
 
-Por isso, para que sua aplicação lide corretamente com esses cenários, é necessário compreender dois aspectos: *Internacionalização* (_Internationalization_) e *Localização* (_Localization_).
+Therefore, in order for your application to handle these scenarios correctly, you need to understand two aspects: *Internationalization* and *Localization*.
 
-A *Internacionalização*, também chamada de *_i18n_*, é o ato de projetar sua aplicação para que seja possível facilmente adaptá-la para utilizar novos formatos e idiomas.
+*Internationalization*, also called *_i18n_*, is the act of designing your application so that you can easily adapt it to use new formats and languages.
 
-A *Localização*, também chamada de *_l10n_*, é o ato de adaptar sua aplicação para de fato utilizar um novo formato específico.
+*Localization*, also called *_l10n_*, is the act of tailoring your application to actually use a new specific format.
 
-Antes de continuar, entenda a execução do método `main` no exemplo a seguir e o que é apresentado no console após sua execução.
+Before proceeding, understand the execution of the `main` method in the following example and what is presented on the console after its execution.
 
 [source,java,indent=0]
 .{java-package}/locale/Locale_Complete.java
 ----
 include::{section-java-package}/locale/Locale_Complete.java[tag=code]
 ----
 
-.Saída no console
+.console output
 [source,console]
 ----
- - Constantes - 
+ - Constants -
 en_CA
 en_GB
  - Construtor - 
@@ -57,76 +55,77 @@ az_AZ_#Latn
 bs_BA_POSIX_#Latn_c-cc
 ----
 
-No Java, a classe `Locale` no pacote `java.util` nos ajuda a lidar com esses aspectos.
+In Java, the `Locale` class in the `java.util` package helps us deal with these aspects.
 
-. Geralmente, um `Locale` é representado por um idioma e um país. 
-* `pt_BR` - Português do Brasil
-* `en_US` - Inglês dos EUA
-* `it_CH` - Italiano da Suíça
-* `fr_BE` - Francês da Bélgica
+. Generally, a `Locale` is represented by a language and a country.
+* `pt_BR` - Brazilian Portuguese
+* `en_US` - US English
+* `it_CH` - Italian from Switzerland
+* `fr_BE` - French from Belgium
 +
 [source,java,indent=0]
 .{java-package}/locale/Locale_LocaleLanguageCountry.java
 ----
 include::{section-java-package}/locale/Locale_LocaleLanguageCountry.java[tag=code]
 ----
 
-. Um `Locale` pode ter ainda uma Variante, um Script e Extensões.
+. A `Locale` can also have a Variant, a Script and Extensions.
 +
 [source,java,indent=0]
 .{java-package}/locale/Locale_VarScriptExtension.java
 ----
 include::{section-java-package}/locale/Locale_VarScriptExtension.java[tag=code]
 ----
 +
-TIP: No exame da certificação, a Oracle geralmente só utiliza idioma e país.
+TIP: In the certification exam, Oracle usually only uses language and country.
 
-. É possível construir um Locale com o `Builder`, com construtores, ou por uma _Language Tag_.
+. It is possible to build a Locale with `Builder`, with constructors, or by a _Language Tag_.
 +
 [source,java,indent=0]
 .{java-package}/locale/Locale_LocaleInstantiation.java
 ----
 include::{section-java-package}/locale/Locale_LocaleInstantiation.java[tag=code]
 ----
 +
-A diferença entre eles é:
+The difference between them is:
 +
-* Com os construtores é possível passar apenas o idioma, a região (país) e uma variante.
-* Com language tags é possível passar uma `String` no padrão https://en.wikipedia.org/wiki/IETF_language_tag[IETF BCP 47].
-* Com o builder é possível criar da forma mais específica possível: idioma, região, variante, script e extensões.
+* With constructors it is possible to pass only the language, the region (country) and a variant.
+* With language tags you can pass a `String` in the pattern https://en.wikipedia.org/wiki/IETF_language_tag[IETF BCP 47].
+* With the builder you can create as specific as possible: language, region, variant, script and extensions.
 
-. O `Locale` aceita letras maiúsculas e minúsculas escritas de forma incorreta. 
+. `Locale` accepts incorrectly typed uppercase and lowercase letters.
 +
 [source,java,indent=0]
 .{java-package}/locale/Locale_LocaleCase.java
 ----
 include::{section-java-package}/locale/Locale_LocaleCase.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
 pt_BR
 pt_BR
 pt_BR
 ----
 +
-Nesse exemplo, escrevemos de forma *incorreta*:
+In this example, we wrote *incorrectly*:
 +
-* O idioma deveria ser minúsculo (pt), mas está maiúsculo (PT).
-* A região deveria estar maiúscula (BR), está minúscula (br).
+* Language should be lowercase (pt), but it is in uppercase (PT).
+* Region should be uppercase (BR), but it is in lowercase (br).
+
 +
-Mesmo assim, o `Locale` é criado corretamente. Veja que isso é um código *ruim*. O ideal é sempre escrever respeitando maiúsculas e minúsculas.
+Even so, `Locale` is created correctly. Note that this is *bad* code. The ideal is always to write respecting the case.
 
-. Existem algumas constantes na classe `Locale` para as localizações mais populares.
+. There are some constants in the `Locale` class for the most popular locations.
 +
 [source,java,indent=0]
 .{java-package}/locale/Locale_LocaleCommons.java
 ----
 include::{section-java-package}/locale/Locale_LocaleCommons.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
 en_CA
@@ -139,53 +138,52 @@ zh_CN
 zh_TW
 ----
 
-. É possível recuperar o `Locale` padrão ou alterá-lo programaticamente.
+. You can retrieve the default `Locale` or change it programmatically.
 +
 [source,java,indent=0]
 .{java-package}/locale/Locale_LocaleDefault.java
 ----
 include::{section-java-package}/locale/Locale_LocaleDefault.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
-pt_BR
+en_BR
 ko_KR
 ----
 
-. É possível verificar os `Locale` disponíveis, pois eles variam de acordo com a JVM sendo executada.
+. You can check the available `Locale` as they vary according to the JVM running.
 +
 [source,java,indent=0]
 .{java-package}/locale/Locale_LocaleAvailable.java
 ----
 include::{section-java-package}/locale/Locale_LocaleAvailable.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
-
-nn
+ar_AE
 ar_JO
+ar_SY
+hr_HR
+fr_BE
+es_PA
+mt_MT
+es_VE
 bg
-kea
-nds
-zu
-am_ET
-fr_DZ
-ti_ET
 ----
 
-. Um `Locale` também pode ser representado somente pelo idioma.
+. A `Locale` can also be represented by language only.
 +
 [source,java,indent=0]
 .{java-package}/locale/Locale_LocaleLanguageOnly.java
 ----
 include::{section-java-package}/locale/Locale_LocaleLanguageOnly.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
 pt
@@ -194,12 +192,12 @@ es
 fr
 ----
 
-.Referências
+.References
 ****
 
 * Adding Internationalization and Localization
 +
-Boyarsky, Jeanne; Selikoff, Scott. OCP: Oracle Certified Professional Java SE 8 Programmer II Study Guide (p. 255). Wiley. Edição do Kindle. 
+Boyarsky, Jeanne; Selikoff, Scott. OCP: Oracle Certified Professional Java SE 8 Programmer II Study Guide (p. 255). Wiley. Kindle Edition.
 
 * https://www.baeldung.com/java-8-localization[Internationalization and Localization in Java 8.]
 
@@ -209,4 +207,4 @@ Boyarsky, Jeanne; Selikoff, Scott. OCP: Oracle Certified Professional Java SE 8
 
 * http://www.oracle.com/us/technologies/java/locale-140624.html[Internationalization: Understanding Locale in the Java Platform.]
 
-****
+****

src/org/j6toj8/localization/locale/Locale_Complete.java

@@ -7,7 +7,7 @@ public class Locale_Complete {
 
   // tag::code[]
   public static void main(String[] args) throws IOException {
-    System.out.println(" - Constantes - ");
+    System.out.println(" - Constants - ");
     System.out.println(Locale.CANADA);
     System.out.println(Locale.UK);
 

src/org/j6toj8/localization/locale/Locale_LocaleAvailable.java

@@ -8,7 +8,7 @@ public class Locale_LocaleAvailable {
   // tag::code[]
   public static void main(String[] args) throws IOException {
     Locale[] availableLocales = Locale.getAvailableLocales();
-    // imprime o 10 primeiros Locales disponíveis
+    // prints the first 10 available locales
     for (int i = 0; i < 10; i++) {
       System.out.println(availableLocales[i]);
     }

src/org/j6toj8/localization/locale/Locale_LocaleDefault.java

@@ -7,8 +7,8 @@ public class Locale_LocaleDefault {
 
   // tag::code[]
   public static void main(String[] args) throws IOException {
-    System.out.println(Locale.getDefault()); // o padrão inicial muda de acordo com seu dispositivo
-    Locale.setDefault(Locale.KOREA); // altera o Locale default
+    System.out.println(Locale.getDefault()); // initial default changes according to your device
+    Locale.setDefault(Locale.KOREA); // change the default Locale
     System.out.println(Locale.getDefault()); // ko_KR
   }
   // end::code[]

src/org/j6toj8/localization/locale/Locale_LocaleInstantiation.java

@@ -7,11 +7,11 @@ public class Locale_LocaleInstantiation {
 
   // tag::code[]
   public static void main(String[] args) throws IOException {
-    new Locale("pt", "BR"); // pt-BR com Construtor
+    new Locale("pt", "BR"); // pt-BR with constructor
 
-    Locale.forLanguageTag("pt-BR"); // pt-BR com LanguageTag
+    Locale.forLanguageTag("pt-BR"); // pt-BR with LanguageTag
 
-    Locale localePtBR = new Locale.Builder() // pt-BR com Builder
+    Locale localePtBR = new Locale.Builder() // pt-BR with Builder
       .setLanguage("pt")
       .setRegion("BR")
       .build();

src/org/j6toj8/localization/locale/Locale_LocaleLanguageCountry.java

@@ -7,10 +7,10 @@ public class Locale_LocaleLanguageCountry {
 
   public static void main(String[] args) throws IOException {
     // tag::code[]
-    new Locale("pt", "BR"); // Português do Brasil
-    new Locale("en", "US"); // Inglês dos EUA
-    new Locale("it", "CH"); // Italiano da Suíça
-    new Locale("fr", "BE"); // Francês da Bélgica
+    new Locale("pt", "BR"); // Brazilian Portuguese
+    new Locale("en", "US"); // US English
+    new Locale("it", "CH"); // Italian from Switzerland
+    new Locale("fr", "BE"); // French from Belgium
     // end::code[]
   }
 }

src/org/j6toj8/localization/locale/Locale_LocaleLanguageOnly.java

@@ -7,10 +7,10 @@ public class Locale_LocaleLanguageOnly {
 
   // tag::code[]
   public static void main(String[] args) throws IOException {
-    System.out.println(new Locale("pt")); // português
-    System.out.println(new Locale("en")); // inglês
-    System.out.println(new Locale("es")); // espanhol
-    System.out.println(new Locale("fr")); // francês
+    System.out.println(new Locale("pt")); // portuguese
+    System.out.println(new Locale("en")); // english
+    System.out.println(new Locale("es")); // spanish
+    System.out.println(new Locale("fr")); // french
   }
   // end::code[]
 }