Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

CultureInfo — kultura pro formátování a parsování

System.Globalization.CultureInfo popisuje kulturní pravidla používaná mimo jiné pro formátování a parsování čísel a dat. Výslovným předáním kultury lze oddělit prezentaci pro uživatele od stabilního textového ukládání dat.

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

Syntaxe

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

System.Globalization.CultureInfo představuje kulturu, tedy soubor pravidel spojených s jazykem a oblastí. Implementuje IFormatProvider, takže ji lze předat vhodným přetížením ToString a Parse. Mnohá přetížení bez výslovného poskytovatele používají CultureInfo.CurrentCulture; výsledek pak může záviset na prostředí uživatele.

CultureInfo.NumberFormat zpřístupňuje NumberFormatInfo: desetinné a skupinové oddělovače a pravidla pro čísla, měny a procenta. CultureInfo.DateTimeFormat zpřístupňuje DateTimeFormatInfo: vzory data a času, názvy měsíců a dnů a nastavení kalendáře. Jde o objekty s nastavením, nikoli o zformátované řetězce. Lze je také přímo předat jako poskytovatele odpovídajících operací.

CultureInfo.InvariantCulture nezávisí na konkrétní zemi ani na uživatelském nastavení. Hodí se pro stabilní, dohodnutý textový formát; pro prezentaci lidem zvolte odpovídající kulturu uživatele. Samotná kultura nedefinuje úplný výměnný formát: určete také vzor a pravidla parsování. Údaje regionálních kultur se mohou lišit mezi platformami a aktualizacemi.

CultureInfo.InvariantCulture je pouze pro čtení. Pokus o změnu NumberFormat, DateTimeFormat nebo jejich nastavení vyvolá InvalidOperationException. Chcete-li nastavení přizpůsobit, použijte (CultureInfo)CultureInfo.InvariantCulture.Clone(); klon obsahuje také kopie obou formátovacích objektů.

Příklad výslovně používá oba poskytovatele. F2 vytvoří dvě desetinná místa bez seskupování, zatímco yyyy-MM-dd určuje pořadí částí data. Kód cílí na .NET 10 a nevyžaduje jazykové funkce ve verzi preview.

Příklady

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);

Výsledek

1234.50
2026-02-03
.

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje