Strings.FormatDateTime(DateTime, DateFormat) Méthode

  • Référence

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb

Retourne une expression de chaîne représentant une valeur de date/d'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

Obligatoire. Expression Date à mettre en forme.

NamedFormat
DateFormat

Optionnel. Valeur numérique qui indique le format de date/d'heure utilisé. Si cette valeur est omise, DateFormat.GeneralDate est utilisé.

Retours

String

Une expression de chaîne représentant une valeur de date/d’heure.

Exceptions

ArgumentException

Le paramètre NamedFormat 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 des informations de date et d’heure. À des fins de conversion de type, Visual Basic considère 1/1/1 (1er janvier de l’année 1) comme 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 Date d’origine et peuvent être récupérées avec des fonctions, comme DatePart.

Notes

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 passez en tant que Date littéral, utilisez le format #mm/jj/yyyy#, car FormatDateTime il interprète toujours un Date littéral en fonction de la culture anglaise (US). Cela est nécessaire, car si une application est développée et codée à l’aide Date de littéraux d’une culture, mais qu’elle est ensuite exécutée sur une plateforme avec une autre culture, les Date littéraux peuvent être analysés incorrectement.

L’argument NamedFormat a les paramètres suivants.

Constant Description
DateFormat.GeneralDate Affiche une date et/ou une heure. Affiche un composant de date sous forme de date courte. S’il existe une partie de temps, affichez-la sous la forme d’une longue durée. Le cas échéant, les deux parties s’affichent.
DateFormat.LongDate Affichez une date au format de date long spécifié dans les paramètres régionaux de votre ordinateur.
DateFormat.ShortDate Affichez une date à l’aide du format de date court spécifié dans les paramètres régionaux de votre ordinateur.
DateFormat.LongTime Affichez une heure en utilisant le format d’heure spécifié dans les paramètres régionaux de votre ordinateur.
DateFormat.ShortTime Affiche une heure au format 24 heures (hh :mm).

S’applique à

Voir aussi