Runtime configuration options for globalization

Invariant mode

• Determines whether a .NET Core app runs in globalization-invariant mode without access to culture-specific data and behavior.
• If you omit this setting, the app runs with access to cultural data. This is equivalent to setting the value to false.
• For more information, see .NET Core globalization invariant mode.

Examples

runtimeconfig.json file:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Globalization.Invariant": true
      }
   }
}

runtimeconfig.template.json file:

{
   "configProperties": {
      "System.Globalization.Invariant": true
   }
}

Project file:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <InvariantGlobalization>true</InvariantGlobalization>
  </PropertyGroup>

</Project>

Era year ranges

• Determines whether range checks for calendars that support multiple eras are relaxed or whether dates that overflow an era's date range throw an ArgumentOutOfRangeException.
• If you omit this setting, range checks are relaxed. This is equivalent to setting the value to false.
• For more information, see Calendars, eras, and date ranges: Relaxed range checks.

This configuration setting doesn't have a specific MSBuild property. However, you can add a RuntimeHostConfigurationOption MSBuild item instead. Use the runtimeconfig.json setting name as the value of the Include attribute. For an example, see MSBuild properties.

Japanese date parsing

• Determines whether a string that contains either "1" or "Gannen" as the year parses successfully or whether only "1" is supported.
• If you omit this setting, strings that contain either "1" or "Gannen" as the year parse successfully. This is equivalent to setting the value to false.
• For more information, see Represent dates in calendars with multiple eras.

This configuration setting doesn't have a specific MSBuild property. However, you can add a RuntimeHostConfigurationOption MSBuild item instead. Use the runtimeconfig.json setting name as the value of the Include attribute. For an example, see MSBuild properties.

Japanese year format

• Determines whether the first year of a Japanese calendar era is formatted as "Gannen" or as a number.
• If you omit this setting, the first year is formatted as "Gannen". This is equivalent to setting the value to false.
• For more information, see Represent dates in calendars with multiple eras.

This configuration setting doesn't have a specific MSBuild property. However, you can add a RuntimeHostConfigurationOption MSBuild item instead. Use the runtimeconfig.json setting name as the value of the Include attribute. For an example, see MSBuild properties.

NLS

• Determines whether .NET uses National Language Support (NLS) or International Components for Unicode (ICU) globalization APIs for Windows apps. .NET 5 and later versions use ICU globalization APIs by default on Windows 10 May 2019 Update and later versions.
• If you omit this setting, .NET uses ICU globalization APIs by default. This is equivalent to setting the value to false.
• For more information, see Globalization APIs use ICU libraries on Windows.

This configuration setting doesn't have a specific MSBuild property. However, you can add a RuntimeHostConfigurationOption MSBuild item instead. Use the runtimeconfig.json setting name as the value of the Include attribute. For an example, see MSBuild properties.

Predefined cultures

• Configures whether apps can create cultures other than the invariant culture when globalization-invariant mode is enabled.
• If you omit this setting, .NET restricts the creation of cultures in globalization-invariant mode. This is equivalent to setting the value to true.
• For more information, see Culture creation and case mapping in globalization-invariant mode.