KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

CultureInfo — cultuur voor opmaak en parsing

System.Globalization.CultureInfo beschrijft cultuurregels die onder meer worden gebruikt voor het opmaken en parsen van getallen en datums. Door een cultuur expliciet mee te geven, scheid je presentatie voor gebruikers van stabiele tekstuele gegevensopslag.

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

Syntax

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

System.Globalization.CultureInfo vertegenwoordigt een cultuur: een verzameling regels die bij een taal en regio horen. De klasse implementeert IFormatProvider en kan daarom worden meegegeven aan geschikte overbelastingen van ToString en Parse. Veel overbelastingen zonder expliciete provider gebruiken CultureInfo.CurrentCulture; het resultaat kan daardoor afhangen van de omgeving van de gebruiker.

CultureInfo.NumberFormat biedt toegang tot NumberFormatInfo: decimale en groeperingstekens en regels voor getallen, valuta en percentages. CultureInfo.DateTimeFormat biedt toegang tot DateTimeFormatInfo: datum- en tijdpatronen, namen van maanden en dagen en kalenderinstellingen. Dit zijn instellingenobjecten, geen opgemaakte tekenreeksen. Je kunt ze ook rechtstreeks als providers voor de bijbehorende bewerkingen meegeven.

CultureInfo.InvariantCulture is onafhankelijk van een bepaald land en van gebruikersinstellingen. Deze cultuur is geschikt voor een stabiel, afgesproken tekstformaat; kies voor presentatie aan mensen de passende gebruikerscultuur. Een cultuur alleen definieert geen volledig uitwisselingsformaat: leg ook het patroon en de parsingregels vast. Gegevens van regionale culturen kunnen verschillen tussen platforms en updates.

CultureInfo.InvariantCulture is alleen-lezen. Een poging om NumberFormat, DateTimeFormat of de bijbehorende instellingen te wijzigen, veroorzaakt InvalidOperationException. Gebruik (CultureInfo)CultureInfo.InvariantCulture.Clone() om instellingen aan te passen; de kloon bevat ook kopieën van beide opmaakobjecten.

Het voorbeeld gebruikt beide providers expliciet. F2 levert twee decimalen zonder groepering op, terwijl yyyy-MM-dd de volgorde van de datumonderdelen vastlegt. De code is bedoeld voor .NET 10 en vereist geen taalfuncties uit de preview-versie.

Voorbeelden

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

Resultaat

1234.50
2026-02-03
.

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen