DateString, propriété

Mise à jour : novembre 2007

Retourne ou définit une valeur String représentant la date actuelle indiquée par votre système.

Public Property DateString As String

Exceptions

Type d'exception

Numéro de l'erreur

Condition

InvalidCastException

5

Format non valide utilisé pour définir la valeur de DateString.

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 et la propriété Number (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

DateString retourne toujours la date système sous la forme "MM-dd-yyyy", avec une abréviation du nom du mois. Les formats acceptés pour définir la date sont "M-d-yyyy", "M-d-y", "M/d/yyyy" et "M/d/y". Ces formats sont de culture dite indifférente, ce qui signifie qu'ils ne changent pas même si vous modifiez les Options régionales dans le Panneau de configuration.

Pour obtenir ou définir l'heure système actuelle sous forme de String, utilisez la propriété TimeString.

Pour obtenir la date ou l'heure système actuelle au format de vos paramètres régionaux ou dans un format personnalisé, fournissez la propriété Now à la fonction Format, en spécifiant les formats de date/heure prédéfinis (fonction Format) ou les formats de date/heure définis par l'utilisateur (fonction Format). C'est ce qu'illustre l'exemple suivant.

MsgBox("The formatted date is " & Format(Now, "dddd, d MMM yyyy"))

Pour accéder à la date système actuelle sous forme de Date, utilisez la propriété Today.

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

L'exemple suivant utilise la propriété DateString pour afficher la date système actuelle.

MsgBox("The current date is " & DateString)

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**DateAndTime

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Dans la mesure où DateString 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 à DateString.

Notes du développeur sur Smart Device

Vous pouvez obtenir, mais pas définir, la date système à l'aide de la propriété DateString.

Voir aussi

Référence

Now, propriété

TimeString, propriété

Today, propriété

Type de données date (Visual Basic)

DateTime