DateTimePicker.CustomFormat Propriedade

Definição

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").

Aplica-se a

Confira também