CultureInfo.DateTimeFormat Özellik

Tanım

Ad Alanı:

System.Globalization

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

CultureInfo.cs

Tarih ve saatleri 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 açıdan uygun biçimini tanımlayan bir.

Özel durumlar

ArgumentNullException

özelliği null olarak ayarlanır.

InvalidOperationException

DateTimeFormat özelliği veya özelliklerden 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 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ı'nın 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ılan değer dışında bir para birimi kullanmayı seçebilir.

Eğer UseUserOverridetrue ve belirtilen kültür geçerli Windows kültürüyle eşleşiyorsa, CultureInfo bu geçersiz kılmaları, DateTimeFormatInfo özelliği tarafından döndürülen DateTimeFormat örneğinin özellikleri ve NumberFormatInfo özelliği tarafından döndürülen NumberFormat örneğinin özellikleri için kullanıcı ayarları da dahil olmak üzere kullanır. Kullanıcı ayarları, CultureInfo ile ilişkili kültürle uyumlu değilse; örneğin seçilen takvim OptionalCalendars üzerinde sunulanlardan biri değilse, yöntemlerin sonuçları ve özelliklerin değerleri tanımsız olur.

Ö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 uygulama or NumberFormat özelliğine erişiyorsaDateTimeFormat, 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

ise ancak değeri Çince (Tayvan) olarak ayarlanmadıysa, zh-TWNativeCalendarNameGetEraName(Int32)olarak adlandırılır ve GetAbbreviatedEraName(Int32) boş bir dize ("") döndürür.CurrentCultureTaiwanCalendarCalendar

Ayrıca bkz.

• DateTimeFormatInfo
• GetFormat(Type)
• NumberFormat