DateAndTime.TimeSerial(Int32, Int32, Int32) Método

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

DateAndTime.vb

Devuelve un valor de Date que representa una hora, un minuto y un segundo especificados, con la información de fecha establecida con respecto al 1 de enero del año 1.

public:
 static DateTime TimeSerial(int Hour, int Minute, int Second);

public static DateTime TimeSerial (int Hour, int Minute, int Second);

static member TimeSerial : int * int * int -> DateTime

Public Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTime

Parámetros

Hour

Int32

Obligatorio. Expresión de tipo Integer entre 0 y 23. Sin embargo, también se aceptan los valores no comprendidos en este intervalo.

Minute

Int32

Obligatorio. Expresión de tipo Integer entre 0 y 59. Sin embargo, también se aceptan los valores no comprendidos en este intervalo. El valor de Minute se suma a la hora calculada, por lo que un valor negativo especifica los minutos anteriores a esa hora.

Second

Int32

Obligatorio. Expresión de tipo Integer entre 0 y 59. Sin embargo, también se aceptan los valores no comprendidos en este intervalo. El valor de Second se suma al minuto calculado, por lo que un valor negativo especifica los segundos anteriores a ese minuto.

Devoluciones

DateTime

Valor Date que representa una hora, un minuto y un segundo especificados, con la información de fecha establecida con respecto al 1 de enero del año 1.

Excepciones

ArgumentException

Un argumento queda fuera del intervalo –2.147.483.648 a 2.147.483.647

ArgumentOutOfRangeException

La hora calculada es menos de 24 horas negativas.

Ejemplos

En el ejemplo siguiente se usa la TimeSerial función para devolver una hora para la hora, el minuto y el segundo especificados.

Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)

Comentarios

En el ejemplo siguiente se muestran los valores de argumento negativo, cero y positivo. La TimeSerial función devuelve una hora que representa 15 minutos antes de tres horas antes del mediodía, o 8:45:00 a. m.

Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)  

Si o MinuteSecond supera su intervalo normal, se aplica a la siguiente unidad más grande según corresponda. Por ejemplo, si especifica 75 minutos, se evalúa como una hora y 15 minutos.

TimeSerial reduce el módulo de segundos total 86.400, que es el número de segundos en un día. Por lo tanto, la hora devuelta siempre está entre las 00:00:00 y las 23:59:59.

El Date tipo de datos incluye componentes de fecha. TimeSerial establece todos estos valores en 1, por lo que el valor devuelto representa el primer día del año 1. Sin embargo, si los valores de los argumentos hacen que el tiempo calculado supere las 24 horas, el día se incrementa según sea necesario. En el ejemplo siguiente, los valores de Hour y Minute dan como resultado un tiempo combinado de más de 24 horas.

MsgBox(TimeSerial(23, 75, 0))   
' The preceding statement displays "1/2/0001 12:15:00 AM".  

Si los valores de los argumentos dan como resultado una hora calculada negativa, la información de fecha se establece en 1/1/0001 y la información de hora se ajusta para que esté entre 00:00:00 y 23:59:59. Sin embargo, si el tiempo calculado es menor que 24 horas negativas, se produce un ArgumentOutOfRangeException error.

Dado que cada Date valor es compatible con una System.DateTime estructura, sus métodos proporcionan opciones adicionales para ensamblar un Date valor. Por ejemplo, puede emplear uno de los constructores sobrecargados DateTime para rellenar una Date variable mediante la combinación deseada de componentes. En el ejemplo siguiente se establece newDateTime el 6 de mayo de 1978 en una décima parte de un segundo antes de las 8:30 de la mañana:

Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)  

Consulte también

• DateSerial(Int32, Int32, Int32)
• DateValue(String)
• Hour(DateTime)
• Minute(DateTime)
• Now
• Second(DateTime)
• TimeValue(String)