CultureInfo.DateTimeFormat Vlastnost

Definice

Obor názvů:

System.Globalization

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

CultureInfo.cs

Získá nebo nastaví DateTimeFormatInfo , který definuje kulturně vhodný formát zobrazení kalendářních dat a časů.

public:
 virtual property System::Globalization::DateTimeFormatInfo ^ DateTimeFormat { System::Globalization::DateTimeFormatInfo ^ get(); void set(System::Globalization::DateTimeFormatInfo ^ value); };

public virtual System.Globalization.DateTimeFormatInfo DateTimeFormat { get; set; }

member this.DateTimeFormat : System.Globalization.DateTimeFormatInfo with get, set

Public Overridable Property DateTimeFormat As DateTimeFormatInfo

Hodnota vlastnosti

DateTimeFormatInfo

A DateTimeFormatInfo , která definuje kulturně vhodný formát zobrazení dat a časů.

Výjimky

ArgumentNullException

Vlastnost je nastavena na hodnotu null.

InvalidOperationException

Vlastnost DateTimeFormat nebo jakákoli vlastnost DateTimeFormatInfo je nastavena a CultureInfo je určena jen pro čtení.

Příklady

Následující příklad kódu ukazuje, že CultureInfo.Clone také klonuje DateTimeFormatInfo a NumberFormatInfo instance přidružené k CultureInfo.

using System;
using System.Globalization;

public class SamplesCultureInfo  {

   public static void Main()  {

      // Creates and initializes a CultureInfo.
      CultureInfo myCI = new CultureInfo("en-US", false);

      // Clones myCI and modifies the DTFI and NFI instances associated with the clone.
      CultureInfo myCIclone = (CultureInfo) myCI.Clone();
      myCIclone.DateTimeFormat.AMDesignator = "a.m.";
      myCIclone.DateTimeFormat.DateSeparator = "-";
      myCIclone.NumberFormat.CurrencySymbol = "USD";
      myCIclone.NumberFormat.NumberDecimalDigits = 4;

      // Displays the properties of the DTFI and NFI instances associated with the original and with the clone.
      Console.WriteLine( "DTFI/NFI PROPERTY\tORIGINAL\tMODIFIED CLONE" );
      Console.WriteLine( "DTFI.AMDesignator\t{0}\t\t{1}", myCI.DateTimeFormat.AMDesignator, myCIclone.DateTimeFormat.AMDesignator );
      Console.WriteLine( "DTFI.DateSeparator\t{0}\t\t{1}", myCI.DateTimeFormat.DateSeparator, myCIclone.DateTimeFormat.DateSeparator );
      Console.WriteLine( "NFI.CurrencySymbol\t{0}\t\t{1}", myCI.NumberFormat.CurrencySymbol, myCIclone.NumberFormat.CurrencySymbol );
      Console.WriteLine( "NFI.NumberDecimalDigits\t{0}\t\t{1}", myCI.NumberFormat.NumberDecimalDigits, myCIclone.NumberFormat.NumberDecimalDigits );
   }
}

/*
This code produces the following output.

DTFI/NFI PROPERTY       ORIGINAL        MODIFIED CLONE
DTFI.AMDesignator       AM              a.m.
DTFI.DateSeparator      /               -
NFI.CurrencySymbol      $               USD
NFI.NumberDecimalDigits 2               4

*/

Imports System.Globalization


Public Class SamplesCultureInfo
   
   Public Shared Sub Main()
      
      ' Creates and initializes a CultureInfo.
      Dim myCI As New CultureInfo("en-US", False)
      
      ' Clones myCI and modifies the DTFI and NFI instances associated with the clone.
      Dim myCIclone As CultureInfo = CType(myCI.Clone(), CultureInfo)
      myCIclone.DateTimeFormat.AMDesignator = "a.m."
      myCIclone.DateTimeFormat.DateSeparator = "-"
      myCIclone.NumberFormat.CurrencySymbol = "USD"
      myCIclone.NumberFormat.NumberDecimalDigits = 4
      
      ' Displays the properties of the DTFI and NFI instances associated with the original and with the clone. 
      Console.WriteLine("DTFI/NFI PROPERTY" + ControlChars.Tab + "ORIGINAL" + ControlChars.Tab + "MODIFIED CLONE")
      Console.WriteLine("DTFI.AMDesignator" + ControlChars.Tab + "{0}" + ControlChars.Tab + ControlChars.Tab + "{1}", myCI.DateTimeFormat.AMDesignator, myCIclone.DateTimeFormat.AMDesignator)
      Console.WriteLine("DTFI.DateSeparator" + ControlChars.Tab + "{0}" + ControlChars.Tab + ControlChars.Tab + "{1}", myCI.DateTimeFormat.DateSeparator, myCIclone.DateTimeFormat.DateSeparator)
      Console.WriteLine("NFI.CurrencySymbol" + ControlChars.Tab + "{0}" + ControlChars.Tab + ControlChars.Tab + "{1}", myCI.NumberFormat.CurrencySymbol, myCIclone.NumberFormat.CurrencySymbol)
      Console.WriteLine("NFI.NumberDecimalDigits" + ControlChars.Tab + "{0}" + ControlChars.Tab + ControlChars.Tab + "{1}", myCI.NumberFormat.NumberDecimalDigits, myCIclone.NumberFormat.NumberDecimalDigits)

   End Sub

End Class


' This code produces the following output.
'
' DTFI/NFI PROPERTY       ORIGINAL        MODIFIED CLONE
' DTFI.AMDesignator       AM              a.m.
' DTFI.DateSeparator      /               -
' NFI.CurrencySymbol      $               USD
' NFI.NumberDecimalDigits 2               4

Poznámky

Některé hodnoty spojené s aktuální jazykovou verzí Systému Windows můžete přepsat prostřednictvím části Místní a jazykové možnosti v Ovládacích panelech. Uživatel se může rozhodnout zobrazit datum v jiném formátu nebo použít jinou měnu než výchozí pro danou kulturu.

Pokud UseUserOverride je true a zadaná jazyková verze odpovídá aktuální jazykové verzi systému Windows, CultureInfo použije tato přepsání, včetně nastavení DateTimeFormatInfo uživatelem pro vlastnosti instance vrácené vlastností DateTimeFormat, a pro vlastnosti instance vrácené vlastností NumberFormatInfo. Pokud jsou uživatelská nastavení nekompatibilní s jazykovou verzí přidruženou k CultureInfo, například pokud vybraný kalendář není jedním ze OptionalCalendars, výsledky metod a hodnoty vlastností nejsou definovány.

Hodnota DateTimeFormat vlastnosti a NumberFormat vlastnosti se nevypočítá, dokud aplikace nebude k této vlastnosti přistupovat. Pokud uživatel může změnit aktuální jazykovou verzi na novou jazykovou verzi, když je aplikace spuštěná a pak aplikace přistupuje k DateTimeFormat této nebo NumberFormat vlastnosti, aplikace načte výchozí hodnoty pro novou jazykovou verzi místo přepsání původní jazykové verze. Pokud chcete zachovat přepsání pro původní aktuální jazykovou verzi, měla by aplikace před změnou aktuální jazykové verze přistupovat k DateTimeFormat vlastnostem a NumberFormat vlastnostem.

Poznámky pro volající

Pokud Calendar je hodnota, která není nastavená na čínštinu TaiwanCalendarCurrentCulture (Tchaj-wan), pojmenovaná zh-TW, pak NativeCalendarNameGetEraName(Int32)a GetAbbreviatedEraName(Int32) vrátí prázdný řetězec ("").

Viz také

• DateTimeFormatInfo
• GetFormat(Type)
• NumberFormat