Strings.FormatDateTime(DateTime, DateFormat) Metode

Referensi

Definisi

Ruang nama:: Microsoft.VisualBasic

Rakitan:: Microsoft.VisualBasic.Core.dll

Rakitan:: Microsoft.VisualBasic.dll

Sumber:: Strings.vb

Sumber:: Strings.vb

Sumber:: Strings.vb

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengembalikan ekspresi string yang mewakili nilai tanggal/waktu.

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

Parameter

Expression: DateTime

Wajib diisi. Date ekspresi yang akan diformat.

NamedFormat: DateFormat

Opsional. Nilai numerik yang menunjukkan format tanggal/waktu yang digunakan. Jika dihilangkan, DateFormat.GeneralDate digunakan.

Mengembalikan

String

Ekspresi string yang mewakili nilai tanggal/waktu.

Pengecualian

ArgumentException

NamedFormat pengaturan tidak valid.

Contoh

Contoh ini menunjukkan penggunaan FormatDateTime fungsi.

' 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)

Keterangan

Jenis Date data selalu berisi informasi tanggal dan waktu. Untuk tujuan konversi jenis, Visual Basic menganggap 1/1/1 (1 Januari tahun 1) menjadi nilai netral untuk tanggal tersebut, dan 00:00:00 (tengah malam) menjadi nilai netral untuk saat itu. Jika Anda memformat Date nilai sebagai string tanggal/waktu, FormatDateTime tidak menyertakan nilai netral dalam string yang dihasilkan. Misalnya, jika Anda mengonversi #1/1/0001 9:30:00# menjadi string, hasilnya adalah "09:30:00 AM"; informasi tanggal ditekan. Namun, informasi tanggal masih ada dalam nilai asli Date dan dapat dipulihkan dengan fungsi seperti DatePart.

Catatan

Jika Anda meneruskan Expression argumen sebagai String harfiah, FormatDateTime menafsirkannya sesuai dengan CurrentCulture pengaturan aplikasi Anda. Namun, jika Anda meneruskannya sebagai Date harfiah, gunakan format #mm/dd/yyyy#, karena FormatDateTime selalu menafsirkan Date harfiah menurut budaya Inggris (AS). Ini diperlukan karena, jika aplikasi dikembangkan dan dikodekan menggunakan Date harfiah dari satu budaya, tetapi kemudian dijalankan pada platform dengan budaya yang berbeda, Date harfiah dapat diurai dengan salah.

Argumen NamedFormat memiliki pengaturan berikut.

Terus-menerus	Deskripsi
`DateFormat.GeneralDate`	Menampilkan tanggal dan/atau waktu. Tampilkan bagian tanggal sebagai tanggal pendek. Jika ada bagian waktu, tampilkan sebagai waktu yang lama. Jika ada, kedua bagian ditampilkan.
`DateFormat.LongDate`	Tampilkan tanggal menggunakan format tanggal panjang yang ditentukan di pengaturan regional komputer Anda.
`DateFormat.ShortDate`	Tampilkan tanggal menggunakan format tanggal pendek yang ditentukan di pengaturan regional komputer Anda.
`DateFormat.LongTime`	Tampilkan waktu menggunakan format waktu yang ditentukan di pengaturan regional komputer Anda.
`DateFormat.ShortTime`	Menampilkan waktu menggunakan format 24 jam (hh:mm).

Berlaku untuk