CultureInfo.DateTimeFormat Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Globalization
Bütünleştirilmiş Kod:
System.Globalization.dll
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs

Tarih ve saat görüntülemenin kültürel olarak uygun biçimini tanımlayan bir DateTimeFormatInfo alır veya ayarlar.

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

Özellik Değeri

DateTimeFormatInfo

DateTimeFormatInfo Tarih ve saatleri görüntülemenin kültürel olarak uygun biçimini tanımlayan bir.

Özel durumlar

ArgumentNullException

özelliği null olarak ayarlanır.

InvalidOperationException

DateTimeFormat özelliği veya özelliklerin DateTimeFormatInfo herhangi biri ayarlanır ve CultureInfo salt okunurdur.

Örnekler

Aşağıdaki kod örneği CultureInfo.Clone dosyasının DateTimeFormatInfo ile ilişkilendirilmiş ve NumberFormatInfo örneklerini de kopyalayıp kopyalamadığını CultureInfogösterir.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Creates and initializes a CultureInfo.
   CultureInfo^ myCI = gcnew CultureInfo( "en-US",false );
   
   // Clones myCI and modifies the DTFI and NFI instances associated with the clone.
   CultureInfo^ myCIclone = dynamic_cast<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
*/

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

Açıklamalar

Denetim Masası bölgesel ve dil seçenekleri bölümü aracılığıyla geçerli Windows kültürüyle ilişkili bazı değerleri geçersiz kılmayı seçebilirsiniz. Örneğin, kullanıcı tarihi farklı bir biçimde görüntülemeyi veya kültür için varsayılandan farklı bir para birimi kullanmayı seçebilir.

ise UseUserOverridetrue ve belirtilen kültür geçerli Windows kültürüyle eşleşiyorsa, CultureInfo özelliği tarafından döndürülen örneğin özellikleri DateTimeFormatInfo için kullanıcı ayarları ve özelliği tarafından DateTimeFormatNumberFormat döndürülen örneğin özellikleri NumberFormatInfo de dahil olmak üzere bu geçersiz kılmaları kullanır. Kullanıcı ayarları ile CultureInfoilişkili kültürle uyumsuzsa, örneğin, seçilen takvim öğesinden OptionalCalendarsbiri değilse, yöntemlerin sonuçları ve özelliklerin değerleri tanımlanmamıştır.

Özelliğin DateTimeFormat ve özelliğinin NumberFormat değeri, uygulamanız özelliğe erişene kadar hesaplanmaz. Kullanıcı, uygulama çalışırken geçerli kültürü yeni bir kültüre dönüştürebiliyorsa ve sonra uygulama or NumberFormat özelliğine DateTimeFormat erişiyorsa, uygulama özgün kültürün geçersiz kılmaları yerine yeni kültür için varsayılan değerleri alır. Özgün geçerli kültürün geçersiz kılmalarını korumak için, uygulamanın geçerli kültürü değiştirmeden önce ve NumberFormat özelliklerine erişmesi DateTimeFormat gerekir.

Arayanlara Notlar

Calendar ise TaiwanCalendar ancak CurrentCulture değeri Çince (Tayvan) olarak ayarlanmadıysa, zh-TW olarak adlandırılır, ardından NativeCalendarName, GetEraName(Int32)ve GetAbbreviatedEraName(Int32) boş bir dize ("") döndürür.

Şunlara uygulanır

Ayrıca bkz.