Strings.FormatDateTime(DateTime, DateFormat) Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

Kaynak:

Strings.vb

Tarih/saat değerini temsil eden bir dize ifadesi döndürür.

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

Parametreler

Expression

DateTime

Gerekli. Date biçimlendirilecek ifade.

NamedFormat

DateFormat

Optional. Kullanılan tarih/saat biçimini gösteren sayısal değer. Atlanırsa kullanılır DateFormat.GeneralDate .

Döndürülenler

String

Tarih/saat değerini temsil eden dize ifadesi.

Özel durumlar

ArgumentException

NamedFormat ayarı geçerli değil.

Örnekler

Bu örnekte işlevin kullanımı gösterilmektedir 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)

Açıklamalar

Veri Date türü her zaman hem tarih hem de saat bilgilerini içerir. Tür dönüştürme amacıyla, Visual Basic 1/1/1 (1 Ocak 1) değerinin tarih için nötr bir değer, 00:00:00 (gece yarısı) değerini ise zaman için nötr bir değer olarak kabul eder. Bir Date değeri tarih/saat dizesi olarak biçimlendiriyorsanız, FormatDateTime sonuçta elde edilen dizeye nötr değerler içermez. Örneğin, #1/1/0001 9:30:00# değerini bir dizeye dönüştürürseniz, sonuç "09:30:00" olur; tarih bilgileri gösterilmez. Ancak, tarih bilgileri özgün Date değerde hala bulunur ve gibi DatePartişlevlerle kurtarılabilir.

Note

Bağımsız değişkeni değişmez Expression değer olarak geçirirsenizString, FormatDateTime uygulamanızın ayarına CurrentCulture göre yorumlar. Ancak, değişmez değer olarak Date geçirirseniz #mm/dd/yy# biçimini kullanın çünkü FormatDateTime değişmez değeri her zaman İngilizce (ABD) kültürüne göre yorumlar Date . Bu gereklidir, çünkü bir uygulama geliştirilip bir kültürdeki değişmez değerler kullanılarak Date kodlanırsa, ancak daha sonra farklı bir kültüre sahip bir platformda yürütülürse, Date değişmez değerler yanlış ayrıştırılabilir.

Bağımsız NamedFormat değişken aşağıdaki ayarlara sahiptir.

Sabit	Açıklama
DateFormat.GeneralDate	Tarih ve/veya saati görüntüleme. Tarih bölümünü kısa tarih olarak görüntüler. Bir zaman bölümü varsa, uzun süre olarak görüntüleyin. Varsa, her iki parça da görüntülenir.
DateFormat.LongDate	Bilgisayarınızın bölgesel ayarlarında belirtilen uzun tarih biçimini kullanarak bir tarih görüntüleyin.
DateFormat.ShortDate	Bilgisayarınızın bölgesel ayarlarında belirtilen kısa tarih biçimini kullanarak bir tarih görüntüleyin.
DateFormat.LongTime	Bilgisayarınızın bölgesel ayarlarında belirtilen zaman biçimini kullanarak bir saat görüntüleyin.
DateFormat.ShortTime	24 saatlik biçimi (ss:dd) kullanarak bir saat görüntüleyin.

Ayrıca bkz.

• 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)
• Dize Düzenleme Özeti