DateTimePicker.CustomFormat Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Recebe ou define a cadeia de formato personalizada de data/hora.

public:
 property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };
public string CustomFormat { get; set; }
member this.CustomFormat : string with get, set
Public Property CustomFormat As String

Valor de Propriedade

String

Uma cadeia que representa o formato personalizado de data/hora. A predefinição é null.

Exemplos

O seguinte exemplo de código define a CustomFormat propriedade para que a DateTimePicker data seja exibida como "01 de junho de 2001 - sexta-feira". Este código assume que uma instância de um DateTimePicker controlo foi criada sobre um Form.

public:
   void SetMyCustomFormat()
   {
      // Set the Format type and the CustomFormat string.
      dateTimePicker1->Format = DateTimePickerFormat::Custom;
      dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
   }

public void SetMyCustomFormat()
{
   // Set the Format type and the CustomFormat string.
   dateTimePicker1.Format = DateTimePickerFormat.Custom;
   dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
}

Public Sub SetMyCustomFormat()
    ' Set the Format type and the CustomFormat string.
    dateTimePicker1.Format = DateTimePickerFormat.Custom
    dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
End Sub

Observações

Para mostrar literais de strings que contenham separadores de data e hora ou para formatar strings, deve usar caracteres escape na substring. Por exemplo, para mostrar a data como "15 de junho às 12:00", defina a CustomFormat propriedade para "MMMM dd 'at' t:mm tt". Se a substring "at" não estiver incluída por caracteres de escape, o resultado é "June 15 aP 12:00PM" porque o carácter "t" é lido como a string de formato A.M./P.M. de uma letra (ver a tabela de cadeias de formato abaixo).

As strings de formato podem ser combinadas para formatar a data e a hora. Por exemplo, para mostrar a data e hora como 15/06/2001 12:00 PM, esta propriedade deve ser definida como "MM'/'dd'/'yyyy hh':'mm tt". Para mais informações, consulte Cadeias de Formato de Data e Hora Personalizadas.

Note

A Format propriedade deve estar definida para DateTimePickerFormat.Custom que esta função afete a formatação da data e hora apresentadas.

A tabela seguinte lista todas as cadeias de formatos válidas e as suas descrições.

Formatar cadeia de caracteres Descrição
d O dia de um ou dois dígitos.
dd O dia dos dois dígitos. Os valores de um dígito são precedidos por um 0.
ddd A abreviatura de três caracteres do dia da semana.
dddd O nome completo do dia da semana.
h A hora de um ou dois dígitos em formato de 12 horas.
hh A hora de dois dígitos em formato de 12 horas. Valores de um dígito são precedidos por um 0.
H A hora de um ou dois dígitos em formato 24 horas.
HH A hora de dois dígitos em formato 24 horas. Valores de um dígito são precedidos por um 0.
m O minuto de um ou dois dígitos.
mm O minuto de dois dígitos. Valores de um dígito são precedidos por um 0.
M O número do mês de um ou dois dígitos.
MM O número do mês de dois dígitos. Valores de um dígito são precedidos por um 0.
MMM A abreviatura do mês de três caracteres.
MMMM O nome completo do mês.
s Os segundos de um ou dois dígitos.
SS Os segundos de dois dígitos. Valores de um dígito são precedidos por um 0.
t A abreviatura de uma letra A.M./P.M. (A.M. é apresentada como "A").
tt A abreviatura de duas letras A.M./P.M. (A.M. é apresentada como "AM").
y O ano de um dígito (2001 é apresentado como "1").
yy Os dois últimos dígitos do ano (2001 é mostrado como "01").
yyyy O ano completo (2001) é apresentado como "2001").

Aplica-se a

Ver também