Sammanfattning av nya uppdateringar från japansk tid för .NET Framework

Den här artikeln beskriver de nya uppdateringarna från den japanska eran för .NET Framework.

Ursprunglig produktversion: .NET Framework 3.5 och senare versioner
Ursprungligt KB-nummer: 4477957

Sammanfattning

Den 1 maj 2019 börjar den nya eran i den japanska kalendern. Microsoft förbereder för dessa ändringar och planerar att leverera uppdateringar i varje månatlig sammanslagningsversion. Detta är den första övergången från en era till en annan sedan januari 1989, och även den första i .NET Framework historia. Den här artikeln är avsedd att hjälpa utvecklare att testa och verifiera hur epoker fungerar i .NET-program, hur program påverkas av tidsändringen och vad du som utvecklare måste göra för att se till att dina program hanterar de kommande ändringarna från den japanska eran.

Mer information om Windows-uppdateringar för den japanska tidsändringen finns i KB-4469068.

.NET Framework uppdateringar

Följande versioner innehåller uppdateringar från den japanska eran för .NET Framework. De innehåller också kvalitets- och tillförlitlighetsförbättringar.

• .NET Framework september 2018 Förhandsversion av kvalitetsupplyftning
• .NET Framework november 2018 – samlad säkerhet och kvalitet
• .NET Framework december 2018 – Samlad säkerhet och kvalitet
• uppdatering .NET Framework mars 2019
• .NET Framework maj 2019 – Samlad säkerhet och kvalitet

Kunskapsbasartiklar efter .NET Framework version för uppdateringar från den japanska eran

Underhållsuppdateringarna som visas i följande tabell innehåller alla uppdateringar från den japanska eran för .NET Framework som redan fanns med i de tidigare utgivna uppdateringarna. Underhållsuppdateringarna innehåller också en ny kvalitetsuppdatering som tar bort beroendet av enkla citattecken för att mata ut Gannen-tecknet i japansk eraformatering, så att antingen "y年" eller "y'年'" av den anpassade datum- och tidsformatsträngen gör att .NET Framework kan formatera år nummer 1 till 元. Dessa uppdateringar är tillgängliga på Windows Update, Windows Server Update Service (WSUS) och Windows Update Catalog.

Microsoft släppte en sammanslagning av säkerhet och kvalitet i .NET Framework för Windows 8.1 och tidigare versioner av Windows som stöds i maj 2019 enligt nedan. Alla säkerhets- och kvalitetsuppslagningar som släpps senare till dessa uppdateringar kommer också att innehålla uppdateringar från den japanska eran.

Ändringar för kunder som endast uppdaterar säkerhet

Det här avsnittet är för kunder som förlitar sig på uppdateringar av endast säkerhet (SO) för Windows 8.1 och tidigare versioner av Windows som stöds.

I likhet med de .NET Framework uppdateringar för Windows 10 som visas i föregående avsnitt innehåller uppdateringarna som listas i följande tabell alla uppdateringar från den japanska eran för .NET Framework som redan fanns med i tidigare utgivna uppdateringar och en ny kvalitetsuppdatering för att ta bort beroendet av att använda enkla citattecken för att mata ut Gannen-tecknet i japansk eraformatering.

De här uppdateringarna innehåller inga nya säkerhetsuppdateringar eller nya ytterligare kvalitets- och tillförlitlighetsförbättringar som inte redan har inkluderats i tidigare utgivna uppdateringar, förutom uppdateringen för problemet med enkla citattecken. Därför kan användare som förlitar sig på uppdateringar av endast säkerhet (SO) och uppdateringar av månatlig sammanslagning (MO) för Windows 8.1 och tidigare versioner av Windows som stöds också välja dessa uppdateringar för den nya japanska eran. De här uppdateringarna är endast tillgängliga via Windows Server Update Service (WSUS) och Windows Update Catalog.

Testa den nya japanska eran på .NET Framework

För alla versioner av .NET Framework i knowledge base-artikeltabellen, och även för .NET Core som körs i Windows, tillhandahålls information om kalendereran av Windows-operativsystemet och hämtas från systemregistret när du tillämpar uppdateringarna för .NET Framework. För att göra det enklare för dig att förbereda dig för den japanska tidsändringen kan du styra när du lägger till platshållarregistrets post i dina system och välja den tidpunkt som uppfyller dina behov. För närvarande stöds platshållarregistret för Windows-operativsystemet för följande system:

• Windows-klient: Windows 7 SP1 och senare
• Windows Server: Windows Server 2008 R2 SP1 och senare

En uppdatering av Windows lägger till det nya era-värdet i registret när namnet på eran och namnet på den förkortade eran är kända. .NET i Windows återspeglar automatiskt den här uppdateringen.

Rekommenderade testscenarier för att täcka

• Avslappnade intervallkontroller för era

  Det här testscenariot är att verifiera att LOB-program fungerar när övergången från den nya eran är inställd på ett framtida datum.

  Ett datum i en viss era kan "flöda över" till följande era, och nej ArgumentOutOfRangeException eller FormatException genereras som standard. När du anger värdet Switch.System.Globalization.EnforceJapaneseEraYearRanges för till true kan du återställa strikta era-kontroller.

• Det första året av en era

  Det här testscenariot är att verifiera Gannen-konventionen (元年) i formateringsåtgärder som det första året i en ny japansk kalendereran.

  Som standard antar .NET Gannen-konventionen (元年) i formateringsåtgärder. Du kan återställa det tidigare beteendet. Det beteendet representerar alltid året som "1" i stället för som Gannen (元年). Det gör du genom att ange följande värde till true:

  Switch.System.Globalization.FormatJapaneseFirstYearAsANumber

Funktioner som stöds i japansk tid

• Uppdatera datakälla

  Informationen från den japanska eran behölls ursprungligen som hårdkodade data i .NET Framework 3.5 och lägre versioner av .NET Framework, men på samma sätt som .NET Framework 4.0 och senare ändrades källan för den japanska eran från privata hårdkodade data till registernyckeln under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras registersökvägen. Uppdateringen för Windows lägger till registernyckeln för den nya eran när dess namn har meddelats.

• Intervallavslappning

  När Heisei (平成) Era slutar den 30 april 2019 som är Heisei (平成) 31, och den nya eran börjar den 1 maj 2019, :::no-loc text=""平成 31 年 5 月 1 日""::: blir ogiltig. Vi har lättat på våra parsers för att tillåta att framtida eller tidigare datum (både gregorianska och japanska datum) i .NET-program konverteras till ett relevant datum för japansk era utan att utlösa ett undantag som ArgumentOutOfRangeException och System.FormatException. Du kommer också att kunna konvertera framtida datum i Heisei till den nya japanska eran när det nya japanska eranamnet tillkännages. Den kan inaktiveras i .NET Framework. Genom att ange värdet Switch.System.Globalization.EnforceJapaneseEraYearRanges för till true.

• Gannen (元年) för det första året av japansk era

  I historisk praxis används för det första året av eran ett specialtecken "Gan (元)", vars Kanji-tecken betyder "origin" eller "beginning", i stället för talet "Ichi (1)". Det första året "Gannen (元年)" fortsätter fram till slutdatumet för det gregorianska kalenderåret den 31 december. .NET Framework stöder både "Gannen (元年)" och "Ichinen (1 年)" för det första året av eran. För alla versioner av .NET Framework är Gannen PÅ som standard. Det kan inaktiveras genom att ange värdet Switch.System.Globalization.FormatJapaneseFirstYearAsANumber för till true.

Tidigare utgivna uppdateringar

Kunder behöver bara installera den senaste uppdateringen som anges ovan i knowledge base-artiklarna efter .NET Framework version för uppdateringar från japansk tid eller från Windows Update, Windows Server Update Service (WSUS) eller Windows Update Catalog.

Ytterligare resurser

• Hantera en ny era i den japanska kalendern i .NET – .NET Blog
• Använda registret för att testa den nya japanska eran i Windows – augusti 2018-bloggen
• Gannen vs Ichinen - November 2018 blogg