CKTIS / C#
NumberFormatInfo — reglas de formato numérico
NumberFormatInfo proporciona reglas para dar formato y analizar números, incluidos los separadores y los símbolos de moneda. Aprende sus métodos principales, la diferencia entre la configuración actual y la invariable, y cómo crear de forma segura una configuración personalizada.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
string text = value.ToString("N2", nfi);
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);NumberFormatInfo de System.Globalization es un IFormatProvider para dar formato y analizar números. Pásalo a métodos como decimal.ToString y decimal.Parse; no expone por sí mismo un método Parse ni un método numérico ToString. NumberDecimalSeparator y NumberGroupSeparator controlan el formato numérico; las monedas y los porcentajes tienen propiedades independientes.
Los métodos principales de NumberFormatInfo que se presentan en el curso son GetInstance, GetFormat, Clone y ReadOnly. GetInstance(provider) obtiene la configuración del proveedor y recurre a la cultura actual si no puede obtenerla. No garantiza una copia editable. GetFormat(typeof(NumberFormatInfo)) devuelve el objeto actual; para otro tipo devuelve null.
Clone() devuelve una copia modificable como object, por lo que se necesita una conversión de tipo. ReadOnly(nfi) devuelve un objeto de solo lectura: usa la referencia devuelta. IsReadOnly indica este estado; intentar cambiar una propiedad de ese objeto produce InvalidOperationException. ReadOnly(null) produce ArgumentNullException.
CurrentInfo depende de la cultura actual. Si asignas un clon modificable de una cultura a CultureInfo.CurrentCulture, CurrentInfo puede devolver el objeto NumberFormatInfo modificable de ese clon. InvariantInfo proporciona reglas independientes de la cultura y es de solo lectura. El ejemplo clona InvariantInfo, establece los separadores y usa "N2" para agrupar con dos decimales. El análisis utiliza las mismas reglas junto con NumberStyles.Number. El código está dirigido a net10.0 y no requiere características del lenguaje en vista previa.
Ejemplos
using System;
using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
nfi.NumberDecimalSeparator = ",";
nfi.NumberGroupSeparator = "_";
nfi.NumberGroupSizes = new[] { 3 };
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);
string text = 12345.67m.ToString("N2", frozen);
Console.WriteLine(text);
decimal parsed = decimal.Parse(text, NumberStyles.Number, frozen);
Console.WriteLine(parsed.ToString("F2", CultureInfo.InvariantCulture));
Console.WriteLine(frozen.IsReadOnly);Resultado
12_345,67 12345.67 True
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.
Fuentes
- NumberFormatInfo Class (System.Globalization) | Microsoft Learn
- NumberFormatInfo.GetInstance(IFormatProvider) Method (System.Globalization) | Microsoft Learn
- NumberFormatInfo.GetFormat(Type) Method (System.Globalization) | Microsoft Learn
- NumberFormatInfo.Clone Method (System.Globalization) | Microsoft Learn
- NumberFormatInfo.ReadOnly(NumberFormatInfo) Method (System.Globalization) | Microsoft Learn