Strings.FormatDateTime(DateTime, DateFormat) Metodo

Definizione

Spazio dei nomi:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Restituisce un'espressione stringa che rappresenta un valore di data/ora.

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

Parametri

Expression
DateTime

Required. Date espressione da formattare.

NamedFormat
DateFormat

Optional. Valore numerico che indica il formato data/ora usato. Se omesso, DateFormat.GeneralDate viene utilizzato .

Valori restituiti

String

Espressione stringa che rappresenta un valore di data/ora.

Eccezioni

ArgumentException

NamedFormat l'impostazione non è valida.

Esempio

In questo esempio viene illustrato l'uso della FormatDateTime funzione .

' 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)

Commenti

Il Date tipo di dati contiene sempre informazioni su data e ora. Ai fini della conversione del tipo, Visual Basic considera che 1/1/1 (1 gennaio dell'anno 1) sia un valore neutro per la data e 00:00:00 (mezzanotte) come valore neutro per l'ora. Se si formatta un Date valore come stringa di data/ora, FormatDateTime non include valori neutrali nella stringa risultante. Ad esempio, se si converte #1/1/0001 9:30:00# in una stringa, il risultato è "9:30:00 AM"; le informazioni sulla data vengono eliminate. Tuttavia, le informazioni sulla data sono ancora presenti nel valore originale Date e possono essere recuperate con funzioni come DatePart.

Note

Se si passa l'argomento Expression come valore String letterale, FormatDateTime lo interpreta in base all'impostazione CurrentCulture dell'applicazione. Tuttavia, se viene passato come Date valore letterale, usare il formato #mm/dd/yyyy#, perché FormatDateTime interpreta sempre un Date valore letterale in base alle impostazioni cultura inglese (Stati Uniti). Ciò è necessario perché, se un'applicazione viene sviluppata e codificata usando Date valori letterali di un'impostazione cultura, ma viene eseguita su una piattaforma con impostazioni cultura diverse, i Date valori letterali potrebbero essere analizzati in modo non corretto.

L'argomento NamedFormat ha le impostazioni seguenti.

Costante Description
DateFormat.GeneralDate Visualizzare una data e/o un'ora. Visualizzare una parte della data come data breve. Se è presente una parte temporale, visualizzarla per molto tempo. Se presente, vengono visualizzate entrambe le parti.
DateFormat.LongDate Visualizzare una data usando il formato data estesa specificato nelle impostazioni internazionali del computer.
DateFormat.ShortDate Visualizzare una data usando il formato di data breve specificato nelle impostazioni internazionali del computer.
DateFormat.LongTime Visualizzare un'ora usando il formato di ora specificato nelle impostazioni internazionali del computer.
DateFormat.ShortTime Visualizzare un'ora utilizzando il formato di 24 ore (hh:mm).

Si applica a

Vedi anche