Obtiene o establece la cadena de formato personalizado de fecha y hora.
Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)
Sintaxis
Visual Basic (Declaración)
<LocalizableAttribute(True)> _
Public Property CustomFormat As String
Dim instance As DateTimePicker
Dim value As String
value = instance.CustomFormat
instance.CustomFormat = value
[LocalizableAttribute(true)]
public string CustomFormat { get; set; }
[LocalizableAttribute(true)]
public:
property String^ CustomFormat {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_CustomFormat ()
/** @property */
public void set_CustomFormat (String value)
public function get CustomFormat () : String
public function set CustomFormat (value : String)
Valor de propiedad
Cadena que representa el formato personalizado de fecha y hora. El valor predeterminado es referencia null (
Nothing en Visual Basic).
Comentarios
Para mostrar los valores literales de cadena que contienen separadores de fecha y hora o para dar formato a cadenas, es necesario utilizar caracteres de escape en la subcadena. Por ejemplo, para mostrar la fecha como "June 15 at 12:00 PM", hay que establecer la propiedad CustomFormat en "MMMM dd 'at' t:mm tt". Si la subcadena "at" no está escrita entre caracteres de escape, el resultado será "June 15 aP 12:00PM" debido a que el carácter "t" se leerá como la cadena de formato AM/PM de una letra (vea la tabla de cadenas de formato que aparece a continuación).
Las cadenas de formato pueden combinarse para después aplicarse a la fecha y la hora. Por ejemplo, para mostrar la fecha y la hora como 06/15/2001 12:00 PM, esta propiedad se debe establecer en "MM'/'dd'/'yyyy hh':'mm tt". Para obtener más información, vea Cadenas de formato de fecha y hora.
.gif) Nota: |
|---|
| La propiedad Format debe establecerse en DateTimePickerFormat.Custom para que esta propiedad tenga efecto sobre el formato de la fecha y la hora mostradas. |
En la siguiente tabla, se muestran todas las cadenas de formato válidas y sus descripciones.
| Cadena de formato | Descripción |
| d | Día de uno o dos dígitos. |
| dd | Día de dos dígitos. Los valores de día de un dígito van precedidos de un cero. |
| ddd | Abreviatura de tres caracteres del día de la semana. |
| dddd | Nombre completo del día de la semana. |
| h | Hora de uno o dos dígitos en formato de 12 horas. |
| hh | Hora de dos dígitos en formato de 12 horas. Los valores de un solo dígito van precedidos de un cero. |
| H | Hora de uno o dos dígitos en formato de 24 horas. |
| HH | Hora de dos dígitos en formato de 24 horas. Los valores de un solo dígito van precedidos de un cero. |
| m | Minuto de uno o dos dígitos. |
| mm | Minuto de dos dígitos. Los valores de un solo dígito van precedidos de un cero. |
| M | Número del mes de uno o dos dígitos. |
| MM | Número del mes de dos dígitos. Los valores de un solo dígito van precedidos de un cero. |
| MMM | Abreviatura de tres caracteres del mes. |
| MMMM | Nombre completo del mes. |
| s | Segundo de uno o dos dígitos. |
| ss | Segundo de dos dígitos. Los valores de un solo dígito van precedidos de un cero. |
| t | La abreviatura AM/PM de una letra (AM se muestra como "A"). |
| tt | La abreviatura AM/PM de dos letras (AM se muestra como "AM"). |
| y | Año de un dígito (2001 se muestra como "1"). |
| yy | Los dos últimos dígitos del año (2001 se muestra como "01"). |
| yyyy | Año completo (2001 se muestra como "2001"). |
Ejemplo
En el código de ejemplo siguiente, se establece la propiedad CustomFormat de manera que DateTimePicker muestre la fecha como "June 01, 2001 - Friday". En el código se supone que se ha creado una instancia de un control DateTimePicker en un Form.
Public Sub SetMyCustomFormat()
' Set the Format type and the CustomFormat string.
dateTimePicker1.Format = DateTimePickerFormat.Custom
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
End Sub 'SetMyCustomFormat
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 void SetMyCustomFormat()
{
// Set the Format type and the CustomFormat string.
dateTimePicker1.set_Format(DateTimePickerFormat.Custom);
dateTimePicker1.set_CustomFormat("MMMM dd, yyyy - dddd");
} //SetMyCustomFormat
Plataformas
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.
Información de versión
.NET Framework
Compatible con: 3.0, 2.0, 1.1, 1.0
.NET Compact Framework
Compatible con: 2.0
Vea también