Strings.FormatDateTime(DateTime, DateFormat) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
Espressione stringa che rappresenta un valore data/ora.
Eccezioni
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 Expression
CurrentCulture 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
- Format(Object, String)
- FormatCurrency(Object, Int32, TriState, TriState, TriState)
- FormatNumber(Object, Int32, TriState, TriState, TriState)
- FormatPercent(Object, Int32, TriState, TriState, TriState)
- ArgumentException
- DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Riepilogo della modifica delle stringhe