DateTimeFormatInfo.ShortestDayNames does not return "unique" abbreviated day names.

[DarkFormat]

Type of issue

Other (describe below)

Description

The Example in https://learn.microsoft.com/en-us/dotnet/api/system.globalization.datetimeformatinfo.shortestdaynames?view=net-9.0#examples showcases the issue outlined in the title.

Particularly:

/*
[...]

ShortestDayNames...
"S"
"M"
"T"
"W"
"T"
"F"
"S"

*/

If the property ShortestDayNames on DateTimeFormatInfo did return unique abbreviated day names, I'd expect something like:

[ "Su", "M", "Tu", "W", "Th", "F", "Sa" ]

I'm unsure if this is a documentation issue, an example issue or an actual implementation issue.

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.globalization.datetimeformatinfo.shortestdaynames?view=net-9.0#system-globalization-datetimeformatinfo-shortestdaynames

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Globalization/DateTimeFormatInfo.xml

Document Version Independent Id

ac70c383-1491-4dd4-b578-e74874a8de18

Platform Id

05b22cad-3ee9-7f84-35c9-539841b564bc

Article author

@dotnet-bot

[dotnet-policy-service]

Tagging subscribers to this area: @dotnet/area-system-globalization

[tarekgh]

This is a documentation issue. According to the Unicode CLDR, the shortest day names are defined as a single character. See: https://github.com/unicode-org/cldr/blob/6a57fe5413950e6ed03042de179856c47074a28d/common/main/en.xml#L2526.

The format [ "Su", "M", "Tu", "W", "Th", "F", "Sa" ] represents the short form, but not the shortest, despite what the property name suggests.

We may fix the docs removing the the word unique, and in the future, we may support providing API return the short-day names.