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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

DateAndTime.vb

Retorna um valor Date que representa uma hora, um minuto e um segundo especificados, com as informações de data definidas em relação a 1º de janeiro do ano 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

Obrigatórios. Expressão de inteiro de 0 a 23. No entanto, valores fora desse intervalo também são aceitos.

Minute

Int32

Obrigatórios. Expressão de inteiro de 0 a 59. No entanto, valores fora desse intervalo também são aceitos. O valor de Minute é adicionado à hora calculada, para que um valor negativo especifique os minutos antes da hora.

Second

Int32

Obrigatórios. Expressão de inteiro de 0 a 59. No entanto, valores fora desse intervalo também são aceitos. O valor de Second é adicionado ao minuto calculado, para que um valor negativo especifique os segundos antes do minuto.

Retornos

DateTime

Um valor Date que representa uma hora, um minuto e um segundo especificados, com as informações de data definidas em relação a 1º de janeiro do ano 1.

Exceções

ArgumentException

Um argumento está fora do intervalo de -2.147.483.648 a 2.147.483.647

ArgumentOutOfRangeException

O tempo calculado é menor que 24 horas negativas.

Exemplos

O exemplo a seguir usa a TimeSerial função para retornar uma hora para a hora, o minuto e o segundo especificados.

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

Comentários

O exemplo a seguir demonstra valores de argumento negativos, zero e positivos. A TimeSerial função retorna um tempo que representa 15 minutos antes de três horas antes do meio-dia ou 8h45.

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

Se ou MinuteSecond exceder seu intervalo normal, ele será aplicado à próxima unidade maior, conforme apropriado. Por exemplo, se você especificar 75 minutos, ele será avaliado como uma hora e 15 minutos.

TimeSerial reduz o módulo total de segundos 86.400, que é o número de segundos em um dia. Portanto, a hora retornada é sempre entre 00:00:00 e 23:59:59.

O Date tipo de dados inclui componentes de data. TimeSerial define tudo isso como 1, portanto, o valor retornado representa o primeiro dia do ano 1. No entanto, se os valores dos argumentos fizerem com que o tempo calculado exceda 24 horas, o dia será incrementado conforme necessário. No exemplo a seguir, os valores de Hour e Minute resultam em um tempo combinado de mais de 24 horas.

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

Se os valores dos argumentos resultarem em uma hora calculada negativa, as informações de data serão definidas como 1/1/0001 e as informações de hora serão ajustadas entre 00:00:00 e 23:59:59. No entanto, se o tempo calculado for menor que 24 horas negativas, ocorrerá um ArgumentOutOfRangeException erro.

Como cada Date valor é suportado por uma System.DateTime estrutura, seus métodos oferecem opções adicionais na montagem de um Date valor. Por exemplo, você pode empregar um dos construtores sobrecarregados DateTime para preencher uma Date variável usando a combinação desejada de componentes. O exemplo a seguir define newDateTime 6 de maio de 1978 em um décimo de segundo antes das 8:30 da manhã:

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

Confira também

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