Partager via


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

Définition

Retourne une valeur Date représentant une heure, une minute et une seconde spécifiées, l'indication de date ayant la valeur 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 -> DateTime
Public Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTime

Paramètres

Hour
Int32

Obligatoire. Expression entière comprise entre 0 et 23. Cependant, les valeurs non comprises dans cette plage sont également acceptées.

Minute
Int32

Obligatoire. Expression entière comprise entre 0 et 59. Cependant, les valeurs non comprises dans cette plage sont également acceptées. La valeur de Minute est ajoutée à l'heure calculée, ce qui signifie qu'une valeur négative spécifie les minutes avant cette heure.

Second
Int32

Obligatoire. Expression entière comprise entre 0 et 59. Cependant, les valeurs non comprises dans cette plage sont également acceptées. La valeur de Second est ajoutée à la minute calculée, ce qui signifie qu'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, l’indication de date ayant la valeur 1er janvier de l’an 1.

Exceptions

Un argument se trouve en dehors de la plage s'étendant de -2 147 483 648 à 2 147 483 647

L'heure calculée est inférieure à -24 heures.

Exemples

L’exemple suivant utilise la TimeSerial fonction pour renvoyer 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, nulles 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)  

Minute Si ou Second dépasse sa plage normale, elle est appliquée à l’unité plus grande suivante, le cas échéant. 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, ce qui correspond au nombre de secondes par 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 des composants de date. TimeSerial définit tous ces éléments 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 font que le temps calculé dépasse 24 heures, le jour est incrémenté si nécessaire. Dans l’exemple suivant, les valeurs de Hour et Minute entraînent un temps combiné de plus de 24 heures.

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

Si les valeurs des arguments aboutissent à 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 de seconde avant 8h30 du matin :

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

S’applique à

Voir aussi