String format tanggal dan waktu standar

String format tanggal dan waktu standar menggunakan satu karakter sebagai penentu format untuk menentukan representasi teks dari DateTimenilai , , DateTimeOffset DateOnly, atau TimeOnly . String format tanggal dan waktu apa pun yang berisi lebih dari satu karakter, termasuk ruang kosong, diinterpretasikan sebagai string format tanggal dan waktu kustom. String format standar atau kustom dapat digunakan dengan dua cara:

Untuk menentukan string yang dihasilkan dari operasi pemformatan.
Untuk menentukan representasi teks dari nilai tanggal dan waktu yang dapat dikonversi ke DateTimenilai , , DateTimeOffset DateOnly, atau TimeOnly oleh operasi penguraian.

Nasihat

Anda dapat mengunduh Utilitas Pemformatan, aplikasi .NET Windows Forms yang memungkinkan Anda menerapkan string format ke nilai numerik atau tanggal dan waktu dan menampilkan string hasil. Kode sumber tersedia untuk C# dan Visual Basic.

Tabel penentu format

Tabel berikut ini menjelaskan penentu format tanggal dan waktu standar. Kecuali dinyatakan lain, penentu format tanggal dan waktu standar tertentu menghasilkan representasi string yang identik terlepas dari apakah itu digunakan dengan nilai DateTime atau DateTimeOffset. Tidak semua penentu format dapat digunakan dengan DateOnly nilai dan TimeOnly ; untuk informasi tambahan, lihat Pemformatan DateOnly dan TimeOnly. Untuk informasi tentang bagaimana pengaturan regional pada Windows dan objek saat ini DateTimeFormatInfo dapat memengaruhi pemformatan tanggal dan waktu, lihat Pengaturan Panel Kontrol dan Properti DateTimeFormatInfo.

Penentu format	Deskripsi	Contoh
"d"	Pola tanggal pendek. Informasi selengkapnya:Penentu format tanggal pendek ("d").	2009-06-15T13:45:30 -> 15/6/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP) DateOnly (2009-06-15) -> 15/6/2009 (en-US)
"D"	Pola tanggal panjang. Informasi selengkapnya:Penentu format tanggal panjang ("D").	2009-06-15T13:45:30 -> Senin, 15 Juni 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Senin, tanggal 15. Juni 2009 (de-DE)
"f"	Pola tanggal/waktu lengkap (waktu pendek). Informasi selengkapnya: Penentu format waktu pendek tanggal lengkap ("f").	2009-06-15T13:45:30 -> Senin, 15 Juni 2009 13:45 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Pola tanggal/waktu lengkap (waktu yang panjang). Informasi selengkapnya: Penentu format waktu panjang tanggal lengkap ("F").	2009-06-15T13:45:30 -> Senin, 15 Juni 2009 13:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Pola tanggal/waktu umum (waktu pendek). Informasi selengkapnya: Penentu format waktu pendek tanggal umum ("g").	2009-06-15T13:45:30 -> 15/6/2009 13:45 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Pola tanggal/waktu umum (waktu panjang). Informasi selengkapnya: Penentu format waktu panjang tanggal umum ("G").	2009-06-15T13:45:30 -> 15/6/2009 13:45:30 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Pola bulan/hari. Informasi selengkapnya: Penentu format bulan ("M", "m").	2009-06-15T13:45:30 -> 15 Juni (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	pola tanggal/waktu dua arah. Informasi selengkapnya: Penentu format dua arah ("O", "o").	nilai DateTime: 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 nilai DateTimeOffset: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00 nilai DateOnly: 2009-06-15 --> 2009-06-15 nilai TimeOnly: 13:45:30 --> 13:45:30.00000000
"R", "r"	Pola RFC1123. Informasi selengkapnya: Penentu format RFC1123 ("R", "r").	input DateTimeOffset: 2009-06-15T13:45:30 -> Senin, 15 Jun 2009 20:45:30 GMT input DateTime: 2009-06-15T13:45:30 -> Senin, 15 Jun 2009 13:45:30 GMT
"s"	Pola tanggal/waktu yang dapat diurutkan. Informasi selengkapnya: Penentu format (“s”) yang dapat diurutkan.	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
t	Pola waktu pendek. Informasi selengkapnya: Penentu format waktu pendek ("t").	2009-06-15T13:45:30 -> 13:45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG) TimeOnly (13:45:30) -> 13:45 (en-US)
"T"	Pola waktu panjang. Informasi selengkapnya: Penentu format waktu panjang ("T").	2009-06-15T13:45:30 -> 13:45:30 (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG) TimeOnly (13:45:30) -> 13:45:30 (en-US)
"u"	Pola tanggal/waktu universal yang dapat diurutkan. Informasi selengkapnya: Penentu format universal yang dapat diurutkan ("u").	Dengan nilai DateTime: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Dengan nilai DateTimeOffset: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Pola tanggal/waktu lengkap universal. Informasi selengkapnya: Penentu format universal lengkap ("U").	2009-06-15T13:45:30 -> Senin, 15 Juni 2009 2009 20:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y"	Pola bulan tahun. Informasi selengkapnya: Penentu format bulan tahun ("Y").	2009-06-15T13:45:30 -> Juni 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Setiap karakter tunggal lainnya	Penentu yang tidak diketahui.	Melempar runtime FormatException.

Cara kerja string format standar

Dalam operasi pemformatan, string format standar hanyalah sebuah alias untuk string format kustom. Keuntungan menggunakan alias untuk mengacu ke string format kustom adalah bahwa, meskipun alias tetap invarian, string format kustom itu sendiri dapat bervariasi. Hal ini penting karena representasi string dari nilai tanggal dan waktu biasanya bervariasi menurut kultur. Misalnya, string format standar "d" menunjukkan bahwa nilai tanggal dan waktu akan ditampilkan dengan pola tanggal pendek. Untuk kultur invarian, pola ini adalah "MM/dd/yyyy". Untuk kultur fr-FR, pola ini adalah "dd/MM/yyyy". Untuk kultur ja-JP, pola ini adalah "yyyy/MM/dd".

Jika string format standar dalam operasi pemformatan memetakan ke string format kustom kultur tertentu, aplikasi Anda dapat menentukan budaya tertentu yang string format kustomnya digunakan dengan salah satu cara berikut:

Anda dapat menggunakan kultur default (atau saat ini). Contoh berikut menampilkan tanggal menggunakan format tanggal pendek kultur saat ini. Dalam hal ini, kultur saat ini adalah en-US.

// Display using current (en-us) culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008

' Display using current (en-us) culture's short date format
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

Anda dapat meneruskan objek CultureInfo yang mewakili budaya yang pemformatannya akan digunakan untuk metode yang memiliki parameter IFormatProvider. Contoh berikut menampilkan tanggal dengan format tanggal pendek kultur pt-BR.

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

Anda dapat meneruskan objek DateTimeFormatInfo yang menyediakan informasi pemformatan ke metode yang memiliki parameter IFormatProvider. Contoh berikut menampilkan tanggal menggunakan format tanggal pendek dari objek DateTimeFormatInfo untuk budaya hr-HR.

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

Nota

Untuk informasi tentang menyesuaikan pola atau string yang digunakan dalam memformat nilai tanggal dan waktu, lihat topik kelas NumberFormatInfo.

Dalam beberapa kasus, string format standar berfungsi sebagai singkatan yang mudah untuk string format kustom invarian yang lebih panjang. Empat string format standar termasuk dalam kategori ini: "O" (atau "o"), "R" (atau "r"), "s", dan "u". String ini sesuai dengan string format kustom yang ditentukan oleh kultur invarian. String ini menghasilkan representasi string dari nilai tanggal dan waktu yang dimaksudkan agar identik di seluruh kultur. Tabel berikut ini menyediakan informasi tentang keempat string format tanggal dan waktu standar ini.

String format standar	Ditentukan oleh properti DateTimeFormatInfo.InvariantInfo	String format kustom
"O" atau "o"	Tidak	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK
"R" atau "r"	RFC1123Pattern	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

String format standar juga dapat digunakan dalam operasi penguraian dengan DateTime.ParseExactmetode , , DateTimeOffset.ParseExact DateOnly.ParseExact, dan TimeOnly.ParseExact , yang memerlukan string input agar persis sesuai dengan pola tertentu agar operasi penguraian berhasil. Banyak string format standar dipetakan ke beberapa string format kustom, sehingga nilai tanggal dan waktu dapat diwakili dalam berbagai format dan operasi penguraian masih akan berhasil. Anda dapat menentukan string format kustom atau string yang sesuai dengan string format standar dengan memanggil metode DateTimeFormatInfo.GetAllDateTimePatterns(Char). Contoh berikut menampilkan string format kustom yang memetakan ke string format standar "d" (pola tanggal pendek).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine($"   {customString}");
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

Bagian berikut menjelaskan penentu format standar untuk DateTimenilai , , DateTimeOffset DateOnly, dan TimeOnly .

Format tanggal

Grup ini mencakup format berikut:

Penentu format tanggal pendek ("d")
Penentu format tanggal panjang ("D")

Penentu format tanggal pendek ("d")

Penentu format standar "d" mewakili string format tanggal dan waktu kustom yang ditentukan oleh properti DateTimeFormatInfo.ShortDatePattern budaya tertentu. Misalnya, string format kustom yang dikembalikan oleh properti ShortDatePattern dari budaya invarian adalah "MM/dd/yyyy".

Tabel berikut mencantumkan properti objek DateTimeFormatInfo yang mengontrol pemformatan string yang dikembalikan.

Harta benda	Deskripsi
ShortDatePattern	Menentukan format keseluruhan string hasil.
DateSeparator	Menentukan string yang memisahkan komponen tahun, bulan, dan hari dari tanggal.

Contoh berikut menggunakan penentu format "d" untuk menampilkan nilai tanggal dan waktu.

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008

Harta benda	Deskripsi
LongDatePattern	Menentukan format keseluruhan string hasil.
DayNames	Menentukan nama hari yang dilokalkan yang dapat muncul dalam string hasil.
MonthNames	Menentukan nama bulan yang dilokalkan yang dapat muncul dalam string hasil.

Harta benda	Deskripsi
LongDatePattern	Menentukan format komponen tanggal string hasil.
ShortTimePattern	Menentukan format komponen waktu dari string hasil.
DayNames	Menentukan nama hari yang dilokalkan yang dapat muncul dalam string hasil.
MonthNames	Menentukan nama bulan yang dilokalkan yang dapat muncul dalam string hasil.
TimeSeparator	Menentukan string yang memisahkan komponen jam, menit, dan kedua dari waktu tertentu.
AMDesignator	Menentukan string yang menunjukkan waktu dari tengah malam hingga sebelum siang hari dalam jam 12 jam.
PMDesignator	Menentukan string yang menunjukkan waktu dari siang hingga sebelum tengah malam dalam jam 12 jam.

Harta benda	Deskripsi
FullDateTimePattern	Menentukan format keseluruhan string hasil.
DayNames	Menentukan nama hari yang dilokalkan yang dapat muncul dalam string hasil.
MonthNames	Menentukan nama bulan yang dilokalkan yang dapat muncul dalam string hasil.
TimeSeparator	Menentukan string yang memisahkan komponen jam, menit, dan kedua dari waktu tertentu.
AMDesignator	Menentukan string yang menunjukkan waktu dari tengah malam hingga sebelum siang hari dalam jam 12 jam.
PMDesignator	Menentukan string yang menunjukkan waktu dari siang hingga sebelum tengah malam dalam jam 12 jam.

Harta benda	Deskripsi
ShortDatePattern	Menentukan format komponen tanggal string hasil.
LongTimePattern	Menentukan format komponen waktu dari string hasil.
DateSeparator	Menentukan string yang memisahkan komponen tahun, bulan, dan hari dari tanggal.
TimeSeparator	Menentukan string yang memisahkan komponen jam, menit, dan kedua dari waktu tertentu.
AMDesignator	Menentukan string yang menunjukkan waktu dari tengah malam hingga sebelum siang hari dalam jam 12 jam.
PMDesignator	Menentukan string yang menunjukkan waktu dari siang hingga sebelum tengah malam dalam jam 12 jam.

Harta benda	Deskripsi
RFC1123Pattern	Menentukan format string hasil.
AbbreviatedDayNames	Menentukan nama hari singkatan yang dapat muncul dalam string hasil.
AbbreviatedMonthNames	Menentukan nama bulan singkatan yang dapat muncul dalam string hasil.

Harta benda	Deskripsi
MonthDayPattern	Menentukan format keseluruhan string hasil.
MonthNames	Menentukan nama bulan yang dilokalkan yang dapat muncul dalam string hasil.

Harta benda	Deskripsi
YearMonthPattern	Menentukan format keseluruhan string hasil.
MonthNames	Menentukan nama bulan yang dilokalkan yang dapat muncul dalam string hasil.

String format tanggal dan waktu standar

Tabel penentu format

Cara kerja string format standar

Format tanggal

Penentu format tanggal pendek ("d")

Penentu format tanggal panjang ("D")

Format tanggal dan waktu

Penentu format waktu pendek tanggal lengkap ("f")

Penentu format waktu panjang tanggal lengkap ("F")

Penentu format waktu pendek tanggal umum ("g")

Penentu format waktu panjang tanggal umum ("G")

Penentu format dua arah ("O", "o")

Penentu format RFC1123 ("R", "r")

Penentu format yang dapat diurutkan ("s")

Penentu format universal yang dapat diurutkan ("u")

Penentu format universal penuh ("U")

Format waktu

Penentu format waktu pendek ("t")

Penentu format waktu panjang ("T")

Format tanggal parsial

Penentu format bulan ("M", "m")

Penentu format bulan tahun ("Y", "y")

Pemformatan DateOnly dan TimeOnly

Pengaturan Panel Kontrol

Properti DateTimeFormatInfo

Lihat juga

Saran dan Komentar

Sumber Daya Tambahan: