Strings.FormatDateTime(DateTime, DateFormat) Metode
Definisi
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
Ekspresi string yang mewakili nilai tanggal/waktu.
Pengecualian
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
Lihat juga
- 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)
- Ringkasan Manipulasi String