DateTimePicker.CustomFormat Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define a cadeia de caracteres de formato de data/hora personalizado.

public:
 property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };

public string CustomFormat { get; set; }

public string? CustomFormat { get; set; }

member this.CustomFormat : string with get, set

Public Property CustomFormat As String

Valor da propriedade

String

Uma cadeia de caracteres que representa o formato de data/hora personalizado. O padrão é null.

Exemplos

O exemplo de código a seguir define a CustomFormat propriedade para que a DateTimePicker data seja exibida como "01 de junho de 2001 - sexta-feira". Esse código pressupõe que uma instância de um DateTimePicker controle foi criada em 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

Comentários

Para exibir literais de cadeia de caracteres que contêm separadores de data e hora ou para formatar cadeias de caracteres, você deve usar caracteres de escape na subcadeia de caracteres. Por exemplo, para exibir a data como "15 de junho às 12:00", defina a CustomFormat propriedade como "MMMM dd 'at' t:mm tt". Se a subcadeia de caracteres "at" não estiver entre os caracteres de escape, o resultado será "15 de junho aP 12:00PM" porque o caractere "t" é lido como a letra A.M./P.M. de uma letra. cadeia de caracteres de formato (consulte a tabela de cadeia de caracteres de formato abaixo).

As cadeias de caracteres de formato podem ser combinadas para formatar a data e a hora. Por exemplo, para exibir a data e a hora como 15/06/2001 12:00 pm, essa propriedade deve ser definida como "MM'/'dd'/'yyy hh':'mm tt". Para obter mais informações, consulte Cadeias de caracteres de formato de data e hora personalizadas.

Observação

A Format propriedade deve ser definida para DateTimePickerFormat.Custom que essa propriedade afete a formatação da data e hora exibidas.

A tabela a seguir lista todas as cadeias de caracteres de formato válidas e suas descrições.

Cadeia de formato	Descrição
d	O dia de um ou dois dígitos.
dd	O dia de dois dígitos. Os valores de dia de dígito único são precedidos por um 0.
ddd	A abreviação de três caracteres no dia da semana.
dddd	O nome completo do dia da semana.
h	A hora de um ou dois dígitos no formato de 12 horas.
hh	A hora de dois dígitos no formato de 12 horas. Os valores de dígito único são precedidos por um 0.
H	A hora de um ou dois dígitos no formato de 24 horas.
HH	A hora de dois dígitos no formato de 24 horas. Os valores de dígito único são precedidos por um 0.
m	O minuto de um ou dois dígitos.
MM	O minuto de dois dígitos. Os valores de dígito único 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. Os valores de dígito único são precedidos por um 0.
MMM	A abreviação de 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. Os valores de dígito único são precedidos por um 0.
t	A.M./P.M. de uma letra. abreviação (A.M. é exibido como "A").
tt	A.M./P.M. de duas letras. abreviação (A.M. é exibido como "AM").
s	O ano de um dígito (2001 é exibido como "1").
yy	Os dois últimos dígitos do ano (2001 é exibido como "01").
yyyy	O ano inteiro (2001 é exibido como "2001").

Confira também

• DateTimePickerFormat
• Format