DateAndTime.TimeSerial(Int32, Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um Date valor que representa uma hora, minuto e segundo especificados, com a informação da data definida 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 -> DateTimePublic Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTimeParâmetros
- Hour
- Int32
Required. Expressão inteira de 0 a 23. No entanto, valores fora deste intervalo também são aceites.
- Minute
- Int32
Required. Expressão inteira de 0 a 59. No entanto, valores fora deste intervalo também são aceites. O valor de Minute é somado à hora calculada, pelo que um valor negativo especifica minutos antes dessa hora.
- Second
- Int32
Required. Expressão inteira de 0 a 59. No entanto, valores fora deste intervalo também são aceites. O valor de Second é somado ao minuto calculado, pelo que um valor negativo especifica segundos antes desse minuto.
Devoluções
Um Date valor que representa uma hora, minuto e segundo especificados, com a informação de data definida em relação a 1 de janeiro do ano 1.
Exceções
Um argumento está fora do intervalo de -2.147.483.648 a 2.147.483.647
O tempo calculado é inferior a menos de 24 horas.
Exemplos
O exemplo seguinte utiliza a TimeSerial função para devolver uma hora para a hora, minuto e segundo especificados.
Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)
Observações
O exemplo seguinte demonstra valores de argumentos negativos, zero e positivos. A TimeSerial função devolve uma hora que representa 15 minutos antes de três horas antes do meio-dia, ou 8:45:00 da manhã.
Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)
Se algum ou MinuteSecond exceder o seu intervalo normal, é aplicado à unidade seguinte maior, conforme apropriado. Por exemplo, se especificar 75 minutos, este é avaliado como uma hora e 15 minutos.
TimeSerial reduz o total de segundos módulo 86.400, que é o número de segundos num dia. Portanto, o tempo devolvido é sempre entre 00:00:00 e 23:59:59.
O Date tipo de dados inclui componentes de data.
TimeSerial define todos estes para 1, de modo que o valor devolvido 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 é incrementado conforme necessário. No exemplo seguinte, os valores de Hour e Minute resultam num tempo combinado superior a 24 horas.
MsgBox(TimeSerial(23, 75, 0))
' The preceding statement displays "1/2/0001 12:15:00 AM".
Se os valores dos argumentos resultarem num tempo calculado negativo, a informação da data é definida para 1/1/0001 e a informação da hora é ajustada para ser entre 00:00:00 e 23:59:59. No entanto, se o tempo calculado for inferior a menos de 24 horas, ocorre um ArgumentOutOfRangeException erro.
Como cada Date valor é suportado por uma System.DateTime estrutura, os seus métodos dão-lhe opções adicionais para montar um Date valor. Por exemplo, pode empregar um dos construtores sobrecarregados DateTime para preencher uma Date variável usando a combinação desejada de componentes. O exemplo seguinte situa-se newDateTime para 6 de maio de 1978, a um décimo de segundo antes das 8:30 da manhã:
Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)