Funzione FormatDateTime (Visual Basic)

Articolo
09/12/2008

Aggiornamento: novembre 2007

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

Function FormatDateTime(
   ByVal Expression As DateTime,
   Optional ByVal NamedFormat As DateFormat = DateFormat.GeneralDate
) As String

Parametri

Expression
Obbligatorio. Espressione Date da formattare.
NamedFormat
Facoltativo. Valore numerico che indica il formato data/ora utilizzato. Se omesso, verrà utilizzato il valore DateFormat.GeneralDate.

Impostazioni

Di seguito sono riportate le impostazioni dell'argomento NamedFormat.

Costante	Descrizione
DateFormat.GeneralDate	Vengono visualizzate una data e/o un'ora. Viene visualizzata una parte di data come data breve. Se è prevista una parte di ora, l'ora verrà visualizzata in formato esteso. Se presenti, verranno visualizzate entrambe le parti.
DateFormat.LongDate	La data verrà visualizzata nel formato esteso specificato nelle impostazioni internazionali del sistema.
DateFormat.ShortDate	La data verrà visualizzata nel formato breve specificato nelle impostazioni internazionali del sistema.
DateFormat.LongTime	L'ora verrà visualizzata nel formato specificato nelle impostazioni internazionali del sistema.
DateFormat.ShortTime	L'ora verrà visualizzata nel formato a 24 ore (hh:mm).

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	L'impostazione NamedFormat non è valida.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Il tipo di dati Date contiene sempre informazioni sia sulla data che sull'ora. Ai fini della conversione del tipo, Visual Basic considera 1/1/1 (1 gennaio dell'anno 1) come valore neutro per la data e 00:00:00 (mezzanotte) come valore neutro per l'ora. Se si formatta un valore Date in una stringa data/ora, FormatDateTime non includerà i valori neutri nella stringa risultante. Se ad esempio il valore #1/1/0001 9:30:00# viene convertito in una stringa, il risultato sarà "9:30:00 AM" e le informazioni sulla data non verranno visualizzate. Le informazioni sulla data sono comunque incluse nel valore Date originale e possono essere recuperate con funzioni come DatePart.

Nota:
Se si passa l'argomento Expression come String letterale, FormatDateTime lo interpreterà in base all'impostazione CurrentCulture dell'applicazione. Se tuttavia viene passato come valore letterale Date, utilizzare sempre il formato #mm/gg/aaaa#, in quanto FormatDateTime interpreta sempre un valore letterale Date in base alle impostazioni cultura inglesi (Stati Uniti). Se infatti un'applicazione viene sviluppata e codificata mediante valori letterali Date di determinate impostazioni cultura, ma viene quindi eseguita su una piattaforma con impostazioni cultura diverse, è possibile che i valori letterali Date vengano analizzati in modo errato.

Se si passa l'argomento Expression come String letterale, FormatDateTime lo interpreterà in base all'impostazione CurrentCulture dell'applicazione. Se tuttavia viene passato come valore letterale Date, utilizzare sempre il formato #mm/gg/aaaa#, in quanto FormatDateTime interpreta sempre un valore letterale Date in base alle impostazioni cultura inglesi (Stati Uniti). Se infatti un'applicazione viene sviluppata e codificata mediante valori letterali Date di determinate impostazioni cultura, ma viene quindi eseguita su una piattaforma con impostazioni cultura diverse, è possibile che i valori letterali Date vengano analizzati in modo errato.

Esempio

Nell'esempio riportato di seguito viene illustrato l'utilizzo della funzione FormatDateTime.

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