Strings.FormatDateTime(DateTime, DateFormat) Yöntem

  • Başvuru

Tanım

Ad Alanı:
Microsoft.VisualBasic
Bütünleştirilmiş Kod:
Microsoft.VisualBasic.Core.dll
Bütünleştirilmiş Kod:
Microsoft.VisualBasic.dll
Kaynak:
Strings.vb
Kaynak:
Strings.vb
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.

Şunlara uygulanır

Ayrıca bkz.