Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła