CultureInfo.DateTimeFormat Egenskap

Definition

Hämtar eller anger ett DateTimeFormatInfo som definierar det kulturellt lämpliga formatet för att visa datum och tider.

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

Egenskapsvärde

En DateTimeFormatInfo som definierar det kulturellt lämpliga formatet för att visa datum och tider.

Undantag

Egenskapen är inställd på null.

Egenskapen DateTimeFormat eller någon av DateTimeFormatInfo egenskaperna har angetts och CultureInfo är skrivskyddad.

Exempel

Följande kodexempel visar att CultureInfo.Clone även klonar de DateTimeFormatInfo instanser och NumberFormatInfo -instanser som är associerade med 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

Kommentarer

Du kan välja att åsidosätta några av de värden som är associerade med den aktuella kulturen i Windows via den regionala delen och språkalternativen i ovládací panel. Användaren kan till exempel välja att visa datumet i ett annat format eller använda en annan valuta än standardvärdet för kulturen.

Om UseUserOverride är true och den angivna kulturen matchar den aktuella kulturen i Windows, CultureInfo använder dessa åsidosättningar, inklusive användarinställningar för egenskaperna för den DateTimeFormatInfo instans som returneras av DateTimeFormat egenskapen och egenskaperna för den NumberFormatInfo instans som returneras av NumberFormat egenskapen. Om användarinställningarna inte är kompatibla med kulturen som är associerad med CultureInfo, till exempel om den valda kalendern inte är en av OptionalCalendarsmetoderna , är resultatet av metoderna och värdena för egenskaperna odefinierat.

Värdet för DateTimeFormat egenskapen och NumberFormat egenskapen beräknas inte förrän ditt program har åtkomst till egenskapen. Om användaren kan ändra den aktuella kulturen till en ny kultur medan programmet körs och programmet sedan kommer åt DateTimeFormat egenskapen eller NumberFormat , hämtar programmet standardvärdena för den nya kulturen i stället för åsidosättningarna för den ursprungliga kulturen. För att bevara åsidosättningarna för den ursprungliga aktuella kulturen bör programmet komma åt DateTimeFormat egenskaperna och NumberFormat innan den aktuella kulturen ändras.

Anteckningar till anropare

Om Calendar är TaiwanCalendar men CurrentCulture är inte inställt på kinesiska (Taiwan), med namnet zh-TW, sedan NativeCalendarName, GetEraName(Int32)och GetAbbreviatedEraName(Int32) returnerar en tom sträng ("").

Gäller för

Se även