Brazil - Formatting standards & code snippets

Here is a complete list of standards and formats used in Brazil. It includes a full list of ISO codes, number, date, currency, telephone and address formats. You will also get code examples on how to perform the most common formatting operations in Java, C#, JavaScript and PHP. Multiple resource files are made available, mainly the complete list of states, in different formats such as CSV, XML, JSON, HTML and SQL.

What are the ISO-3166-1 codes for Brazil?

  • Alpha-2: BR
  • Alpha-3: BRA
  • Numeric: 076
  • Java Locale Code: pt_BR
  • .Net CultireInfo Code: pt-BR
  • PHP Locale Code: pt_BR

What is the official language in Brazil?

  • Portuguese

What is the date format in Brazil?

The date format in Brazil is little-endian:

  • Format: d/M/yyyy
    Ex: 3/12/2014
How to format dates for Brazil in Java, C#, PHP, and JavaScript

What is the time format in Brazil?

The time format in Brazil is mostly 24-hour notation, but 24-hour format is also commonly adopted.

  • HH:mm[:ss]
    Ex: 09:00 for 09:00 AM and 21:00 for 9:00 PM
How to format time for Brazil in Java, C#, PHP, and JavaScript

What is the numeric format in Brazil?

    Format: 999.999.999,99

  • Group Size: 3
  • Grouping Character: . (Dot)
  • Decimal Character: , (Comma)
How to format numbers for Brazil in Java, C#, PHP, and JavaScript

What is the currency format in Brazil?

    Format: R$ 999.999.999,99

  • Group Size: 3
  • Grouping Character: . (Dot)
  • Decimal Character: , (Comma)
  • Currency Symbol: R$
  • Currency Symbol Position: Before number
  • Currency Name: Brazilian Real (BRL)
How to format currencies for Brazil in Java, C#, PHP, and JavaScript

Download list of states/federal district for Brazil in CSV, JSON, HTML, SQL and XML


List of states/federal district: HTML - Select Control

----------------------------
 Alpha-2 code + Alpha-2 code
----------------------------
<select>
	<option value="AC,"AC</option>
	<option value="AL,"AL</option>
	<option value="AP,"AP</option>
	<option value="AM,"AM</option>
	<option value="BA,"BA</option>
	<option value="CE,"CE</option>
	<option value="DF,"DF</option>
	<option value="ES,"ES</option>
	<option value="GO,"GO</option>
	<option value="MA,"MA</option>
	<option value="MT,"MT</option>
	<option value="MS,"MS</option>
	<option value="MG,"MG</option>
	<option value="PA,"PA</option>
	<option value="PB,"PB</option>
	<option value="PR,"PR</option>
	<option value="PE,"PE</option>
	<option value="PI,"PI</option>
	<option value="RJ,"RJ</option>
	<option value="RN,"RN</option>
	<option value="RS,"RS</option>
	<option value="RO,"RO</option>	
	<option value="RR,"RR</option>		
	<option value="SC,"SC</option>			
	<option value="SP,"SP</option>
	<option value="SE,"SE</option>
	<option value="TO,"TO</option>	
</select>

----------------------------------
 Alpha-2 code + name - Portuguese
----------------------------------
<select>
	<option value="AC,"Acre</option>
	<option value="AL,"Alagoas</option>
	<option value="AP,"Amapá</option>
	<option value="AM,"Amazonas</option>
	<option value="BA,"Bahia</option>
	<option value="CE,"Ceará</option>
	<option value="DF,"Distrito Federal</option>
	<option value="ES,"Espírito Santo</option>
	<option value="GO,"Goiás</option>
	<option value="MA,"Maranhão</option>
	<option value="MT,"Mato Grosso</option>
	<option value="MS,"Mato Grosso do Sul</option>
	<option value="MG,"Minas Gerais</option>
	<option value="PA,"Pará</option>
	<option value="PB,"Paraíba</option>
	<option value="PR,"Paraná</option>
	<option value="PE,"Pernambuco</option>
	<option value="PI,"Piauí</option>
	<option value="RJ,"Rio de Janeiro</option>
	<option value="RN,"Rio Grande do Norte</option>
	<option value="RS,"Rio Grande do Sul</option>
	<option value="RO,"Rondônia</option>	
	<option value="RR,"Roraima</option>		
	<option value="SC,"Santa Catarina</option>			
	<option value="SP,"São Paulo</option>
	<option value="SE,"Sergipe</option>
	<option value="TO,"Tocantins</option>	
</select>

-------------------------------------
 ISO_3166-2 code + name - Portuguese
-------------------------------------
<select>
	<option value="BR-AC,"Acre</option>
	<option value="BR-AL,"Alagoas</option>
	<option value="BR-AP,"Amapá</option>
	<option value="BR-AM,"Amazonas</option>
	<option value="BR-BA,"Bahia</option>
	<option value="BR-CE,"Ceará</option>
	<option value="BR-DF,"Distrito Federal</option>
	<option value="BR-ES,"Espírito Santo</option>
	<option value="BR-GO,"Goiás</option>
	<option value="BR-MA,"Maranhão</option>
	<option value="BR-MT,"Mato Grosso</option>
	<option value="BR-MS,"Mato Grosso do Sul</option>
	<option value="BR-MG,"Minas Gerais</option>
	<option value="BR-PA,"Pará</option>
	<option value="BR-PB,"Paraíba</option>
	<option value="BR-PR,"Paraná</option>
	<option value="BR-PE,"Pernambuco</option>
	<option value="BR-PI,"Piauí</option>
	<option value="BR-RJ,"Rio de Janeiro</option>
	<option value="BR-RN,"Rio Grande do Norte</option>
	<option value="BR-RS,"Rio Grande do Sul</option>
	<option value="BR-RO,"Rondônia</option>	
	<option value="BR-RR,"Roraima</option>		
	<option value="BR-SC,"Santa Catarina</option>			
	<option value="BR-SP,"São Paulo</option>
	<option value="BR-SE,"Sergipe</option>
	<option value="BR-TO,"Tocantins</option>	
</select>


List of states/federal district: CSV

----------------------------------
 Alpha-2 code + name - Portuguese
----------------------------------
code,name
AC,"Acre"
AL,"Alagoas"
AP,"Amapá"
AM,"Amazonas"
BA,"Bahia"
CE,"Ceará"
DF,"Distrito Federal"
ES,"Espírito Santo"
GO,"Goiás"
MA,"Maranhão"
MT,"Mato Grosso"
MS,"Mato Grosso do Sul"
MG,"Minas Gerais"
PA,"Pará"
PB,"Paraíba"
PR,"Paraná"
PE,"Pernambuco"
PI,"Piauí"
RJ,"Rio de Janeiro"
RN,"Rio Grande do Norte"
RS,"Rio Grande do Sul"
RO,"Rondônia"	
RR,"Roraima"		
SC,"Santa Catarina"			
SP,"São Paulo"
SE,"Sergipe"
TO,"Tocantins"

-------------------------------------
 ISO_3166-2 code + name - Portuguese
-------------------------------------
code,name
BR-AC,"Acre"
BR-AL,"Alagoas"
BR-AP,"Amapá"
BR-AM,"Amazonas"
BR-BA,"Bahia"
BR-CE,"Ceará"
BR-DF,"Distrito Federal"
BR-ES,"Espírito Santo"
BR-GO,"Goiás"
BR-MA,"Maranhão"
BR-MT,"Mato Grosso"
BR-MS,"Mato Grosso do Sul"
BR-MG,"Minas Gerais"
BR-PA,"Pará"
BR-PB,"Paraíba"
BR-PR,"Paraná"
BR-PE,"Pernambuco"
BR-PI,"Piauí"
BR-RJ,"Rio de Janeiro"
BR-RN,"Rio Grande do Norte"
BR-RS,"Rio Grande do Sul"
BR-RO,"Rondônia"	
BR-RR,"Roraima"		
BR-SC,"Santa Catarina"			
BR-SP,"São Paulo"
BR-SE,"Sergipe"
BR-TO,"Tocantins"	

List of states/federal district: JSON

-------------------------------
 Alpha-2 code + Name - English
-------------------------------
[
	{code: "AC", name: "Acre"},
	{code: "AL", name: "Alagoas"},
	{code: "AP", name: "Amapá"},			
	{code: "AM", name: "Amazonas"},
	{code: "BA", name: "Bahia"},
	{code: "CE", name: "Ceará"},
	{code: "DF", name: "Distrito Federal"},
	{code: "ES", name: "Espírito Santo"},
	{code: "GO", name: "Goiás"},
	{code: "MA", name: "Maranhão"},	
	{code: "MT", name: "Mato Grosso"},
	{code: "MS", name: "Mato Grosso do Sul"},
	{code: "MG", name: "Minas Gerais"},	
	{code: "PA", name: "Pará"},		
	{code: "PB", name: "Paraíba"},
	{code: "PR", name: "Paraná"},
	{code: "PE", name: "Pernambuco"},
	{code: "PI", name: "Piauí"},
	{code: "RJ", name: "Rio de Janeiro"},
	{code: "RN", name: "Rio Grande do Norte"},
	{code: "RS", name: "Rio Grande do Sul"},
	{code: "RO", name: "Rondônia"},
	{code: "RR", name: "Roraima"},
	{code: "SC", name: "Santa Catarina"},
	{code: "SP", name: "São Paulo"},
	{code: "SE", name: "Sergipe"},
	{code: "TO", name: "Tocantins"}
]

----------------------------------
 ISO-3166-2 code + Name - English
----------------------------------
[
	{code: "BR-AC", name: "Acre"},
	{code: "BR-AL", name: "Alagoas"},
	{code: "BR-AP", name: "Amapá"},			
	{code: "BR-AM", name: "Amazonas"},
	{code: "BR-BA", name: "Bahia"},
	{code: "BR-CE", name: "Ceará"},
	{code: "BR-DF", name: "Distrito Federal"},
	{code: "BR-ES", name: "Espírito Santo"},
	{code: "BR-GO", name: "Goiás"},
	{code: "BR-MA", name: "Maranhão"},	
	{code: "BR-MT", name: "Mato Grosso"},
	{code: "BR-MS", name: "Mato Grosso do Sul"},
	{code: "BR-MG", name: "Minas Gerais"},	
	{code: "BR-PA", name: "Pará"},		
	{code: "BR-PB", name: "Paraíba"},
	{code: "BR-PR", name: "Paraná"},
	{code: "BR-PE", name: "Pernambuco"},
	{code: "BR-PI", name: "Piauí"},
	{code: "BR-RJ", name: "Rio de Janeiro"},
	{code: "BR-RN", name: "Rio Grande do Norte"},
	{code: "BR-RS", name: "Rio Grande do Sul"},
	{code: "BR-RO", name: "Rondônia"},
	{code: "BR-RR", name: "Roraima"},
	{code: "BR-SC", name: "Santa Catarina"},
	{code: "BR-SP", name: "São Paulo"},
	{code: "BR-SE", name: "Sergipe"},
	{code: "BR-TO", name: "Tocantins"}
]

List of states/federal district: SQL

-- -----------------------------------------------------
-- Table `state`
-- -----------------------------------------------------
DROP TABLE IF EXISTS state;

CREATE TABLE IF NOT EXISTS state (
  id INT(10) UNSIGNED NOT NULL AUTO_INCREMENT,
  code VARCHAR(6) NOT NULL,
  name VARCHAR(50) NOT NULL,
  PRIMARY KEY (id),
  UNIQUE INDEX id_UNIQUE (id ASC),
  UNIQUE INDEX code_UNIQUE (code ASC)
) ENGINE = InnoDB;

-- Alpha-2
INSERT INTO state (id, code, name) VALUES (null, 'AC', 'Acre');
INSERT INTO state (id, code, name) VALUES (null, 'AL', 'Alagoas');
INSERT INTO state (id, code, name) VALUES (null, 'AP', 'Amapá');
INSERT INTO state (id, code, name) VALUES (null, 'AM', 'Amazonas');
INSERT INTO state (id, code, name) VALUES (null, 'BA', 'Bahia');
INSERT INTO state (id, code, name) VALUES (null, 'CE', 'Ceará');
INSERT INTO state (id, code, name) VALUES (null, 'DF', 'Distrito Federal');
INSERT INTO state (id, code, name) VALUES (null, 'ES', 'Espírito Santo');
INSERT INTO state (id, code, name) VALUES (null, 'GO', 'Goiás');
INSERT INTO state (id, code, name) VALUES (null, 'MA', 'Maranhão');
INSERT INTO state (id, code, name) VALUES (null, 'MT', 'Mato Grosso');
INSERT INTO state (id, code, name) VALUES (null, 'MS', 'Mato Grosso do Sul');
INSERT INTO state (id, code, name) VALUES (null, 'MG', 'Minas Gerais');
INSERT INTO state (id, code, name) VALUES (null, 'PA', 'Pará');
INSERT INTO state (id, code, name) VALUES (null, 'PB', 'Paraíba');
INSERT INTO state (id, code, name) VALUES (null, 'PR', 'Paraná');
INSERT INTO state (id, code, name) VALUES (null, 'PE', 'Pernambuco');
INSERT INTO state (id, code, name) VALUES (null, 'PI', 'Piauí');
INSERT INTO state (id, code, name) VALUES (null, 'RJ', 'Rio de Janeiro');
INSERT INTO state (id, code, name) VALUES (null, 'RN', 'Rio Grande do Norte');
INSERT INTO state (id, code, name) VALUES (null, 'RS', 'Rio Grande do Sul');
INSERT INTO state (id, code, name) VALUES (null, 'RO', 'Rondônia');
INSERT INTO state (id, code, name) VALUES (null, 'RR', 'Roraima');
INSERT INTO state (id, code, name) VALUES (null, 'SC', 'Santa Catarina');
INSERT INTO state (id, code, name) VALUES (null, 'SP', 'São Paulo');
INSERT INTO state (id, code, name) VALUES (null, 'SE', 'Sergipe');
INSERT INTO state (id, code, name) VALUES (null, 'TO', 'Tocantins');

-- ISO-3166-2 
INSERT INTO state (id, code, name) VALUES (null, 'BR-AC', 'Acre');
INSERT INTO state (id, code, name) VALUES (null, 'BR-AL', 'Alagoas');
INSERT INTO state (id, code, name) VALUES (null, 'BR-AP', 'Amapá');
INSERT INTO state (id, code, name) VALUES (null, 'BR-AM', 'Amazonas');
INSERT INTO state (id, code, name) VALUES (null, 'BR-BA', 'Bahia');
INSERT INTO state (id, code, name) VALUES (null, 'BR-CE', 'Ceará');
INSERT INTO state (id, code, name) VALUES (null, 'BR-DF', 'Distrito Federal');
INSERT INTO state (id, code, name) VALUES (null, 'BR-ES', 'Espírito Santo');
INSERT INTO state (id, code, name) VALUES (null, 'BR-GO', 'Goiás');
INSERT INTO state (id, code, name) VALUES (null, 'BR-MA', 'Maranhão');
INSERT INTO state (id, code, name) VALUES (null, 'BR-MT', 'Mato Grosso');
INSERT INTO state (id, code, name) VALUES (null, 'BR-MS', 'Mato Grosso do Sul');
INSERT INTO state (id, code, name) VALUES (null, 'BR-MG', 'Minas Gerais');
INSERT INTO state (id, code, name) VALUES (null, 'BR-PA', 'Pará');
INSERT INTO state (id, code, name) VALUES (null, 'BR-PB', 'Paraíba');
INSERT INTO state (id, code, name) VALUES (null, 'BR-PR', 'Paraná');
INSERT INTO state (id, code, name) VALUES (null, 'BR-PE', 'Pernambuco');
INSERT INTO state (id, code, name) VALUES (null, 'BR-PI', 'Piauí');
INSERT INTO state (id, code, name) VALUES (null, 'BR-RJ', 'Rio de Janeiro');
INSERT INTO state (id, code, name) VALUES (null, 'BR-RN', 'Rio Grande do Norte');
INSERT INTO state (id, code, name) VALUES (null, 'BR-RS', 'Rio Grande do Sul');
INSERT INTO state (id, code, name) VALUES (null, 'BR-RO', 'Rondônia');
INSERT INTO state (id, code, name) VALUES (null, 'BR-RR', 'Roraima');
INSERT INTO state (id, code, name) VALUES (null, 'BR-SC', 'Santa Catarina');
INSERT INTO state (id, code, name) VALUES (null, 'BR-SP', 'São Paulo');
INSERT INTO state (id, code, name) VALUES (null, 'BR-SE', 'Sergipe');
INSERT INTO state (id, code, name) VALUES (null, 'BR-TO', 'Tocantins');

List of states/federal district: XML

<!-- Alpha-2 code + name - Portuguese -->
<?xml version="1.0" encoding="UTF-8"?>
<states>
	<state>
		<code>AC</code>
		<name>Acre</name>
	</state>
	<state>
		<code>AL</code>
		<name>Alagoas</name>
	</state>
	<state>
		<code>AP</code>
		<name>Amapá</name>
	</state>
	<state>
		<code>AM</code>
		<name>Amazonas</name>
	</state>
	<state>
		<code>BA</code>
		<name>Bahia</name>
	</state>
	<state>
		<code>CE</code>
		<name>Ceará</name>
	</state>
	<state>
		<code>DF</code>
		<name>Distrito Federal</name>
	</state>
	<state>
		<code>ES</code>
		<name>Espírito Santo</name>
	</state>
	<state>
		<code>GO</code>
		<name>Goiás</name>
	</state>
	<state>
		<code>MA</code>
		<name>Maranhão</name>
	</state>
	<state>
		<code>MT</code>
		<name>Mato Grosso</name>
	</state>	
	<state>
		<code>MS</code>
		<name>Mato Grosso do Sul</name>
	</state>							
	<state>
		<code>MG</code>
		<name>Minas Gerais</name>
	</state>
	<state>
		<code>PA</code>
		<name>Pará</name>
	</state>
	<state>
		<code>PB</code>
		<name>Paraíba</name>
	</state>		
	<state>
		<code>PR</code>
		<name>Paraná</name>
	</state>
	<state>
		<code>PE</code>
		<name>Pernambuco</name>
	</state>
	<state>
		<code>PI</code>
		<name>Piauí</name>
	</state>
	<state>
		<code>RJ</code>
		<name>Rio de Janeiro</name>
	</state>
	<state>
		<code>RN</code>
		<name>Rio Grande do Norte</name>
	</state>
	<state>
		<code>RS</code>
		<name>Rio Grande do Sul</name>
	</state>
	<state>
		<code>RO</code>
		<name>Rondônia</name>
	</state>
	<state>
		<code>RR</code>
		<name>Roraima</name>
	</state>
	<state>
		<code>SC</code>
		<name>Santa Catarina</name>
	</state>
	<state>
		<code>SP</code>
		<name>São Paulo</name>
	</state>
	<state>
		<code>SE</code>
		<name>Sergipe</name>
	</state>
	<state>
		<code>TO</code>
		<name>Tocantins</name>
	</state>							
</states>

<!-- ISO 3166-2 code + name - English -->
<?xml version="1.0" encoding="UTF-8"?>
<states>
	<state>
		<code>BR-AC</code>
		<name>Acre</name>
	</state>
	<state>
		<code>BR-AL</code>
		<name>Alagoas</name>
	</state>
	<state>
		<code>BR-AP</code>
		<name>Amapá</name>
	</state>
	<state>
		<code>BR-AM</code>
		<name>Amazonas</name>
	</state>
	<state>
		<code>BR-BA</code>
		<name>Bahia</name>
	</state>
	<state>
		<code>BR-CE</code>
		<name>Ceará</name>
	</state>
	<state>
		<code>BR-DF</code>
		<name>Distrito Federal</name>
	</state>
	<state>
		<code>BR-ES</code>
		<name>Espírito Santo</name>
	</state>
	<state>
		<code>BR-GO</code>
		<name>Goiás</name>
	</state>
	<state>
		<code>BR-MA</code>
		<name>Maranhão</name>
	</state>
	<state>
		<code>BR-MT</code>
		<name>Mato Grosso</name>
	</state>	
	<state>
		<code>BR-MS</code>
		<name>Mato Grosso do Sul</name>
	</state>							
	<state>
		<code>BR-MG</code>
		<name>Minas Gerais</name>
	</state>
	<state>
		<code>BR-PA</code>
		<name>Pará</name>
	</state>
	<state>
		<code>BR-PB</code>
		<name>Paraíba</name>
	</state>		
	<state>
		<code>BR-PR</code>
		<name>Paraná</name>
	</state>
	<state>
		<code>BR-PE</code>
		<name>Pernambuco</name>
	</state>
	<state>
		<code>BR-PI</code>
		<name>Piauí</name>
	</state>
	<state>
		<code>BR-RJ</code>
		<name>Rio de Janeiro</name>
	</state>
	<state>
		<code>BR-RN</code>
		<name>Rio Grande do Norte</name>
	</state>
	<state>
		<code>BR-RS</code>
		<name>Rio Grande do Sul</name>
	</state>
	<state>
		<code>BR-RO</code>
		<name>Rondônia</name>
	</state>
	<state>
		<code>BR-RR</code>
		<name>Roraima</name>
	</state>
	<state>
		<code>BR-SC</code>
		<name>Santa Catarina</name>
	</state>
	<state>
		<code>BR-SP</code>
		<name>São Paulo</name>
	</state>
	<state>
		<code>BR-SE</code>
		<name>Sergipe</name>
	</state>
	<state>
		<code>BR-TO</code>
		<name>Tocantins</name>
	</state>							
</states>