Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

CultureInfo — cultura per formattazione e analisi

System.Globalization.CultureInfo descrive le regole culturali usate, tra le altre cose, per formattare e analizzare numeri e date. Passare esplicitamente una cultura permette di separare la presentazione rivolta all’utente dalla memorizzazione stabile di dati testuali.

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

Sintassi

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

System.Globalization.CultureInfo rappresenta una cultura, cioè un insieme di regole associate a una lingua e a una regione. Implementa IFormatProvider, quindi può essere passata agli overload appropriati di ToString e Parse. Molti overload senza un provider esplicito usano CultureInfo.CurrentCulture; il risultato può quindi dipendere dall’ambiente dell’utente.

CultureInfo.NumberFormat espone NumberFormatInfo: separatori decimali e delle cifre raggruppate, oltre alle regole per numeri, valute e percentuali. CultureInfo.DateTimeFormat espone DateTimeFormatInfo: schemi di data e ora, nomi di mesi e giorni e impostazioni del calendario. Sono oggetti di impostazioni, non stringhe formattate. È possibile passarli direttamente anche come provider per le operazioni corrispondenti.

CultureInfo.InvariantCulture è indipendente da un paese specifico e dalle impostazioni dell’utente. È adatta a un formato testuale stabile e concordato; per la presentazione rivolta alle persone, scegli la cultura appropriata dell’utente. La cultura da sola non definisce un formato di interscambio completo: specifica anche lo schema e le regole di analisi. I dati delle culture regionali possono variare tra piattaforme e aggiornamenti.

CultureInfo.InvariantCulture è di sola lettura. Un tentativo di modificare NumberFormat, DateTimeFormat o le relative impostazioni genera InvalidOperationException. Per personalizzare le impostazioni, usa (CultureInfo)CultureInfo.InvariantCulture.Clone(); il clone contiene anche copie di entrambi gli oggetti di formattazione.

L’esempio usa esplicitamente entrambi i provider. F2 produce due cifre decimali senza raggruppamento, mentre yyyy-MM-dd stabilisce l’ordine dei componenti della data. Il codice è destinato a .NET 10 e non richiede funzionalità del linguaggio in versione preview.

Esempi

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

Risultato

1234.50
2026-02-03
.

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti