String format tanggal dan waktu standar

Artikel
04/08/2023

String format tanggal dan waktu standar menggunakan karakter tunggal sebagai penentu format untuk menentukan representasi teks dari DateTimeatau nilai DateTimeOffset. 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 dalam dua cara:

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

Tip

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

Catatan

Beberapa contoh C# dalam artikel ini dijalankan dalam pengeksekusi dan playground code sebaris Try.NET. Pilih tombol Jalankan untuk menjalankan contoh di jendela interaktif. Setelah Anda menjalankan kode, Anda dapat memodifikasinya dan menjalankan kode yang dimodifikasi dengan memilih Jalankan lagi. Kode yang dimodifikasi berjalan di jendela interaktif atau, jika kompilasi gagal, jendela interaktif menampilkan semua pesan kesalahan pengompilasi C#.

Zona waktu lokal dari pengeksekusi dan playground code sebaris Try.NET adalah Waktu Universal Terkoordinasi, atau UTC. Hal ini dapat memengaruhi perilaku dan output contoh yang mengilustrasikan jenis DateTime, DateTimeOffset, dan TimeZoneInfo serta anggotanya.

Tabel penentu format

Tabel berikut ini menjelaskan penentu format tanggal dan waktu standar. Kecuali dinyatakan berbeda, penentu format tanggal dan waktu standar tertentu menghasilkan representasi string yang identik terlepas digunakan dengan nilai DateTime atau DateTimeOffset. Lihat Pengaturan Panel Kontrol dan Properti InfoFormatTanggalWaktu untuk informasi tambahan tentang penggunaan string format tanggal dan waktu standar.

Penentu format	Deskripsi	Contoh
"h"	Pola tanggal pendek. Informasi selengkapnya:Penentu format tanggal pendek ("d").	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Pola tanggal panjang. Informasi selengkapnya: Penentu format tanggal panjang ("D").	2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 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 -> Monday, June 15, 2009 1:45 PM (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 -> Monday, June 15, 2009 1:45:30 PM (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 -> 6/15/2009 1:45 PM (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 -> 6/15/2009 1:45:30 PM (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 -> June 15 (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
"R", "r"	Pola RFC1123. Informasi selengkapnya: Penentu format RFC1123 ("R", "r").	DateTimeOffset input: 2009-06-15T13:45:30 -> Senin, 15 Jun 2009 20:45:30 GMT DateTime input: 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 -> 1:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Pola waktu panjang. Informasi selengkapnya: Penentu format waktu panjang ("T").	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Pola tanggal/waktu universal yang dapat diurutkan. Informasi selengkapnya: Penentu format universal yang dapat diurutkan ("u").	Dengan DateTimenilai: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Dengan DateTimeOffsetnilai: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Pola tanggal/waktu lengkap universal. Informasi selengkapnya: Penentu format lengkap universal ("U").	2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (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 -> June 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.	Membuat run-time 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 CultureInfo objek yang mewakili kultur yang pemformatannya akan digunakan untuk metode yang memiliki IFormatProvider parameter. 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 dengan format tanggal pendek dari objek DateTimeFormatInfo untuk kultur 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

Catatan

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

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 ada	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 metode DateTime.ParseExact atau DateTimeOffset.ParseExact, yang memerlukan string input agar sesuai dengan pola tertentu agar operasi penguraian berhasil. Banyak string format standar memetakan ke beberapa string format kustom, sehingga nilai tanggal dan waktu dapat direpresentasikan dalam berbagai format sekaligus membuat operasi penguraian tetap berhasil. Anda dapat menentukan string format kustom atau string yang sesuai dengan string format standar dengan menggunakan 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("   {0}", 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 ini menjelaskan penentu format standar untuk nilai DateTime dan DateTimeOffset.

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 kultur tertentu. Misalnya, string format kustom yang dikembalikan oleh ShortDatePattern properti kultur invarian adalah "MM/dd/yyyy".

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

Properti	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

Properti	Deskripsi
LongDatePattern	Menentukan format keseluruhan string hasil.
DayNames	Menentukan nama lokal hari yang dapat muncul dalam string hasil.
MonthNames	Menentukan nama lokal bulan yang dapat muncul dalam string hasil.

Properti	Deskripsi
LongDatePattern	Menentukan format komponen tanggal dari string hasil.
ShortTimePattern	Menentukan format komponen waktu dari string hasil.
DayNames	Menentukan nama lokal hari yang dapat muncul dalam string hasil.
MonthNames	Menentukan nama lokal bulan yang dapat muncul dalam string hasil.
TimeSeparator	Menentukan string yang memisahkan komponen jam, menit, dan detik dari suatu waktu.
AMDesignator	Menentukan string yang menunjukkan waktu dari tengah malam hingga sebelum siang dalam jam dengan format 12-jam.
PMDesignator	Menentukan string yang menunjukkan waktu dari siang hari hingga sebelum tengah malam dalam jam dengan format 12-jam.

Properti	Deskripsi
FullDateTimePattern	Menentukan format keseluruhan string hasil.
DayNames	Menentukan nama lokal hari yang dapat muncul dalam string hasil.
MonthNames	Menentukan nama lokal bulan yang dapat muncul dalam string hasil.
TimeSeparator	Menentukan string yang memisahkan komponen jam, menit, dan detik dari suatu waktu.
AMDesignator	Menentukan string yang menunjukkan waktu dari tengah malam hingga sebelum siang dalam jam dengan format 12-jam.
PMDesignator	Menentukan string yang menunjukkan waktu dari siang hari hingga sebelum tengah malam dalam jam dengan format 12-jam.

Properti	Deskripsi
ShortDatePattern	Menentukan format komponen tanggal dari 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 detik dari suatu waktu.
AMDesignator	Menentukan string yang menunjukkan waktu dari tengah malam hingga sebelum siang dalam jam dengan format 12-jam.
PMDesignator	Menentukan string yang menunjukkan waktu dari siang hari hingga sebelum tengah malam dalam jam dengan format 12-jam.

Properti	Deskripsi
RFC1123Pattern	Menentukan format string hasil.
AbbreviatedDayNames	Menentukan nama hari yang disingkat dan dapat muncul dalam string hasil.
AbbreviatedMonthNames	Menentukan nama bulan yang disingkat dan dapat muncul dalam string hasil.

Properti	Deskripsi
MonthDayPattern	Menentukan format keseluruhan string hasil.
MonthNames	Menentukan nama lokal bulan yang dapat muncul dalam string hasil.

Properti	Deskripsi
YearMonthPattern	Menentukan format keseluruhan string hasil.
MonthNames	Menentukan nama lokal bulan yang dapat muncul dalam string hasil.

Bagikan melalui

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 lengkap universal ("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")

Pengaturan Panel Kontrol

Properti DateTimeFormatInfo

Lihat juga

Sumber Daya Tambahan: