Formatação Sensível à Localidade
Formate números, datas e moedas de acordo com a localidade.
Formatação Sensível à Localidade é uma aula grátis de Swift Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Swift Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Swift Academy inclui 4 aulas no total.
Os números não são universais
O número um milhão e duzentos mil é escrito como 1,200,000.50 nos US, 1.200.000,50 na Alemanha e 12,00,000.50 na Índia. Codificar separadores ou formatos diretamente causa problemas na maior parte do mundo. A API FormatStyle do Swift trata isso corretamente para cada localidade.
import Foundation
let value = 1_200_000.5
print(value.formatted()) // uses current localeO ponto de entrada formatted()
A maioria dos tipos padrão — números, datas, medidas e listas — tem um método formatted(). Sem argumentos, ele usa padrões adequados à localidade; passe um estilo para personalizá-lo.
import Foundation
let n = 1234.567
print(n.formatted()) // default
print(n.formatted(.number.precision(.fractionLength(2))))Estilos de números
.number é a opção mais versátil. Você pode configurar agrupamento, quantidade de casas fracionárias, arredondamento e exibição do sinal de forma encadeada. A localidade ainda controla os caracteres separadores usados.
import Foundation
let x = 1234.5
print(x.formatted(
.number
.grouping(.automatic)
.precision(.fractionLength(0...2))))Formatação de moedas
Para valores monetários, .currency(code:) posiciona corretamente o símbolo, o agrupamento e as casas decimais conforme a localidade. O mesmo valor pode ser exibido como $1,200.00 ou 1.200,00 €€ dependendo da região do usuário — nunca monte textos de moeda manualmente.
import Foundation
let price = 1200.0
print(price.formatted(.currency(code: "USD")))
print(price.formatted(.currency(code: "EUR")))
print(price.formatted(.currency(code: "JPY")))Formatação de porcentagens
.percent multiplica por 100 e acrescenta o sinal de porcentagem da localidade, tratando também as regras de espaçamento que alguns idiomas exigem entre o número e o símbolo.
import Foundation
let ratio = 0.875
print(ratio.formatted(.percent))
print(ratio.formatted(.percent.precision(.fractionLength(1))))Substituindo a localidade
Por padrão, a formatação usa Locale.current. Para forçar uma localidade específica — durante testes ou para mostrar um valor em uma região fixa — encadeie .locale(_:) a qualquer estilo.
import Foundation
let value = 1234567.89
let german = Locale(identifier: "de_DE")
print(value.formatted(.number.locale(german)))
// 1.234.567,89Formatação de datas
As datas têm seus próprios estilos. .dateTime permite compor os campos desejados — ano, mês, dia e hora — e o sistema os ordena conforme a localidade: mês-dia-ano nos US e dia-mês-ano em grande parte da Europa.
import Foundation
let now = Date()
print(now.formatted(
.dateTime.year().month().day()))
print(now.formatted(date: .long, time: .shortened))Datas relativas
RelativeDateTimeFormatter e o estilo .relative produzem expressões como “há 2 horas” ou “em 3 dias”, totalmente traduzidas. São excelentes para feeds e registros de data e hora.
import Foundation
let past = Date().addingTimeInterval(-3600)
let text = past.formatted(
.relative(presentation: .named))
print(text) // e.g. "1 hour ago"Medidas e unidades
Measurement formata grandezas físicas e pode converter unidades. A localidade decide se deve mostrar quilômetros ou milhas, e o estilo localiza o próprio nome da unidade.
import Foundation
let distance = Measurement(value: 5, unit: UnitLength.kilometers)
print(distance.formatted())
print(distance.formatted(
.measurement(width: .wide)))Listas e nomes
Até mesmo a junção de itens respeita o idioma. .list(type:) produz “maçãs, laranjas e peras” em inglês e usa a conjunção e os separadores corretos em outros idiomas — evite inserir vírgulas e a palavra “e” manualmente.
import Foundation
let fruits = ["apples", "oranges", "pears"]
print(fruits.formatted(.list(type: .and)))
print(fruits.formatted(.list(type: .or)))Convertendo de volta
Os FormatStyles são reversíveis. O parseStrategy de um estilo, ou a inicialização de um valor a partir de um texto com esse estilo, converte o texto localizado de volta em um número ou uma data, respeitando as mesmas regras de localidade.
import Foundation
let style = Decimal.FormatStyle.Currency(code: "USD")
let amount = try? Decimal("$1,234.50", format: style)
print(amount ?? 0)Verificação rápida
Relembre a ferramenta certa para valores monetários.
Recapitulação
Você aprendeu a formatação sensível à localidade por meio de FormatStyle:
formatted()fornece padrões corretos para a localidade; passe um estilo para personalizá-los..number,.currency(code:),.percent,.dateTime,.relative,.measuremente.listatendem à maioria das necessidades.- Encadeie
.locale(_:)para substituir a região; os estilos também podem analisar textos e convertê-los de volta. - Nunca crie manualmente separadores, símbolos de moeda ou ordens de data.
Perguntas Frequentes
A aula “Formatação Sensível à Localidade” é grátis?
Sim — o texto completo de “Formatação Sensível à Localidade” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Swift Academy, atualize para CoddyKit PRO. O curso de Swift Academy inclui 4 aulas no total.
O que vou aprender em “Formatação Sensível à Localidade”?
Formate números, datas e moedas de acordo com a localidade. Você pratica Swift Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Swift Academy?
Nenhuma experiência prévia é necessária. Swift Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Formatação Sensível à Localidade”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Swift Academy?
Sim. Cada aula de Swift Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Catálogos de Strings e Strings Localizadas
- Pluralização e Stringsdict
- Formatação Sensível à Localidade
- Direita para Esquerda e Direção do Layout