CKTIS / C#
CultureInfo — kultura formatowania i parsowania
System.Globalization.CultureInfo opisuje reguły kulturowe używane między innymi do formatowania i parsowania liczb oraz dat. Jawnie przekazana kultura pozwala oddzielić prezentację dla użytkownika od stabilnego zapisu danych.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
CultureInfo culture = CultureInfo.InvariantCulture;
NumberFormatInfo numbers = culture.NumberFormat;
DateTimeFormatInfo dates = culture.DateTimeFormat;System.Globalization.CultureInfo reprezentuje kulturę, czyli zestaw reguł związanych z językiem i regionem. Implementuje IFormatProvider, więc można przekazywać ją do odpowiednich przeciążeń ToString i Parse. Wiele przeciążeń bez jawnego dostawcy używa CultureInfo.CurrentCulture; wynik może wtedy zależeć od środowiska użytkownika.
CultureInfo.NumberFormat udostępnia NumberFormatInfo: separatory dziesiętne i grupowania oraz reguły liczb, walut i procentów. CultureInfo.DateTimeFormat udostępnia DateTimeFormatInfo: wzorce dat i godzin, nazwy miesięcy i dni oraz ustawienia kalendarza. Są to obiekty ustawień, a nie sformatowane napisy. Można je również przekazywać bezpośrednio jako dostawców odpowiednich operacji.
CultureInfo.InvariantCulture jest niezależna od konkretnego kraju i ustawień użytkownika. Nadaje się do stabilnego, uzgodnionego formatu tekstowego; do prezentacji dla człowieka wybierz właściwą kulturę użytkownika. Sama kultura nie definiuje kompletnego formatu wymiany: określ także wzorzec i zasady parsowania. Dane kultur regionalnych mogą różnić się między platformami i aktualizacjami.
CultureInfo.InvariantCulture jest tylko do odczytu. Próba zmiany jej NumberFormat, DateTimeFormat lub ich ustawień powoduje InvalidOperationException. Aby dostosować ustawienia, użyj (CultureInfo)CultureInfo.InvariantCulture.Clone(); klon zawiera również kopie obu obiektów formatowania.
Przykład jawnie używa obu dostawców. F2 daje dwie cyfry po separatorze dziesiętnym bez grupowania, a yyyy-MM-dd ustala kolejność składników daty. Kod jest przeznaczony dla .NET 10 i nie wymaga funkcji języka w wersji preview.
Przykłady
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);Wynik
1234.50 2026-02-03 .
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.