Strings.FormatDateTime(DateTime, DateFormat) Méthode

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Retourne une expression de chaîne représentant une valeur de date/heure.

public static string FormatDateTime(DateTime Expression, Microsoft.VisualBasic.DateFormat NamedFormat = Microsoft.VisualBasic.DateFormat.GeneralDate);
static member FormatDateTime : DateTime * Microsoft.VisualBasic.DateFormat -> string
Public Function FormatDateTime (Expression As DateTime, Optional NamedFormat As DateFormat = Microsoft.VisualBasic.DateFormat.GeneralDate) As String

Paramètres

Expression
DateTime

Required. Date expression à mettre en forme.

NamedFormat
DateFormat

Optional. Valeur numérique qui indique le format de date/heure utilisé. Si elle est omise, DateFormat.GeneralDate est utilisé.

Retours

String

Expression de chaîne représentant une valeur de date/heure.

Exceptions

ArgumentException

NamedFormat le paramètre n’est pas valide.

Exemples

Cet exemple illustre l’utilisation de la FormatDateTime fonction.

' English (US) format.
Dim testDate As DateTime = #3/12/1999#

' FormatDateTime returns "Friday, March 12, 1999".
' The time information is neutral (00:00:00) and therefore suppressed.
Dim testString As String = FormatDateTime(testDate, DateFormat.LongDate)

Remarques

Le Date type de données contient toujours les informations de date et d’heure. À des fins de conversion de type, Visual Basic considère que le 1er janvier (1er janvier de l’année 1) est une valeur neutre pour la date, et 00:00:00 (minuit) comme une valeur neutre pour l’heure. Si vous mettez en forme une Date valeur en tant que chaîne de date/heure, FormatDateTime n’inclut pas de valeurs neutres dans la chaîne résultante. Par exemple, si vous convertissez #1/1/0001 9:30:00# en chaîne, le résultat est « 9:30:00 AM » ; les informations de date sont supprimées. Toutefois, les informations de date sont toujours présentes dans la valeur d’origine Date et peuvent être récupérées avec des fonctions telles que DatePart.

Note

Si vous passez l’argument Expression en tant que String littéral, FormatDateTime l’interprète en fonction du CurrentCulture paramètre de votre application. Toutefois, si vous le transmettez en tant que Date littéral, utilisez le format #mm/dd/aaaa#, car FormatDateTime il interprète toujours un Date littéral en fonction de la culture anglaise (ÉTATS-Unis). Cela est nécessaire car, si une application est développée et codée à l’aide Date de littéraux d’une seule culture, mais qu’elle est exécutée sur une plateforme avec une autre culture, les Date littéraux peuvent être analysés de manière incorrecte.

L’argument NamedFormat a les paramètres suivants.

Constante Description
DateFormat.GeneralDate Affiche une date et/ou une heure. Affichez une partie de date sous la forme d’une courte date. S’il existe une partie de temps, affichez-la sous forme de temps long. S’il est présent, les deux parties s’affichent.
DateFormat.LongDate Affichez une date en utilisant le format de date longue spécifié dans les paramètres régionaux de votre ordinateur.
DateFormat.ShortDate Affichez une date en utilisant le format de date courte spécifié dans les paramètres régionaux de votre ordinateur.
DateFormat.LongTime Affiche une heure en utilisant le format d’heure spécifié dans les paramètres régionaux de votre ordinateur.
DateFormat.ShortTime Afficher une heure au format 24 heures (hh :mm).

S’applique à

Voir aussi