Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

DateAndTime.TimeSerial, méthode

.NET Framework 4.5

Autres versions

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.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans Microsoft.VisualBasic.dll)

Syntaxe

C++

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

Paramètres

Hour: Type : System.Int32
Obligatoire. Expression Integer comprise entre 0 et 23. Cependant, les valeurs non comprises dans cette plage sont également acceptées.

Minute: Type : System.Int32
Obligatoire. Expression Integer 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: Type : System.Int32
Obligatoire. Expression Integer 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.

Valeur de retour

Type : System.DateTime
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.

Exceptions

Exception	Condition
ArgumentException	Un argument se trouve en dehors de la plage s'étendant de -2 147 483 648 à 2 147 483 647
ArgumentOutOfRangeException	L'heure calculée est inférieure à -24 heures.

Notes

L'exemple à suivre contient des valeurs d'arguments négatives, nulles et positives. La fonction TimeSerial retourne une période représentant 15 minutes avant trois heures avant midi, c'est-à-dire 8:45:00.

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

Si Minute ou Second dépasse la plage normale, la valeur est appliquée à l'unité supérieure pertinente. Par exemple, si vous spécifiez 75 minutes, ce chiffre est interprété comme une heure et 15 minutes.

La fonction TimeSerial réduit le total des secondes avec un modulo 86 400, qui correspond au nombre de secondes que contient un jour. Ainsi, l'heure retournée se situe toujours entre 00:00:00 et 23:59:59.

Le type de données Date inclut des composants date. TimeSerial leur affecte à tous la valeur 1, donc la valeur retournée représente le premier jour de l'année 1. Toutefois, si les valeurs des arguments provoquent le dépassement de l'heure calculée de 24 heures, le jour est incrémenté comme nécessaire. Dans l'exemple suivant, les valeurs de Hour et Minute ont comme résultat une heure combinée supérieure à 24 heures.

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, l'indication de date a la valeur 1/1/0001 et l'indication d'heure est ajustée pour être comprise entre 00:00:00 et 23:59:59. Cependant, si l'heure calculée est inférieure à - 24, une erreur ArgumentOutOfRangeException se produit.

Étant donné que chaque valeur Date est prise en charge par une structure System.DateTime, ses méthodes vous donnent des possibilités supplémentaires pour assembler une valeur Date. Par exemple, vous pouvez utiliser l'un des constructeurs DateTime surchargés pour remplir une variable Date à l'aide de la combinaison de composants souhaitée. L'exemple suivant affecte à newDateTime la valeur du 6 mai 1978 à un dixième de seconde avant 8 heures 30 :

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

Exemples

L'exemple suivant utilise la fonction TimeSerial pour retourner un temps pour l'heure, la minute et la seconde spécifiées.


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

Informations de version

.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Plateformes

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Voir aussi

Référence

DateAndTime Classe

Microsoft.VisualBasic, espace de noms

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Ajouts de la communauté

AJOUTER