Skip to content

Commit c7e29db

Browse files
authored
Document JapaneseCalendar.MinSupportedDateTime breaking change in .NET 11 Preview 1 (#50920)
1 parent 95053cf commit c7e29db

File tree

4 files changed

+50
-1
lines changed

4 files changed

+50
-1
lines changed

docs/core/compatibility/11.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,3 +19,9 @@ If you're migrating an app to .NET 11, the breaking changes listed here might af
1919
| Title | Type of change |
2020
|-------------------------------------------------------------------|-------------------|
2121
| [Environment.TickCount made consistent with Windows timeout behavior](core-libraries/11/environment-tickcount-windows-behavior.md) | Behavioral change |
22+
23+
## Globalization
24+
25+
| Title | Type of change |
26+
|-------|-------------------|
27+
| [Japanese Calendar minimum supported date corrected](globalization/11/japanese-calendar-min-date.md) | Behavioral change |

docs/core/compatibility/core-libraries/11/environment-tickcount-windows-behavior.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Breaking change - Environment.TickCount made consistent with Windows timeout behavior"
2+
title: "Breaking change: Environment.TickCount made consistent with Windows timeout behavior"
33
description: "Learn about the breaking change in .NET 11 where Environment.TickCount and Environment.TickCount64 on Windows now exclude sleep and hibernation time, consistent with OS wait APIs."
44
ms.date: 01/07/2026
55
ai-usage: ai-assisted
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
title: "Breaking change: Japanese Calendar minimum supported date corrected"
3+
description: "Learn about the breaking change in .NET 11 where the Japanese Calendar minimum supported date was corrected from 1868-09-08 to 1868-10-23."
4+
ms.date: 01/07/2026
5+
ai-usage: ai-assisted
6+
---
7+
8+
# Japanese Calendar minimum supported date corrected
9+
10+
The start date of the Japanese Meiji era has been updated from `1868-09-08` to `1868-10-23` to reflect the latest Unicode Common Locale Data Repository (CLDR) data and improved historical accuracy. This date also serves as the minimum supported date in the Japanese calendar.
11+
12+
## Version introduced
13+
14+
.NET 11 Preview 1
15+
16+
## Previous behavior
17+
18+
Previously, <xref:System.Globalization.JapaneseCalendar.MinSupportedDateTime?displayProperty=nameWithType> returned `1868-09-08`. <xref:System.Globalization.JapaneseCalendar> accepted dates between `1868-09-08` and `1868-10-23` as valid.
19+
20+
## New behavior
21+
22+
Starting in .NET 11, <xref:System.Globalization.JapaneseCalendar.MinSupportedDateTime?displayProperty=nameWithType> returns `1868-10-23` instead. <xref:System.Globalization.JapaneseCalendar> now rejects dates between `1868-09-08` and `1868-10-23` as invalid.
23+
24+
## Type of breaking change
25+
26+
This change is a [behavioral change](../../categories.md#behavioral-change).
27+
28+
## Reason for change
29+
30+
The change was made to reflect the latest Unicode CLDR data ([CLDR-11375](https://unicode-org.atlassian.net/browse/CLDR-11375)) and improved historical accuracy regarding the start of the Meiji era in Japan.
31+
32+
## Recommended action
33+
34+
Update any code that depends on the old value of <xref:System.Globalization.JapaneseCalendar.MinSupportedDateTime?displayProperty=nameWithType>. Avoid using Gregorian dates before `1868-10-23` with the <xref:System.Globalization.JapaneseCalendar>.
35+
36+
## Affected APIs
37+
38+
- <xref:System.Globalization.JapaneseCalendar?displayProperty=fullName>
39+
- <xref:System.Globalization.JapaneseCalendar.MinSupportedDateTime?displayProperty=fullName>

docs/core/compatibility/toc.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,10 @@ items:
1212
items:
1313
- name: Environment.TickCount made consistent with Windows timeout behavior
1414
href: core-libraries/11/environment-tickcount-windows-behavior.md
15+
- name: Globalization
16+
items:
17+
- name: Japanese Calendar minimum supported date corrected
18+
href: globalization/11/japanese-calendar-min-date.md
1519
- name: .NET 10
1620
items:
1721
- name: Overview

0 commit comments

Comments
 (0)