TimeString, propriété
Mise à jour : novembre 2007
Retourne ou définit une valeur String représentant l'heure en cours indiquée par votre système.
Public Property TimeString As String
Exceptions
Type d'exception |
Numéro de l'erreur |
Condition |
|---|---|---|
Format non valide utilisé pour définir la valeur de TimeString. |
Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion non structurée des erreurs. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.
Notes
La propriété TimeString retourne toujours l'heure système sous la forme "HH:mm:ss", qui est un format 24 heures. Ce format est de culture dite indifférente, ce qui signifie qu'il ne change pas même si vous modifiez les Options régionales dans le Panneau de configuration.
Pour obtenir ou définir la date système actuelle en tant que String, utilisez la DateString, propriété.
Pour obtenir la date ou l'heure système actuelle dans le format de vos paramètres régionaux, ou dans un format personnalisé, fournissez la Now, propriété à la Format, fonction, en spécifiant soit Formats de date/heure prédéfinis (fonction Format), soit Formats de date/heure définis par l'utilisateur (fonction Format). C'est ce qu'illustre l'exemple suivant.
MsgBox("The formatted time is " & Format(Now, "hh.mm.ss.fff tt"))
Pour accéder à l'heure système actuelle sous forme de Date, utilisez la TimeOfDay, propriété.
.gif "Note de sécurité") Note de sécurité : |
|---|
La définition de la date ou de l'heure système nécessite une autorisation de code non managée, ce qui peut affecter son exécution dans les situations d'un niveau de confiance partiel. Pour plus d'informations, consultez SecurityPermission et Autorisations d'accès du code. |
Exemple
Cet exemple utilise la propriété TimeString pour afficher l'heure système en cours.
MsgBox("The current time is " & TimeString)
Configuration requise
Espace de noms :Microsoft.VisualBasic
**Module :**DateAndTime
**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)
Du fait que TimeString est membre d'un module plutôt que d'une classe, vous n'avez pas besoin de créer un objet sur lequel accéder à TimeString.
Notes du développeur sur Smart Device
Vous pouvez obtenir, mais pas définir, l'heure système à l'aide de la propriété TimeString.