CultureInfo.DateTimeFormat Eigenschap

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

Waarde van eigenschap

Een DateTimeFormatInfo die de cultureel geschikte notatie definieert voor het weergeven van datums en tijden.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u dat CultureInfo.Clone ook de DateTimeFormatInfo en NumberFormatInfo instanties kloont die zijn gekoppeld aan de 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

Opmerkingen

U kunt ervoor kiezen om een aantal waarden te overschrijven die zijn gekoppeld aan de huidige cultuur van Windows via het gedeelte met land- en taalopties van Configuratiescherm. De gebruiker kan er bijvoorbeeld voor kiezen om de datum in een andere notatie weer te geven of een andere valuta te gebruiken dan de standaardwaarde voor de cultuur.

Als UseUserOverridetrue is en de opgegeven cultuur overeenkomt met de huidige cultuur van Windows, gebruikt CultureInfo die overschrijvingen, inclusief gebruikersinstellingen voor de eigenschappen van het DateTimeFormatInfo-exemplaar dat door de DateTimeFormat-eigenschap wordt geretourneerd en de eigenschappen van het NumberFormatInfo-exemplaar dat door de NumberFormat-eigenschap wordt geretourneerd. Als de gebruikersinstellingen niet compatibel zijn met de cultuur die is geassocieerd met de CultureInfo, bijvoorbeeld als de geselecteerde kalender niet een van de OptionalCalendars is, dan zijn de resultaten van de methoden en de waarden van de eigenschappen niet gedefinieerd.

De waarde van de DateTimeFormat eigenschap en de NumberFormat eigenschap wordt pas berekend wanneer uw toepassing toegang heeft tot de eigenschap. Als de gebruiker de huidige cultuur kan wijzigen in een nieuwe cultuur terwijl de toepassing wordt uitgevoerd en vervolgens de toepassing toegang heeft tot de DateTimeFormat of NumberFormat eigenschap, haalt de toepassing de standaardwaarden voor de nieuwe cultuur op in plaats van de onderdrukkingen voor de oorspronkelijke cultuur. Als u de onderdrukkingen voor de oorspronkelijke huidige cultuur wilt behouden, moet de toepassing toegang krijgen tot de DateTimeFormat en NumberFormat eigenschappen voordat de huidige cultuur wordt gewijzigd.

Notities voor bellers

Als Calendar de TaiwanCalendar maar CurrentCulture is niet ingesteld op Chinees (Taiwan), met de naam zh-TW, dan NativeCalendarName, GetEraName(Int32)en GetAbbreviatedEraName(Int32) retourneer een lege tekenreeks ("").

Zie ook

• DateTimeFormatInfo
• GetFormat(Type)
• NumberFormat