Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Propriedade CultureInfo.DateTimeFormat

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Globalization
Assembly:  mscorlib (em mscorlib.dll)

public virtual DateTimeFormatInfo DateTimeFormat { get; set; }

Valor da Propriedade

Type: System.Globalization.DateTimeFormatInfo

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

Exception Condition
ArgumentNullException

A propriedade é definida como nula.

InvalidOperationException

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

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

Se UseUserOverride é true e a cultura especificada corresponde a cultura atual do Windows, o CultureInfo usa essas substituições, inclusive configurações de usuário para as propriedades do DateTimeFormatInfo instância retornada pelo DateTimeFormat propriedade e as propriedades do NumberFormatInfo instância retornada pelo NumberFormat propriedade. Se as configurações do usuário são incompatíveis com a cultura associada com o CultureInfo, por exemplo, se o calendário selecionado não é um do OptionalCalendars, os resultados dos métodos e os valores das propriedades são indefinidos.

O valor de DateTimeFormat propriedade e o NumberFormat propriedade não será calculada até que seu aplicativo acessa a propriedade. Se o usuário pode alterar a cultura atual para uma nova cultura, enquanto o aplicativo está em execução e, em seguida, o aplicativo acessa o DateTimeFormat ou NumberFormat propriedade, o aplicativo recupera os valores padrão para a cultura novo em vez de substituições para a cultura original. Para preservar as substituições para a cultura atual original, o aplicativo deve acessar o DateTimeFormat e NumberFormat propriedades antes de alterar a cultura atual.

Observações para os Autores de Chamada:

Se DateTimeFormatInfo.Calendar é o TaiwanCalendar , mas o Thread.CurrentCulture não está definido como chinês (Taiwan), denominado zh-TW, em seguida, DateTimeFormatInfo.NativeCalendarName, DateTimeFormatInfo.GetEraName, e DateTimeFormatInfo.GetAbbreviatedEraName retornar uma cadeia de caracteres vazia ("").

O exemplo de código a seguir mostra que CultureInfo.Clone também copia o DateTimeFormatInfo e NumberFormatInfo instâncias associadas a 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

*/

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao início
Mostrar: