Exportar (0) Imprimir
Expandir todo

DateTimePicker (Clase)

Representa un control de Windows que permite al usuario seleccionar una fecha y una hora, y mostrarlas con un formato especificado.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

'Declaración
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class DateTimePicker
	Inherits Control
'Uso
Dim instance As DateTimePicker

/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
/** @attribute ComVisibleAttribute(true) */ 
public class DateTimePicker extends Control
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
ComVisibleAttribute(true) 
public class DateTimePicker extends Control
No aplicable.

El control DateTimePicker se utiliza para permitir al usuario seleccionar una fecha y una hora, y mostrarlas en el formato especificado. Es posible limitar las fechas y las horas que se pueden seleccionar al establecer las propiedades MinDate y MaxDate.

Para cambiar la presentación de la parte del control que corresponde al calendario, establezca las propiedades CalendarForeColor, CalendarFont, CalendarTitleBackColor, CalendarTitleForeColor, CalendarTrailingForeColor y CalendarMonthBackground.

La propiedad Format establece la clase DateTimePickerFormat del control. La propiedad Format predeterminada de la fecha es DateTimePickerFormat.Long. Si la propiedad Format se establece en DateTimePickerFormat.Custom, se puede crear un estilo de formato propio mediante el establecimiento de la propiedad CustomFormat y la construcción de una cadena de formato personalizado. La cadena de formato personalizado puede ser una combinación de caracteres de campos personalizados y de otros literales de cadena. Por ejemplo, se puede presentar la fecha como "June 01, 2001 - Friday" al establecer la propiedad CustomFormat en "MMMM dd, yyyy - dddd". Para obtener más información, vea Cadenas de formato de fecha y hora.

Si desea utilizar un control de botón de número (también conocido como control de flechas) para ajustar el valor de fecha y hora, establezca la propiedad ShowUpDown en true. El control de calendario no se desplegará cuando se seleccione el control. Para ajustar la fecha y la hora, se puede seleccionar cada elemento por separado y utilizar los botones de flecha arriba y abajo para cambiar el valor.

Si se necesita aplicar un formato de fecha personalizado (por ejemplo, limitando la selección a una sola fecha), se puede utilizar un control DateTimePicker en lugar de un MonthCalendar. Al utilizar DateTimePicker, se limitará la necesidad de validar muchos datos de valores de fecha y hora.

NotaNota:

El control DateTimePicker sólo admite calendarios gregorianos.

En el ejemplo de código siguiente se crea una nueva instancia de un control DateTimePicker y se inicializa. Se establece la propiedad CustomFormat del control. Además, la propiedad ShowCheckBox se establece de tal forma que el control muestra una CheckBox, y la propiedad ShowUpDown se establece de modo que el control se muestre en un control de botón de número (también conocido como control de flechas). Para ejecutar este ejemplo, pegue el código siguiente en un formulario y llame al método CreateMyDateTimePicker en el constructor del formulario del ejemplo o el método de control de eventos Load.

Public Sub CreateMyDateTimePicker()
    ' Create a new DateTimePicker control and initialize it.
    Dim dateTimePicker1 As New DateTimePicker()
    
    ' Set the MinDate and MaxDate.
    dateTimePicker1.MinDate = New DateTime(1985, 6, 20)
    dateTimePicker1.MaxDate = DateTime.Today
    
    ' Set the CustomFormat string.
    dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
    dateTimePicker1.Format = DateTimePickerFormat.Custom
    
    ' Show the CheckBox and display the control as an up-down control.
    dateTimePicker1.ShowCheckBox = True
    dateTimePicker1.ShowUpDown = True
End Sub 'CreateMyDateTimePicker

public void CreateMyDateTimePicker()
{
    // Create a new DateTimePicker control and initialize it.
    DateTimePicker dateTimePicker1 = new DateTimePicker();

    // Set the MinDate and MaxDate.
    dateTimePicker1.set_MinDate(new DateTime(1985, 6, 20));
    dateTimePicker1.set_MaxDate(DateTime.get_Today());

    // Set the CustomFormat string.
    dateTimePicker1.set_CustomFormat("MMMM dd, yyyy - dddd");
    dateTimePicker1.set_Format(DateTimePickerFormat.Custom);

    // Show the CheckBox and display the control as an up-down control.
    dateTimePicker1.set_ShowCheckBox(true);
    dateTimePicker1.set_ShowUpDown(true);
} //CreateMyDateTimePicker

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
        System.Windows.Forms.DateTimePicker

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

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.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0
Mostrar:
© 2014 Microsoft