CultureInfo.DateTimeFormat Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines DateTimeFormatInfo Werts, der das kulturell geeignete Format der Anzeige von Datums- und Uhrzeitangaben definiert.
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, setPublic Overridable Property DateTimeFormat As DateTimeFormatInfoEigenschaftswert
A DateTimeFormatInfo that defines the culturally appropriate format of displaying dates and times.
Ausnahmen
Die Eigenschaft ist auf NULL festgelegt.
Die DateTimeFormat Eigenschaft oder eine der DateTimeFormatInfo Eigenschaften wird festgelegt, und die CultureInfo Eigenschaft ist schreibgeschützt.
Beispiele
Das folgende Codebeispiel zeigt, dass CultureInfo.Clone auch die DateTimeFormatInfo mit der CultureInfoDatei verknüpften Instanzen NumberFormatInfo klont.
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
Hinweise
Sie können einige der Werte außer Kraft setzen, die der aktuellen Windows-Kultur zugeordnet sind, über den Bereich "Regions- und Sprachoptionen" der Systemsteuerung. Beispielsweise können Benutzer*innen das Datum in einem anderen Format anzeigen oder eine andere Währung als die Standardwährung für die Kultur verwenden.
Wenn UseUserOverridetrue ist und die benannte Kultur mit der aktuellen Kultur von Windows übereinstimmt, verwendet CultureInfo diese Außerkraftsetzungen, einschließlich der Benutzereinstellungen für die Eigenschaften der von der DateTimeFormatInfo-Eigenschaft zurückgegebenen DateTimeFormat-Instanz und der Eigenschaften der von der NumberFormatInfo-Eigenschaft zurückgegebenen NumberFormat-Instanz. Wenn die Benutzereinstellungen nicht mit der Kultur kompatibel sind, die CultureInfo zugeordnet ist (z. B. wenn der ausgewählte Kalender nicht einer der OptionalCalendars ist), werden die Ergebnisse der Methoden und die Werte der Eigenschaften nicht definiert.
Der Wert der DateTimeFormat Eigenschaft und der NumberFormat Eigenschaft wird erst berechnet, wenn ihre Anwendung auf die Eigenschaft zugreift. Wenn der Benutzer die aktuelle Kultur in eine neue Kultur ändern kann, während die Anwendung ausgeführt wird, und dann greift die Anwendung auf die oder NumberFormat die DateTimeFormat Eigenschaft zu, ruft die Anwendung die Standardwerte für die neue Kultur anstelle der Außerkraftsetzungen für die ursprüngliche Kultur ab. Um die Außerkraftsetzungen für die ursprüngliche aktuelle Kultur beizubehalten, sollte die Anwendung vor dem Ändern der aktuellen Kultur auf die und NumberFormat die DateTimeFormat Eigenschaften zugreifen.
Hinweise für Aufrufer
Wenn Calendar dies jedoch CurrentCultureTaiwanCalendar nicht auf Chinesisch (Taiwan) festgelegt ist, wird zh-TWbenannt, dann NativeCalendarName, GetEraName(Int32)und GetAbbreviatedEraName(Int32) geben Sie eine leere Zeichenfolge ("") zurück.
