Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

CultureInfo — cultura para formatação e análise

System.Globalization.CultureInfo descreve regras culturais utilizadas, entre outras tarefas, para formatar e analisar números e datas. Passar uma cultura explicitamente permite separar a apresentação destinada ao utilizador do armazenamento estável de dados textuais.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

CultureInfo culture = CultureInfo.InvariantCulture;
NumberFormatInfo numbers = culture.NumberFormat;
DateTimeFormatInfo dates = culture.DateTimeFormat;

System.Globalization.CultureInfo representa uma cultura, ou seja, um conjunto de regras associado a uma língua e a uma região. Implementa IFormatProvider, pelo que pode ser passada às sobrecargas adequadas de ToString e Parse. Muitas sobrecargas sem um fornecedor explícito utilizam CultureInfo.CurrentCulture; por isso, o resultado pode depender do ambiente do utilizador.

CultureInfo.NumberFormat expõe NumberFormatInfo: separadores decimais e de agrupamento, bem como regras para números, moedas e percentagens. CultureInfo.DateTimeFormat expõe DateTimeFormatInfo: padrões de data e hora, nomes dos meses e dos dias e definições do calendário. São objetos de definições, não cadeias formatadas. Também podem ser passados diretamente como fornecedores para as operações correspondentes.

CultureInfo.InvariantCulture é independente de um país específico e das definições do utilizador. É adequada para um formato textual estável e acordado; para apresentação destinada a pessoas, escolha a cultura apropriada do utilizador. A cultura, por si só, não define um formato de intercâmbio completo: especifique também o padrão e as regras de análise. Os dados das culturas regionais podem variar entre plataformas e atualizações.

CultureInfo.InvariantCulture é só de leitura. Tentar alterar NumberFormat, DateTimeFormat ou as respetivas definições provoca InvalidOperationException. Para personalizar as definições, utilize (CultureInfo)CultureInfo.InvariantCulture.Clone(); o clone também contém cópias de ambos os objetos de formatação.

O exemplo utiliza explicitamente ambos os fornecedores. F2 produz duas casas decimais sem agrupamento, enquanto yyyy-MM-dd fixa a ordem dos componentes da data. O código destina-se ao .NET 10 e não requer funcionalidades da linguagem em versão preview.

Exemplos

using System;
using System.Globalization;

CultureInfo culture = CultureInfo.InvariantCulture;
NumberFormatInfo numbers = culture.NumberFormat;
DateTimeFormatInfo dates = culture.DateTimeFormat;

decimal amount = decimal.Parse("1234.50", numbers);
DateTime date = new DateTime(2026, 2, 3);

Console.WriteLine(amount.ToString("F2", numbers));
Console.WriteLine(date.ToString("yyyy-MM-dd", dates));
Console.WriteLine(numbers.NumberDecimalSeparator);

Resultado

1234.50
2026-02-03
.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes