DateTimePicker.CustomFormat Propriedade

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.

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

Aplica-se a

Confira também

• DateTimePickerFormat
• Format