CultureInfo.DateTimeFormat Propriedade

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

CultureInfo.cs

Obtém ou define um DateTimeFormatInfo que define o formato culturalmente apropriado de exibição de datas e horas.

C#

public virtual System.Globalization.DateTimeFormatInfo DateTimeFormat { get; set; }

Valor da propriedade

DateTimeFormatInfo

Um DateTimeFormatInfo que define o formato culturalmente apropriado de exibição de datas e horas.

Exceções

ArgumentNullException

A propriedade é definida como nula.

InvalidOperationException

A propriedade DateTimeFormat ou uma das propriedades DateTimeFormatInfo é definida e o CultureInfo é somente leitura.

Exemplos

O exemplo de código a seguir mostra que CultureInfo.Clone também clona as DateTimeFormatInfo instâncias e NumberFormatInfo associadas ao CultureInfo.

C#

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

*/

Comentários

Você pode optar por substituir alguns dos valores associados à cultura atual do Windows por meio da parte de opções regionais e de idioma de Painel de Controle. Por exemplo, o usuário pode optar por exibir a data em um formato diferente ou usar uma moeda diferente do padrão para a cultura.

Se UseUserOverride for true e a cultura especificada corresponder à cultura atual do Windows, o CultureInfo usará essas substituições, incluindo as configurações do usuário para as propriedades da DateTimeFormatInfo instância retornada pela DateTimeFormat propriedade e as propriedades da NumberFormatInfo instância retornadas pela NumberFormat propriedade . Se as configurações do usuário forem incompatíveis com a cultura associada CultureInfoao , por exemplo, se o calendário selecionado não for um dos OptionalCalendars, os resultados dos métodos e os valores das propriedades serão indefinidos.

O valor da DateTimeFormat propriedade e da NumberFormat propriedade não é calculado até que o aplicativo acesse a propriedade . Se o usuário puder alterar a cultura atual para uma nova cultura enquanto o aplicativo estiver em execução e, em seguida, o aplicativo acessar a DateTimeFormat propriedade ou NumberFormat , o aplicativo recuperará os padrões para a nova cultura em vez das substituições para a cultura original. Para preservar as substituições para a cultura atual original, o aplicativo deve acessar as DateTimeFormat propriedades e NumberFormat antes de alterar a cultura atual.

Notas aos Chamadores

Se Calendar for o TaiwanCalendar , mas o CurrentCulture não estiver definido como chinês (Taiwan), chamado zh-TW, então NativeCalendarName, GetEraName(Int32)e GetAbbreviatedEraName(Int32) retornará uma cadeia de caracteres vazia ("").

Aplica-se a

Confira também

• DateTimeFormatInfo
• GetFormat(Type)
• NumberFormat