Strings.FormatDateTime(DateTime, DateFormat) Strings.FormatDateTime(DateTime, DateFormat) Strings.FormatDateTime(DateTime, DateFormat) Method

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 DateTime DateTime

Obbligatorio.Required. Espressione Date da formattare.Date expression to be formatted.

NamedFormat
DateFormat DateFormat DateFormat

Opzionale.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

In questo esempio illustra l'uso della FormatDateTime (funzione).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 Date tipo di dati contiene sempre le informazioni sia data e ora.The Date data type always contains both date and time information. Ai fini di conversione del tipo, Visual Basic considera come 1/1/1 (1 ° gennaio dell'anno 1) da un valore neutro per la data e 00:00:00 (mezzanotte) su un valore neutro per il periodo di tempo.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 Date valore come stringa 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. Ad esempio, se si converte & 1/1/0001 30: ore 9.00 & in una stringa, il risultato è "30: 9.00"; le informazioni sulla data viene eliminate.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 è ancora presente nell'originale Date valore e possono essere recuperate con le funzioni, ad esempio 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 il Expression argomento come un String letterale, FormatDateTime interpreta in base al CurrentCulture impostazione 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 viene passato come un Date letterale, usare # formato mm/gg/aaaa #, perché FormatDateTime sempre interpreta un Date letterale secondo la cultura inglese (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 codificati utilizzando Date valori letterali da una delle impostazioni cultura, ma viene quindi eseguita su una piattaforma con una lingua diversa, il Date valori letterali è stato possibile analizzare in modo non corretto.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.

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

CostanteConstant DescrizioneDescription
DateFormat.GeneralDate Visualizzare una data o ora.Display a date and/or time. Visualizzare una parte della data come data breve.Display a date part as a short date. Se è presente una parte dell'ora, è possibile visualizzarlo come molto tempo.If there is a time part, display it as a long time. Se presente, vengono visualizzate entrambe le parti.If present, both parts display.
DateFormat.LongDate Visualizzare una data utilizzando il formato di data lungo specificato nelle impostazioni internazionali del computer.Display a date using the long date format specified in your computer's regional settings.
DateFormat.ShortDate Visualizzare una data utilizzando 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 Visualizza l'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 di 24 ore (hh: mm).Display a time using the 24-hour format (hh:mm).

Si applica a

Vedi anche