Strings.FormatDateTime(DateTime, DateFormat) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb

Restituisce un'espressione stringa che rappresenta un valore 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

Obbligatorio. Espressione Date da formattare.

NamedFormat
DateFormat

facoltativo. Valore numerico che indica il formato di data e ora utilizzato. Se omesso, viene utilizzato DateFormat.GeneralDate.

Restituisce

String

Espressione stringa che rappresenta un valore data/ora.

Eccezioni

ArgumentException

L'impostazione NamedFormat 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 di data e ora. Ai fini della conversione dei tipi, Visual Basic considera 1/1/1 (1 gennaio dell'anno 1) come valore neutrale per la data e 00:00:00 (mezzanotte) come valore neutrale 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 ripristinate con funzioni come DatePart.

Nota

Se si passa l'argomento come String valore letterale, FormatDateTime lo interpreta in base all'impostazione ExpressionCurrentCulture dell'applicazione. Tuttavia, se lo si passa 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 da una cultura, ma viene eseguita in una piattaforma con impostazioni cultura diverse, i Date valori letterali potrebbero essere analizzati in modo errato.

L'argomento NamedFormat include le impostazioni seguenti.

Costante Descrizione
DateFormat.GeneralDate Visualizzare una data e/o un'ora. Visualizzare una parte data come breve data. Se c'è una parte temporale, visualizzarla come molto tempo. Se presente, entrambe le parti vengono visualizzate.
DateFormat.LongDate Visualizzare una data usando il formato di data lunga 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 ora specificato nelle impostazioni internazionali del computer.
DateFormat.ShortTime Visualizzare un'ora usando il formato di 24 ore (hh:mm).

Si applica a

Vedi anche