DATE |
Date |
|---|---|
| VB .NET (Visual Basic .NET) | |
Syntaxe
| Dim variable As Date |
| Dim variable() As Date |
| Dim variable As Date = startvalue |
| Dim variable() As Date = {startvalue,...}; |
Paramètres
| Nom | Description |
|---|---|
| variable | Ce paramètre permet d'indiquer le nom de la variable à créer |
| startvalue | Ce paramètre permet d'indiquer la valeur d'initialisation ou de départ de la variable |
Description
Ce type de données permet d'indiquer des données contenant une date.
Remarques
- Le type de données Date contient des valeurs IEEE 64 bits (8 octets) représentant des dates allant du 1er janvier de l'année 0001 au 31 décembre de l'année 9999, et des heures de 00:00:00 (minuit) à 23:59:59.99999999. Chaque incrément représente 100 nanosecondes de temps écoulé depuis le début du 1er janvier de l'an 1 du calendrier grégorien. La valeur maximale représente 100 nanosecondes avant le début du 1er janvier de l'année 10000.
- Utilisez le type de données Date pour contenir des valeurs de date, des valeurs d'heure ou des valeurs de date et d'heure.
- La valeur par défaut de Date est 0:00:00 (minuit) le 1er janvier 0001.
- Vous pouvez obtenir la date et l'heure actuelles à partir de la classe DateAndTime.
- Vous devez inclure un littéral de date entre des signes dièse (# #). Vous devez spécifier la valeur de la date au format M/j/aaaa, par exemple #5/31/1990#, ou aaaa-MM-jj, par exemple #1990-5-31#. Vous pouvez utiliser des barres obliques lorsque vous spécifiez l'année en premier. Cette exigence est indépendante de vos paramètres régionaux et des paramètres de format de date et d'heure de votre ordinateur. La raison de cette restriction est que la signification de votre code ne doit jamais changer en fonction des paramètres régionaux dans lesquels votre application s'exécute. Supposons que vous encodez en dur un littéral de date #3/4/1994# et que vous voulez qu'il signifie le 4 mars 1994. Dans une locale qui utilise mm/jj/aaaa, 3/4/1994 compile comme vous le souhaitez. Mais supposons que vous déployiez votre application dans de nombreux pays/régions. Dans une région utilisant jj/mm/aaaa, votre littéral codé en dur sera compilé jusqu'au 3 avril 1995. Dans une locale utilisant aaaa/mm/jj, le littéral serait invalide (avril 1995, 0003) et provoquerait une erreur de compilateur.
- Format de l'heure : Vous pouvez spécifier la valeur de l'heure au format 12 heures ou 24 heures, par exemple #1:15:30 PM# ou #13:15:30#. Cependant, si vous ne spécifiez ni les minutes ni les secondes, vous devez spécifier AM ou PM.
- Date et heure par défaut : Si vous n'incluez pas de date dans un littéral date/heure, le Visual Basic .NET définit la partie date de la valeur au 1er janvier 0001. Si vous n'incluez pas d'heure dans un littéral date/heure, le Visual Basic .NET définit la partie heure de la valeur au début de la journée, c'est-à-dire minuit (0:00:00).
- Conversions de type : Si vous convertissez une valeur Date en type String, le Visual Basic .NET restitue la date selon le format de date court spécifié par les paramètres régionaux d'exécution, et il restitue l'heure selon le format de l'heure (soit 12 heures ou 24 heures) spécifié par les paramètres régionaux d'exécution.
- Considérations sur l'interopérabilité : Si vous interagissez avec des composantes non écrits pour le cadre d'application .NET, par exemple des objets Automation ou COM, gardez à l'esprit que les types date/heure dans d'autres environnements ne sont pas compatibles avec le type Date de Visual Basic .NET. Si vous passez un paramètre date/heure à une telle composante, déclarez-le comme Double au lieu de Date dans votre nouveau code Visual Basic .NET et utilisez les méthodes de conversion DateTime.FromOADate et DateTime.ToOADate.
- Type de caractères : La date n'a pas de caractère de type littéral ou de caractère de type identifiant. Cependant, le compilateur traite les littéraux contenus dans des signes dièse (# #) comme Date.
- Type de cadre d'application : Le type correspondant dans le cadre d'application .NET est la structure System.DateTime.
Exemple
Voici quelques exemples typiques de l'utilisation de ce type de données :
on obtiendra le résultat suivant :
2012-01-13 00:00:00
Dernière mise à jour : Dimanche, le 9 novembre 2014