Strings.FormatDateTime(DateTime, DateFormat) Metodo

Definizione

Restituisce un'espressione stringa che rappresenta un valore data/ora.Returns a string expression representing a date/time value.

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.Required. Espressione Date da formattare.Date expression to be formatted.

NamedFormat
DateFormat

Facoltativo.Optional. Valore numerico che indica il formato di data e ora utilizzato.Numeric value that indicates the date/time format used. Se omesso, viene utilizzato DateFormat.GeneralDate.If omitted, DateFormat.GeneralDate is used.

Restituisce

Espressione stringa che rappresenta un valore data/ora.A string expression representing a date/time value.

Eccezioni

L'impostazione NamedFormat non è valida.NamedFormat setting is not valid.

Esempi

Questo esempio illustra l'uso della funzione FormatDateTime.This example demonstrates the use of the FormatDateTime function.

' 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 tipo di dati Date contiene sempre le informazioni di data e ora.The Date data type always contains both date and time information. 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.For purposes of type conversion, Visual Basic considers 1/1/1 (January 1 of the year 1) to be a neutral value for the date, and 00:00:00 (midnight) to be a neutral value for the time. Se si formatta un valore Date come stringa di data/ora, FormatDateTime non include valori neutri nella stringa risultante.If you format a Date value as a date/time string, FormatDateTime does not include neutral values in the resulting string. Se ad esempio si converte #1/1/0001 9:30:00 # in una stringa, il risultato sarà "9:30:00 AM"; le informazioni sulla data vengono omesse.For example, if you convert #1/1/0001 9:30:00# to a string, the result is "9:30:00 AM"; the date information is suppressed. Tuttavia, le informazioni sulla data sono ancora presenti nel valore originale Date e possono essere ripristinate con funzioni come DatePart.However, the date information is still present in the original Date value and can be recovered with functions such as DatePart.

Nota

Se si passa l'argomento Expression come valore letterale String, FormatDateTime lo interpreta in base all'impostazione CurrentCulture dell'applicazione.If you pass the Expression argument as a String literal, FormatDateTime interprets it according to the CurrentCulture setting of your application. Tuttavia, se si passa come valore letterale Date, utilizzare il formato #mm/dd/yyyy #, perché FormatDateTime interpreta sempre un valore letterale Date in base alle impostazioni cultura inglesi (Stati Uniti).However, if you pass it as a Date literal, use the format #mm/dd/yyyy#, because FormatDateTime always interprets a Date literal according to the English (US) culture. Questa operazione è necessaria perché, se un'applicazione viene sviluppata e codificata utilizzando valori letterali Date da un'unica lingua, ma viene quindi eseguita su una piattaforma con impostazioni cultura diverse, i valori letterali Date potrebbero essere analizzati in modo errato.This is necessary because, if an application is developed and coded using Date literals from one culture, but is then executed on a platform with a different culture, the Date literals could be parsed incorrectly.

L'argomento NamedFormat presenta le impostazioni seguenti.The NamedFormat argument has the following settings.

CostanteConstant DescriptionDescription
DateFormat.GeneralDate Visualizzare una data e/o un'ora.Display a date and/or time. Visualizza una parte della data come data breve.Display a date part as a short date. Se è presente una parte relativa all'ora, visualizzarla da molto tempo.If there is a time part, display it as a long time. Se presenti, vengono visualizzate entrambe le parti.If present, both parts display.
DateFormat.LongDate Visualizza una data usando il formato di data estesa specificato nelle impostazioni internazionali del computer.Display a date using the long date format specified in your computer's regional settings.
DateFormat.ShortDate Visualizza una data usando il formato di data breve specificato nelle impostazioni internazionali del computer.Display a date using the short date format specified in your computer's regional settings.
DateFormat.LongTime Visualizzare un'ora utilizzando il formato di ora specificato nelle impostazioni internazionali del computer.Display a time using the time format specified in your computer's regional settings.
DateFormat.ShortTime Visualizza l'ora utilizzando il formato a 24 ore (HH: mm).Display a time using the 24-hour format (hh:mm).

Si applica a

Vedi anche