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

Gereklidir. Date biçimlendirilecek ifade.

NamedFormat

DateFormat

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

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 'ın (gece yarısı) 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# öğesini dizeye dönüştürürseniz, sonuç "09:30:00" olur; tarih bilgileri gizlenmiş. Ancak, tarih bilgileri özgün Date değerde hala bulunur ve gibi DatePartişlevlerle kurtarılabilir.

Not

Bağımsız değişkeni değişmez String değer olarak geçirirsenizExpression, FormatDateTime uygulamanızın ayarına CurrentCulture göre yorumlar. Ancak, değişmez değer olarak Date geçirirseniz, #mm/dd/yyyy# 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 bir kültürdeki değişmez değerler kullanılarak Date geliştirilir ve kodlanır, 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	Description
DateFormat.GeneralDate	Tarih ve/veya saat görüntüleme. Tarih bölümünü kısa tarih olarak görüntüler. Bir zaman bölümü varsa, uzun bir 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 saat biçimini kullanarak bir saat görüntüleyin.
DateFormat.ShortTime	24 saatlik biçimi (ss:mm) 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