String format tanggal dan waktu standar

String format tanggal dan waktu standar menggunakan satu karakter sebagai penentu format untuk menentukan representasi teks dari nilai waktu dan tanggal. 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 untuk menentukan representasi teks yang dihasilkan dari operasi pemformatan.

Tabel penentu format

Tabel berikut ini menjelaskan penentu 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 -> 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)
"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 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 -> Senin, 15 Juni 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 -> 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").		 2009-06-15T13:45:30 (Lokal) --> 2009-06-15T13:45:30.0000000-07:00

2009-06-15T13:45:30 (Utc) --> 2009-06-15T13:45:30.0000000+00:00

2009-06-15T13:45:30 (Tidak Ditentukan) --> 2009-06-15T13:45:30.0000000
"R", "r" Pola RFC1123.

Informasi selengkapnya: Penentu format RFC1123 ("R", "r").		 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 (Lokal) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (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)
"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)
u Pola tanggal/waktu universal yang dapat diurutkan.

Informasi selengkapnya: Penentu format universal yang dapat diurutkan ("u").		 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"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. Menimbulkan kesalahan ekspresi run-time.

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.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d"])
        //Displays 3/15/2024
    }
in
    Source

  • Anda dapat meneruskan budaya yang digunakan untuk memformat tanggal sesuai dengan aturan budaya tertentu. Contoh berikut menampilkan tanggal dengan format tanggal pendek kultur pt-BR.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"])
        //Displays 15/03/2024
   }
in
    Source

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 String format kustom
"O" atau "o" Tidak yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" atau "r" Spesifikasi IETF RFC 1123 ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
s ISO 8601 yyyy'-'MM'-'dd'T'HH':'mm':'ss
u Dapat diurutkan karena menggunakan nol di depan untuk tahun, bulan, hari, jam, menit, dan detik yyyy'-'MM'-'dd HH':'mm':'ss'Z'

String format standar juga dapat digunakan dalam operasi penguraian, 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 berhasil.

Bagian berikut ini menjelaskan penentu format standar untuk nilai Tanggal, TanggalWaktu, DateTimeZone, dan Waktu .

Format tanggal

Grup ini mencakup format berikut:

Penentu format tanggal pendek ("d")

Penentu format standar "d" mewakili format tanggal kustom yang ditentukan oleh budaya tertentu. Misalnya, teks format kustom yang dikembalikan oleh budaya invariant adalah "MM/dd/yyyy".

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

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = ""]),
        // Displays 04/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-US"]),
        // Displays 4/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-NZ"]),
        // Displays 10/4/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "de-DE"])
        // Displays 10.4.2024
    }
in
    Source

Kembali ke tabel

Penentu format tanggal panjang ("D")

Penentu format standar "D" mewakili format tanggal kustom yang ditentukan oleh budaya tertentu. Misalnya, string format kustom untuk kultur invarian adalah "dddd, dd MMMM yyyy".

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

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = ""]),
        // Displays Wednesday, 10 April, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "pt-BR"]),
        // Displays quarta-feira, 10 de abril de 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "es-MX"])
        // Displays miércoles, 10 de abril de 2024
    }
in
    Source

Kembali ke tabel

Format tanggal dan waktu

Grup ini mencakup format berikut:

Penentu format waktu pendek tanggal lengkap ("f")

Penentu format standar "f" merepresentasikan kombinasi pola tanggal panjang ("D") dan waktu pendek ("t"), dipisahkan oleh spasi.

String hasil dipengaruhi oleh informasi pemformatan budaya tertentu.

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

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30
    }
in
    Source

Kembali ke tabel

Penentu format waktu panjang tanggal lengkap ("F")

Penentu format standar "F" mewakili format tanggal dan waktu kustom yang ditentukan oleh budaya tertentu. Misalnya, string format kustom untuk kultur invarian adalah "dddd, dd MMMM yyyy HH:mm:ss".

String hasil dipengaruhi oleh informasi pemformatan budaya tertentu.

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

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = ""]),
        // Displays Wednesday, 10 April, 2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30:00
    }
in
    Source

Kembali ke tabel

Penentu format waktu pendek tanggal umum ("g")

Penentu format standar "g" merepresentasikan kombinasi pola tanggal pendek ("d") dan waktu pendek ("t"), dipisahkan oleh spasi. Teks yang dihasilkan dipengaruhi oleh informasi pemformatan budaya tertentu.

String hasil dipengaruhi oleh informasi pemformatan budaya tertentu.

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

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = ""]),
        // Displays 04/10/2024 06:30

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "en-US"]),
        // Displays 4/10/2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "fr-BE"])
        // Displays 10-04-24 06:30
    }
in
    Source

Kembali ke tabel

Penentu format waktu panjang tanggal umum ("G")

Penentu format standar "G" merepresentasikan kombinasi pola tanggal pendek ("d") dan waktu panjang ("T"), dipisahkan oleh spasi. Teks yang dihasilkan dipengaruhi oleh informasi pemformatan budaya tertentu.

String hasil dipengaruhi oleh informasi pemformatan budaya tertentu.

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

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = ""]),
        // Displays 04/10/2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "en-US"]),
        // Displays 4/10/2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "nl-BE"])
        // Displays 10/04/2024 6:30:00
    }
in
    Source

Kembali ke tabel

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

Penentu format standar "O" atau "o" merepresentasikan string format tanggal dan waktu kustom dengan pola yang mempertahankan informasi zona waktu dan menghasilkan string yang sesuai dengan ISO 8601. Untuk nilai DateTimeZone , penentu format ini dirancang untuk mempertahankan nilai tanggal, waktu, dan zona waktu dalam teks.

Penentu format standar "O" atau "o" sesuai dengan "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' untai (karakter) format kustom fffffffxxx" untuk nilai DateTimeZone . Dalam teks ini, pasangan tanda kutip tunggal yang memisahkan karakter individual, seperti tanda hubung, titik dua, dan huruf "T", menunjukkan bahwa karakter individu adalah harfiah yang tidak dapat diubah. Apostrof tidak muncul dalam string output.

Penentu format standar "O" atau "o" (dan "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' format kustom fffffffxxx") memanfaatkan cara ISO 8601 mewakili informasi zona waktu untuk mempertahankan nilai DateTimeZone :

  • Komponen zona waktu DateTimeZone.ToLocal nilai tanggal dan waktu adalah offset dari UTC (misalnya, +01:00, -07:00).

  • Komponen zona waktu dari nilai tanggal dan waktu DateTimeZone.ToUtc menggunakan +00.00 untuk mewakili UTC.

Karena penentu format standar "O" atau "o" sesuai dengan standar internasional, operasi pemformatan atau penguraian yang menggunakan penentu selalu menggunakan kultur invarian dan kalender Gregorian.

Contoh berikut menggunakan penentu format "o" untuk menampilkan serangkaian nilai DateTimeZone pada sistem di zona Waktu Pasifik A.S.

let
    date1 = #datetimezone(2024, 6, 15, 13, 45, 30, 0, 0),
    Source =
    {
        Text.Format("#{0} (Unspecified) --> #{1}", {date1, DateTimeZone.ToText(date1, [Format = "O"])}),
        Text.Format("#{0} (Utc) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToUtc(date1), [Format = "O"])}),
        Text.Format("#{0} (Local) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToLocal(date1), [Format = "O"])})
    }
in
    Source

// The example displays the following output:
//    6/15/2024 1:45:30 PM +00:00 (Unspecified) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Utc) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Local) --> 2024-06-15T08:45:30.0000000-07:00

Catatan

Nilai yang dikembalikan oleh DateTimeZone.ToLocal bergantung pada apakah Anda menjalankan Power Query di komputer lokal atau online. Misalnya, dalam sampel di atas pada sistem di zona Waktu Pasifik -07:00 A.S. , Power Query Desktop kembali untuk Waktu lokal karena membaca waktu yang ditetapkan pada komputer lokal Anda. Namun, Power Query Online kembali +00:00 karena membaca waktu yang diatur pada komputer virtual cloud, yang diatur ke UTC.

Contoh berikut menggunakan penentu format "o" untuk membuat string yang diformat, lalu memulihkan nilai tanggal dan waktu asli dengan memanggil rutinitas penguraian tanggal dan waktu.

let
    // Round-trip a local time
    #"Origin Local Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0)
    ),
    #"Local Date Text" = DateTimeZone.ToText(
        #"Origin Local Date", [Format = "o"]
    ),
    #"New Local Date" = DateTimeZone.FromText(#"Local Date Text"),
    #"Local Round Trip" = Text.Format(
        "Round-tripped #{0} Local to #{1} Local.",
        {
            DateTimeZone.ToText(#"Origin Local Date"),
            DateTimeZone.ToText(#"New Local Date")
        }
    ),

    // Round-trip a UTC time
    #"Origin UTC Date" = DateTimeZone.ToUtc(
        #datetimezone(2024, 4, 12, 9, 30, 0, 0, 0)
    ),
    #"UTC Date Text" = DateTimeZone.ToText(
        #"Origin UTC Date", [Format = "o"]
    ),
    #"New UTC Date" = DateTimeZone.FromText(#"UTC Date Text"),
    #"UTC Round Trip" = Text.Format(
        "Round-tripped #{0} UTC to #{1} UTC.",
        {
            DateTimeZone.ToText(#"Origin UTC Date"),
            DateTimeZone.ToText(#"New UTC Date")
        }
    ),

    // Round-trip an 18 hour offset time
    #"Origin Offset Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0) + #duration(0, 18, 0, 0)
    ),
    #"Offset Date Text" = DateTimeZone.ToText(
        #"Origin Offset Date", [Format = "o"]
    ),
    #"New Offset Date" = DateTimeZone.FromText(#"Offset Date Text"),
    #"Offset Round Trip" = Text.Format(
        "Round-tripped #{0} to #{1}.",
        {
            DateTimeZone.ToText(#"Origin Offset Date"),
            DateTimeZone.ToText(#"New Offset Date")
        }
    ),

    #"Round Trip Results" =
        {#"Local Round Trip", #"UTC Round Trip", #"Offset Round Trip"}
in
    #"Round Trip Results"

// The example displays the following output in Power Query Desktop:
//    Round-tripped 4/9/2024 11:30:00 PM -07:00 Local to 4/9/2024 11:30:00 PM -07:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/10/2024 5:30:00 PM -07:00 to 4/10/2024 5:30:00 PM -07:00.

// The example displays the following output in Power Query Online:
//    Round-tripped 4/10/2024 6:30:00 AM +00:00 Local to 4/10/2024 6:30:00 AM +00:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/11/2024 12:30:00 AM +00:00 to 4/11/2024 12:30:00 AM +00:00.

Kembali ke tabel

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

Penentu format standar "R" atau "r" mewakili string format tanggal dan waktu kustom yang tidak ditentukan oleh budaya tertentu. Ini selalu sama, terlepas dari budaya yang digunakan atau penyedia format yang disediakan. String format kustom tersebut adalah "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Ketika penentu format standar ini digunakan, operasi pemformatan atau penguraian selalu menggunakan kultur invarian.

Meskipun standar RFC 1123 mengekspresikan waktu sebagai Waktu Universal Terkoordinasi (UTC), operasi pemformatan tidak mengubah nilai tanggal dan waktu yang sedang diformat. Oleh karena itu, Anda harus mengonversi nilai DateTime ke UTC dengan memanggil metode fungsi DateTimeZone.ToUtc sebelum Anda melakukan operasi pemformatan.

Contoh berikut menggunakan penentu format "r" untuk menampilkan nilai waktu dan tanggal pada sistem di zona Waktu Pasifik A.S. (tujuh jam di belakang UTC).

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source =
    {
        DateTimeZone.ToText(date1, [Format = "r"]),
        // Displays Wed, 10 Apr 2024 13:30:00 GMT

        DateTimeZone.ToText(dateOffset, [Format = "r"])
        // Displays Wed, 10 Apr 2024 13:30:00 GMT
    }
in
    Source

Kembali ke tabel

Penentu format yang dapat diurutkan ("s")

Penentu format standar "s" mewakili string format tanggal dan waktu kustom yang mencerminkan standar yang ditentukan (ISO 8601), dan bersifat baca-saja. Oleh karena itu, pola ini selalu sama, terlepas dari kultur yang digunakan atau penyedia format yang disediakan. String format kustom tersebut adalah "yyyy'-'MM'-'dd'T'HH':'mm':'ss". Tujuan dari penentu format "s" adalah untuk menghasilkan string hasil yang berurutan secara konsisten dalam urutan awal atau akhir berdasarkan nilai tanggal dan waktu.

Ketika penentu format standar ini digunakan, operasi pemformatan atau penguraian selalu menggunakan kultur invarian.

Contoh berikut menggunakan penentu format "s" untuk menampilkan nilai tanggal dan waktu pada sistem di zona Waktu Pasifik A.S.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "s", Culture = "en-US"])
        // Displays 2024-04-10T06:30:00
    }
in
    Source

Kembali ke tabel

Penentu format universal yang dapat diurutkan ("u")

Penentu format standar "u" mewakili string format tanggal dan waktu kustom yang selalu sama, terlepas dari budaya yang digunakan atau penyedia format yang disediakan. String format kustom tersebut adalah "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Pola ini mencerminkan standar yang ditentukan, dan properti tersebut bersifat baca-saja. Ketika penentu format standar ini digunakan, operasi pemformatan atau penguraian selalu menggunakan kultur invarian.

Meskipun string hasil harus mengekspresikan waktu sebagai Waktu Universal Terkoordinasi (UTC), tidak ada konversi nilai DateTimeZone asli yang dilakukan selama operasi pemformatan. Oleh karena itu, Anda harus mengonversi nilai DateTimeZone ke UTC dengan memanggil fungsi DateTimeZone.ToUtc sebelum memformatnya.

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

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source =
    {
        DateTimeZone.ToText(dateOffset, [Format = "u"]),
        // Displays 2024-04-10 13:30:00Z
    }
in
    Source

Kembali ke tabel

Format waktu

Grup ini mencakup format berikut:

Penentu format waktu pendek ("t")

Penentu format standar "t" mewakili string format tanggal dan waktu kustom yang ditentukan oleh budaya yang ditentukan. Misalnya, string format kustom untuk kultur invarian adalah "HH:mm".

String hasil dipengaruhi oleh informasi pemformatan budaya tertentu.

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

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = ""]),
        // Displays 06:30

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "en-US"]),
        // Displays 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "es-ES"])
        // Displays 6:30
    }
in
    Source

Kembali ke tabel

Penentu format waktu panjang ("T")

Penentu format standar "T" mewakili string format tanggal dan waktu kustom yang ditentukan oleh budaya tertentu. Misalnya, string format kustom untuk kultur invarian adalah "HH:mm:ss".

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

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = ""]),
        // Displays 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "en-US"]),
        // Displays 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "es-ES"])
        // Displays 6:30:00
    }
in
    Source

Kembali ke tabel

Format tanggal parsial

Grup ini mencakup format berikut:

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

Penentu format standar "M" atau "m" mewakili string format tanggal dan waktu kustom yang ditentukan oleh budaya tertentu. Misalnya, string format kustom untuk kultur invarian adalah "MMMM dd".

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

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = ""]),
        // Displays April 10

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "en-US"]),
        // Displays April 10

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "ms-MY"])
        // Displays 10 April
    }
in
    Source

Kembali ke tabel

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

Penentu format standar "Y" atau "y" mewakili string format tanggal kustom yang ditentukan oleh budaya tertentu. Misalnya, string format kustom untuk kultur invarian adalah "yyyy MMMM".

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

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = ""]),
        // Displays 2024 April

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = "en-US"]),
        // Displays April 2024

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "y", Culture = "af-ZA"])
        // Displays April 2024
    }
in
    Source

Kembali ke tabel

Konten terkait

  • Last updated on