Decimal spec

[DrusTheAxe]

Spec for decimal support

[ptorr-msft]

For comment in meeting invite around ToString -- consider leveraging ICU. It's been in the OS since RS5 or something and is the preferred cross-platform way of doing i18n. Not sure how well it maps to WinRT anymore; Ron or Axel would know (if they haven't forgotten LOL).

[idigdoug]

S

Lots of our APIs tend to use CurrentLocale for the simply-named method, and make the InvariantLocale the long-named method (e.g. C#). While I wish it were the other way around, I'm hesitant to go against this precedent.

[jonwis]

For parsing, https://learn.microsoft.com/en-us/dotnet/api/system.decimal.tostring?view=net-9.0&redirectedfrom=MSDN#System_Decimal_ToString_System_String_ FromString has overloads for (string) and (string, IFormatProvider). That follows our usual rule of adding overload parameters after the base parameter list.

For formatting, C# goes the other way https://learn.microsoft.com/en-us/dotnet/api/system.decimal.tostring?view=net-9.0 and says that there's a four-way overload, with IFormatProvider being first.

[DrusTheAxe]

RECOMMEND:

• ToString()
• ToStringInvariant()
• ToStringWithLocale(string localeName)

RECOMMEND: DON'T overload ToString to avoid potential confusion by developers expecting parameter isn't a locale name

[DrusTheAxe]

RECOMMEND: Ping Globalization owner about this

[jonwis]

For parsing, https://learn.microsoft.com/en-us/dotnet/api/system.decimal.tostring?view=net-9.0&redirectedfrom=MSDN#System_Decimal_ToString_System_String_ FromString has overloads for (string) and (string, IFormatProvider). That follows our usual rule of adding overload parameters after the base parameter list.

For formatting, C# goes the other way https://learn.microsoft.com/en-us/dotnet/api/system.decimal.tostring?view=net-9.0 and says that there's a four-way overload, with IFormatProvider being first.

[sylveon]

I'd still suggest renaming DecimalValue to just Decimal now that the name is not used by the runtime class anymore.