DateAndTime.TimeSerial(Int32, Int32, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne une Date valeur représentant une heure, une minute et une seconde spécifiées, avec les informations de date définies par rapport au 1er janvier de l’année 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 DateTimeParamètres
- Hour
- Int32
Required. Expression entière comprise entre 0 et 23. Toutefois, les valeurs en dehors de cette plage sont également acceptées.
- Minute
- Int32
Required. Expression entière comprise entre 0 et 59. Toutefois, les valeurs en dehors de cette plage sont également acceptées. La valeur de Minute l’heure calculée est ajoutée. Par conséquent, une valeur négative spécifie les minutes avant cette heure.
- Second
- Int32
Required. Expression entière comprise entre 0 et 59. Toutefois, les valeurs en dehors de cette plage sont également acceptées. La valeur de Second l’argument est ajoutée à la minute calculée. Par conséquent, une valeur négative spécifie les secondes avant cette minute.
Retours
Valeur Date représentant une heure, une minute et une seconde spécifiées, avec les informations de date définies par rapport au 1er janvier de l’année 1.
Exceptions
Un argument est en dehors de la plage -2 147 483 648 à 2 147 483 647
Le temps calculé est inférieur à 24 heures négatif.
Exemples
L’exemple suivant utilise la TimeSerial fonction pour retourner une heure pour l’heure, la minute et la seconde spécifiées.
Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)
Remarques
L’exemple suivant illustre les valeurs d’argument négatives, zéro et positives. La TimeSerial fonction retourne une heure représentant 15 minutes avant trois heures avant midi ou 8:45:00.
Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)
Si l’une Minute ou Second l’autre dépasse sa plage normale, elle est appliquée à l’unité supérieure suivante selon les besoins. Par exemple, si vous spécifiez 75 minutes, elle est évaluée comme une heure et 15 minutes.
TimeSerial réduit le nombre total de secondes modulo 86 400, soit le nombre de secondes en un jour. Par conséquent, l’heure retournée est toujours comprise entre 00:00:00 et 23:59:59.
Le Date type de données inclut les composants de date.
TimeSerial définit toutes ces valeurs sur 1, de sorte que la valeur retournée représente le premier jour de l’année 1. Toutefois, si les valeurs des arguments provoquent un dépassement de 24 heures, le jour est incrémenté si nécessaire. Dans l’exemple suivant, les valeurs et HourMinute les résultats d’une durée combinée de plus de 24 heures sont réunies.
MsgBox(TimeSerial(23, 75, 0))
' The preceding statement displays "1/2/0001 12:15:00 AM".
Si les valeurs des arguments entraînent une heure calculée négative, les informations de date sont définies sur 1/1/0001 et les informations d’heure sont ajustées pour être comprises entre 00:00:00 et 23:59:59. Toutefois, si le temps calculé est inférieur à 24 heures négatif, une ArgumentOutOfRangeException erreur se produit.
Étant donné que chaque Date valeur est prise en charge par une System.DateTime structure, ses méthodes vous offrent des options supplémentaires pour assembler une Date valeur. Par exemple, vous pouvez utiliser l’un des constructeurs surchargés DateTime pour remplir une Date variable à l’aide de la combinaison souhaitée de composants. L’exemple suivant définit newDateTime le 6 mai 1978 à un dixième d’une seconde avant 8:30 le matin :
Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)