Bagikan melalui

String format tanggal dan waktu kustom

  • Artikel

String format tanggal dan waktu menentukan representasi teks nilai Tanggal, TanggalWaktu, DateTimeZone, atau Waktu yang dihasilkan dari operasi pemformatan. Ini juga dapat menentukan representasi nilai tanggal dan waktu yang diperlukan dalam operasi penguraian agar berhasil mengonversi string menjadi tanggal dan waktu. String format kustom terdiri dari satu atau beberapa penentu format tanggal dan waktu kustom. String apa pun yang bukan string format tanggal dan waktu standar ditafsirkan sebagai string format tanggal dan waktu kustom.

Dalam operasi pemformatan, string format tanggal dan waktu kustom dapat digunakan dengan ToText metode instans tanggal dan waktu dan zona waktu. Contoh berikut mengilustrasikan penggunaannya.

let
    Source = 
    {
        Text.From("Today is " & Date.ToText(#date(2011, 6, 10), [Format = "MMMM dd yyyy"]) & "."),
        Text.Format("The current date and time: #{0}", {DateTimeZone.ToText(
            #datetimezone(2011, 6, 10, 15, 24, 16, 0, 0), [Format = "MM/dd/yy H:mm:ss zzz"])}
        )
    }
in
    Source

// The example displays the following output:
//    Today is June 10, 2011.
//    The current date and time: 06/10/11 15:24:16 +00:00

Dalam operasi penguraian, string format tanggal dan waktu kustom dapat digunakan dengan fungsi Tanggal, TanggalWaktu, Waktu, dan DateTimeZone . Fungsi-fungsi ini mengharuskan string input sesuai persis dengan pola tertentu agar operasi penguraian berhasil. Contoh berikut mengilustrasikan panggilan ke fungsi DateTime.FromText untuk mengurai tanggal yang harus menyertakan bulan, hari, dan tahun dua digit.

let
    dateValues = { "30-12-2011", "12-30-2011", "30-12-11", "12-30-11"},
    pattern = "MM-dd-yy",
    convertedDates = List.Transform(dateValues, (dateValue) => 
        try Text.Format("Converted '#{0}' to #{1}.", {dateValue, DateTime.FromText(dateValue, [Format=pattern])}) 
        otherwise Text.Format("Unable to convert '#{0}' to a date and time.", {dateValue}))
in
    convertedDates

// The example displays the following output:
//    Unable to convert '30-12-2011' to a date and time.
//    Unable to convert '12-30-2011' to a date and time.
//    Unable to convert '30-12-11' to a date and time.
//    Converted '12-30-11' to 12/30/2011.

Tabel berikut ini menjelaskan penentu format tanggal dan waktu kustom dan menampilkan string hasil yang dihasilkan oleh setiap penentu format. Secara default, string hasil mencerminkan konvensi pemformatan budaya en-US. Jika penentu format tertentu menghasilkan string hasil yang dilokalkan, contohnya juga mencatat budaya yang diterapkan string hasil. Untuk informasi selengkapnya tentang menggunakan string format tanggal dan waktu kustom, buka bagian Catatan .

Penentu format Deskripsi Contoh
"h" Hari dalam sebulan, dari 1 hingga 31.

Informasi selengkapnya: Penentu format kustom "d".		 2009-06-01T13:45:30 -> 1

2009-06-15T13:45:30 -> 15
"dd" Hari dalam sebulan, dari 01 hingga 31.

Informasi selengkapnya: Penentu format kustom "dd".		 2009-06-01T13:45:30 -> 01

2009-06-15T13:45:30 -> 15
"ddd" Nama singkatan dari hari dalam seminggu.

Informasi selengkapnya: Penentu format kustom "ddd".		 2009-06-15T13:45:30 -> Mon (en-US)

2009-06-15T13:45:30 -> Пн (ru-RU)

2009-06-15T13:45:30 -> lun. fr-FR
"dddd" Nama lengkap hari dalam seminggu.

Informasi selengkapnya: Penentu format kustom "dddd".		 2009-06-15T13:45:30 -> Monday (en-US)

2009-06-15T13:45:30 -> понедельник (ru-RU)

2009-06-15T13:45:30 -> lundi (fr-FR)
"f" Persepuluh detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "f".		 2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.05 -> 0
"ff" Perseratus detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "ff".		 2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> 00
"fff" Milidetik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "fff".		 6/15/2009 13:45:30.617 -> 617

6/15/2009 13:45:30.0005 -> 000
"ffff" Sepuluh ribu detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "ffff".		 2009-06-15T13:45:30.6175000 -> 6175

2009-06-15T13:45:30.0000500 -> 0000
"fffff" Seratusribu detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "fffff".		 2009-06-15T13:45:30.6175400 -> 61754

6/15/2009 13:45:30.000005 -> 00000
"ffffff" Sepersejuta detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "ffffff".		 2009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> 000000
"fffffff" Sepuluh juta detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "fffffff".		 2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 0001150
"F" Jika tidak nol, persepuluh detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "F".		 2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.0500000 -> (tanpa output)
"FF" Jika tidak nol, perseratus detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "FF".		 2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> (tanpa output)
"FFF" Jika tidak nol, milidetik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "FFF".		 2009-06-15T13:45:30.6170000 -> 617

2009-06-15T13:45:30.0005000 -> (tanpa output)
"FFFF" Jika tidak nol, sepuluh ribu detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "FFFF".		 2009-06-15T13:45:30.5275000 -> 5275

2009-06-15T13:45:30.0000500 -> (tanpa output)
"FFFFF" Jika bukan nol, seratus ribu detik dalam interval waktu.

Informasi selengkapnya: Penentu format kustom "FFFFF".		 2009-06-15T13:45:30.6175400 -> 61754

2009-06-15T13:45:30.0000050 -> (tanpa output)
"FFFFFF" Jika tidak nol, sepersejuta detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "FFFFFF".		 2009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> (tanpa output)
"FFFFFFF" Jika tidak nol, sepuluh juta detik dalam nilai tanggal dan waktu.

Informasi selengkapnya: Penentu format kustom "FFFFFFF".		 2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 000115
"g", "gg" Periode atau era.

Informasi selengkapnya: Penentu format kustom "g" atau "gg".		 2009-06-15T13:45:30.6170000 -> A.D.
"h" Jam, menggunakan waktu 12 jam dari 1 hingga 12.

Informasi selengkapnya: Penentu format kustom "h".		 2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 1
"hh" Jam, menggunakan waktu 12 jam dari 01 hingga 12.

Informasi selengkapnya: Penentu format kustom "hh".		 2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 01
"H" Jam, menggunakan waktu 24 jam dari 0 hingga 23.

Informasi selengkapnya: Penentu format kustom "H".		 2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 13
"HH" Jam, menggunakan waktu 24 jam dari 00 hingga 23.

Informasi selengkapnya: Penentu format kustom "HH".		 2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 13
"K" Informasi zona waktu.

Informasi selengkapnya: Penentu format kustom "K".		 2009-06-15T13:45:30, Tidak ditentukan ->

2009-06-15T13:45:30, Utc -> +00:00

2009-06-15T13:45:30, Lokal -> -07:00 (tergantung pada pengaturan komputer lokal atau cloud)
"b" Menit, dari 0 hingga 59.

Informasi selengkapnya: Penentu format kustom "m".		 2009-06-15T01:09:30 -> 9

2009-06-15T13:29:30 -> 29
"mm" Menit, dari 00 hingga 59.

Informasi selengkapnya: Penentu format kustom "mm".		 2009-06-15T01:09:30 -> 09

2009-06-15T01:45:30 -> 45
"M" Bulan, dari 1 hingga 12.

Informasi selengkapnya: Penentu format kustom "M".		 2009-06-15T13:45:30 -> 6
"MM" Bulan, dari 01 hingga 12.

Informasi selengkapnya: Penentu format kustom "MM".		 2009-06-15T13:45:30 -> 06
"MMM" Nama singkatan dari bulan tersebut.

Informasi selengkapnya: Penentu format kustom "MMM".		 2009-06-15T13:45:30 -> Jun (en-US)

2009-06-15T13:45:30 -> juin (fr-FR)

2009-06-15T13:45:30 -> Jun (zu-ZA)
"MMMM" Nama lengkap bulan ini.

Informasi selengkapnya: Penentu format kustom "MMMM".		 2009-06-15T13:45:30 -> June (en-US)

2009-06-15T13:45:30 -> juni (da-DK)

2009-06-15T13:45:30 -> Juni (zu-ZA)
"s" Yang kedua, dari 0 hingga 59.

Informasi selengkapnya: Penentu format kustom "s".		 2009-06-15T13:45:09 -> 9
"ss" Yang kedua, dari 00 hingga 59.

Informasi selengkapnya: Penentu format kustom "ss".		 2009-06-15T13:45:09 -> 09
"t" Karakter pertama dari penunjuk AM/PM.

Informasi selengkapnya: Penentu format kustom "t".		 2009-06-15T13:45:30 -> P (en-US)

2009-06-15T13:45:30 -> 午 (ja-JP)

2009-06-15T13:45:30 -> (fr-FR)
"tt" Penunjuk AM/PM.

Informasi selengkapnya: Penentu format kustom "tt".		 2009-06-15T13:45:30 -> PM (en-US)

2009-06-15T13:45:30 -> 午後 (ja-JP)

2009-06-15T13:45:30 -> (fr-FR)
"y" Tahun, dari 0 hingga 99.

Informasi selengkapnya: Penentu format kustom "y".		 0001-01-01T00:00:00 -> 1

0900-01-01T00:00:00 -> 0

1900-01-01T00:00:00 -> 0

2009-06-15T13:45:30 -> 9

2019-06-15T13:45:30 -> 19
"yy" Tahun, dari 00 menjadi 99.

Informasi selengkapnya: Penentu format kustom "yy".		 0001-01-01T00:00:00 -> 01

0900-01-01T00:00:00 -> 00

1900-01-01T00:00:00 -> 00

2019-06-15T13:45:30 -> 19
"yyy" Tahun ini, dengan minimal tiga digit.

Informasi selengkapnya: Penentu format kustom "yyy".		 0001-01-01T00:00:00 -> 001

0900-01-01T00:00:00 -> 900

1900-01-01T00:00:00 -> 1900

2009-06-15T13:45:30 -> 2009
"tttt" Tahun sebagai angka empat digit

Informasi selengkapnya: Penentu format kustom "yyyy".		 0001-01-01T00:00:00 -> 0001

0900-01-01T00:00:00 -> 0900

1900-01-01T00:00:00 -> 1900

2009-06-15T13:45:30 -> 2009
"yyyyy" Tahun ini sebagai angka lima digit.

Informasi selengkapnya: Penentu format kustom "yyyyy".		 0001-01-01T00:00:00 -> 00001

2009-06-15T13:45:30 -> 02009
"z" Jam diimbangi dari UTC, tanpa nol di awal.

Informasi selengkapnya: Penentu format kustom "z".		 2009-06-15T13:45:30-07:00 -> -7
"zz" Jam diimbangi dari UTC, dengan nol di depan untuk nilai satu digit.

Informasi selengkapnya: Penentu format kustom "zz".		 2009-06-15T13:45:30-07:00 -> -07
"zzz" Jam dan menit diimbangi dari UTC.

Informasi selengkapnya: Penentu format kustom "zzz".		 2009-06-15T13:45:30-07:00 -> -07:00
":" Pemisah waktu.

Informasi selengkapnya: Penentu format kustom ":" .		 2009-06-15T13:45:30 -> : (en-US)

2009-06-15T13:45:30 -> . (it-IT)

2009-06-15T13:45:30 -> : (ja-JP)
"/" Pemisah tanggal.

Informasi Selengkapnya: Penentu format kustom "/".		 2009-06-15T13:45:30 -> / (en-US)

2009-06-15T13:45:30 -> - (ar-DZ)

2009-06-15T13:45:30 -> . (tr-TR)
"string"

'string'		 Pemisah string harfiah.

Informasi selengkapnya: Harfiah karakter.		 2009-06-15T13:45:30 (""arr:"" h:m t) -> arr: 1:45 P

2009-06-15T13:45:30 ('arr:' h:m t) -> arr: 1:45 P
% Mendefinisikan karakter berikut sebagai penentu format kustom.

Informasi selengkapnya: Menggunakan penentu format kustom tunggal.		 2009-06-15T13:45:30 (%h) -> 1
\, "", ' Urutan escape.

Informasi selengkapnya: Literal karakter dan Menggunakan urutan escape.		 2009-06-15T13:45:30 (h \h) -> 1 jam

2009-06-15T13:45:30 (h ""h"") -> 1 jam

2009-06-15T13:45:30 (h 'h') -> 1 jam
Karakter lainnya Karakter disalin ke string hasil tanpa diubah.

Informasi selengkapnya: Harfiah karakter.		 2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

Bagian berikut ini menyediakan informasi tambahan tentang setiap penentu format tanggal dan waktu kustom. Kecuali dinyatakan lain, setiap penentu menghasilkan representasi string yang identik terlepas dari apakah itu digunakan dengan nilai Tanggal, TanggalWaktu, DateTimeZone, atau Waktu .

Penentu format "d" hari

Penentu format kustom "d"

Penentu format kustom "d" mewakili hari dalam sebulan sebagai angka dari 1 hingga 31. Satu digit hari diformat tanpa nol di depannya.

Jika penentu format "d" digunakan tanpa penentu format kustom lainnya, itu ditafsirkan sebagai penentu format tanggal dan waktu standar "d". Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut menyertakan penentu format kustom "d" dalam beberapa string format.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, M", Culture = ""]),
        // Displays 29, 8 

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "en-US"]),
        // Displays 29, August

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "es-MX"])
        // Displays 29, agosto
    }
in
    Source

Kembali ke tabel

Penentu format kustom "dd"

String format kustom "dd" menunjukkan hari dalam sebulan sebagai angka dari 01 hingga 31. Satu digit hari diformat dengan nol di depannya.

Contoh berikut menyertakan penentu format kustom "dd" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
        // Displays 02, 01 
    }
in
    Source

Kembali ke tabel

Penentu format kustom "ddd"

Penentu format kustom "ddd" mewakili nama singkatan dari hari dalam seminggu. Nama singkatan yang dilokalkan dari hari dalam seminggu diambil dari budaya saat ini atau yang ditentukan.

Contoh berikut menyertakan penentu format kustom "ddd" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
        // Displays Thu 29 Aug

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
        // Displays jeu. 29 août
    }
in
    Source

Kembali ke tabel

Penentu format kustom "dddd"

Penentu format kustom "dddd" (ditambah sejumlah penentu "d" tambahan) mewakili nama lengkap hari itu. Nama yang dilokalkan pada hari dalam seminggu diambil dari budaya saat ini atau yang ditentukan.

Contoh berikut menyertakan penentu format kustom "dddd" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
        // Displays Thursday 29 August

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
        // Displays giovedì 29 agosto
    }
in
    Source

Kembali ke tabel

Penentu pecahan "f" detik huruf kecil

Penentu format kustom "f"

Penentu format kustom "f" mewakili digit paling signifikan dari pecahan detik; artinya, mewakili persepuluh detik dalam nilai tanggal dan waktu.

Jika penentu format "f" digunakan tanpa penentu format lain, format ini ditafsirkan sebagai penentu format tanggal dan waktu standar "f". Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Saat Anda menggunakan penentu format "f" sebagai bagian dari string format yang disediakan untuk mengurai jumlah detik pecahan, jumlah penentu format "f" menunjukkan jumlah digit paling signifikan dari pecahan detik yang harus ada agar berhasil mengurai string.

Contoh berikut menyertakan penentu format kustom "f" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
        // Displays 07:27:15:0

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
        // Displays 07:27:15:
    }
in
    Source

Kembali ke tabel

Penentu format kustom "ff"

Penentu format kustom "ff" mewakili dua digit paling signifikan dari pecahan detik; artinya, ini mewakili per seratus detik dalam nilai tanggal dan waktu.

contoh berikut menyertakan penentu format kustom "ff" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
        // Displays 07:27:15:01

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
        // Displays 07:27:15:01
    }
in
    Source

Kembali ke tabel

Penentu format kustom "fff"

Penentu format kustom "fff" mewakili tiga digit paling signifikan dari pecahan detik; artinya, mewakili milidetik dalam nilai tanggal dan waktu.

Contoh berikut mencakup penentu format kustom "fff" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
        // Displays 07:27:15:018

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
        // Displays 07:27:15:018
    }
in
    Source

Kembali ke tabel

Penentu format kustom "ffff"

Penentu format kustom "ffff" mewakili empat digit paling signifikan dari pecahan detik; artinya, mewakili sepuluh ribu detik dalam nilai tanggal dan waktu.

Meskipun dimungkinkan untuk menampilkan sepuluh ribu komponen kedua dari nilai waktu, nilai tersebut mungkin tidak bermakna. Presisi nilai tanggal dan waktu tergantung resolusi jam sistem. Pada sistem operasi Windows Server 2019 dan Windows 11, resolusi jam sekitar 1 milidetik.

Kembali ke tabel

Penentu format kustom "fffff"

Penentu format kustom "fffff" mewakili lima digit paling signifikan dari pecahan detik; artinya, mewakili seratus ribu detik dalam nilai tanggal dan waktu.

Meskipun dimungkinkan untuk menampilkan seratus ribu komponen kedua dari nilai waktu, nilai tersebut mungkin tidak bermakna. Presisi nilai tanggal dan waktu tergantung resolusi jam sistem. Pada sistem operasi Windows Server 2019 dan Windows 11, resolusi jam sekitar 1 milidetik.

Kembali ke tabel

Penentu format kustom "ffffff"

Penentu format kustom "ffffff" mewakili enam digit paling signifikan dari pecahan detik; artinya, itu mewakili jutaan detik dalam nilai tanggal dan waktu.

Meskipun dimungkinkan untuk menampilkan sejuta komponen kedua dari nilai waktu, nilai tersebut mungkin tidak bermakna. Presisi nilai tanggal dan waktu tergantung resolusi jam sistem. Pada sistem operasi Windows Server 2019 dan Windows 11, resolusi jam sekitar 1 milidetik.

Kembali ke tabel

Penentu format kustom "fffffff"

Penentu format kustom "fffffff" mewakili tujuh digit paling signifikan dari pecahan detik; artinya, itu mewakili sepuluh juta detik dalam nilai tanggal dan waktu.

Meskipun dimungkinkan untuk menampilkan sepuluh juta dari komponen kedua dari nilai waktu, nilai tersebut mungkin tidak bermakna. Presisi nilai tanggal dan waktu tergantung resolusi jam sistem. Pada sistem operasi Windows Server 2019 dan Windows 11, resolusi jam sekitar 1 milidetik.

Kembali ke tabel

Penentu pecahan "F" detik huruf besar

Penentu format kustom "F"

Penentu format kustom "F" mewakili digit paling signifikan dari pecahan detik; artinya, mewakili persepuluh detik dalam nilai tanggal dan waktu. Tidak ada yang ditampilkan jika digit adalah nol, dan titik desimal yang mengikuti jumlah detik juga tidak ditampilkan.

Jika penentu format "F" digunakan tanpa penentu format lain, itu ditafsirkan sebagai penentu format tanggal dan waktu standar "F". Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Jumlah penentu format "F" yang digunakan saat penguraian menunjukkan jumlah maksimum digit paling signifikan dari pecahan detik yang dapat hadir untuk berhasil mengurai string.

Contoh berikut menyertakan penentu format kustom "F" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
        // Displays 07:27:15:0

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
        // Displays 07:27:15:
    }
in
    Source

Kembali ke tabel

Penentu format kustom "FF"

Penentu format kustom "FF" mewakili dua digit paling signifikan dari pecahan detik; artinya, ini mewakili per seratus detik dalam nilai tanggal dan waktu. Nol berikutnya tidak ditampilkan. Tidak ada yang ditampilkan jika dua digit signifikan adalah nol, dan dalam hal ini titik desimal yang mengikuti jumlah detik juga tidak ditampilkan.

Contoh berikut mencakup penentu format kustom "FF" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
        // Displays 07:27:15:01

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
        // Displays 07:27:15:01
    }
in
    Source

Kembali ke tabel

Penentu format kustom "FFF"

Penentu format kustom "FFF" mewakili tiga digit paling signifikan dari pecahan detik; artinya, mewakili milidetik dalam nilai tanggal dan waktu. Nol berikutnya tidak ditampilkan. Tidak ada yang ditampilkan jika tiga digit signifikan adalah nol, dan dalam hal ini titik desimal yang mengikuti jumlah detik juga tidak ditampilkan.

Contoh berikut mencakup penentu format kustom "FFF" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
        // Displays 07:27:15:018

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
        // Displays 07:27:15:018
    }
in
    Source

Kembali ke tabel

Penentu format kustom "FFFF"

Penentu format kustom "FFFF" mewakili empat digit paling signifikan dari pecahan detik; artinya, mewakili sepuluh ribu detik dalam nilai tanggal dan waktu. Nol berikutnya tidak ditampilkan. Tidak ada yang ditampilkan jika empat digit signifikan adalah nol, dan dalam hal ini titik desimal yang mengikuti jumlah detik juga tidak ditampilkan.

Meskipun dimungkinkan untuk menampilkan sepuluh ribu komponen kedua dari nilai waktu, nilai tersebut mungkin tidak bermakna. Presisi nilai tanggal dan waktu tergantung resolusi jam sistem. Pada sistem operasi Windows Server 2019 dan Windows 11, resolusi jam sekitar 1 milidetik.

Kembali ke tabel

Penentu format kustom "FFFFF"

Penentu format kustom "FFFFF" mewakili lima digit paling signifikan dari pecahan detik; artinya, mewakili seratus ribu detik dalam nilai tanggal dan waktu. Nol berikutnya tidak ditampilkan. Tidak ada yang ditampilkan jika lima digit signifikan adalah nol, dan dalam hal ini titik desimal yang mengikuti jumlah detik juga tidak ditampilkan.

Meskipun dimungkinkan untuk menampilkan seratus ribu komponen kedua dari nilai waktu, nilai tersebut mungkin tidak bermakna. Presisi nilai tanggal dan waktu tergantung resolusi jam sistem. Pada sistem operasi Windows Server 2019 dan Windows 11, resolusi jam sekitar 1 milidetik.

Kembali ke tabel

Penentu format kustom "FFFFFF"

Penentu format kustom "FFFFFF" mewakili enam digit paling signifikan dari pecahan detik; artinya, itu mewakili jutaan detik dalam nilai tanggal dan waktu. Nol berikutnya tidak ditampilkan. Tidak ada yang ditampilkan jika enam digit signifikan adalah nol, dan dalam hal ini titik desimal yang mengikuti jumlah detik juga tidak ditampilkan.

Meskipun dimungkinkan untuk menampilkan sejuta komponen kedua dari nilai waktu, nilai tersebut mungkin tidak bermakna. Presisi nilai tanggal dan waktu tergantung resolusi jam sistem. Pada sistem operasi Windows Server 2019 dan Windows 11, resolusi jam sekitar 1 milidetik.

Kembali ke tabel

Penentu format kustom "FFFFFFF"

Penentu format kustom "FFFFFFF" mewakili tujuh digit paling signifikan dari pecahan detik; artinya, itu mewakili sepuluh juta detik dalam nilai tanggal dan waktu. Nol berikutnya tidak ditampilkan. Tidak ada yang ditampilkan jika tujuh digit signifikan adalah nol, dan dalam hal ini titik desimal yang mengikuti jumlah detik juga tidak ditampilkan.

Meskipun dimungkinkan untuk menampilkan sepuluh juta dari komponen kedua dari nilai waktu, nilai tersebut mungkin tidak bermakna. Presisi nilai tanggal dan waktu tergantung resolusi jam sistem. Pada sistem operasi Windows Server 2019 dan Windows 11, resolusi jam sekitar 1 milidetik.

Kembali ke tabel

Penentu format Era "g"

Penentu format kustom "g" atau "gg"

Penentu format kustom "g" atau "gg" (ditambah sejumlah penentu "g" tambahan) mewakili periode atau era, seperti M. Operasi pemformatan mengabaikan penentu ini jika tanggal yang akan diformat tidak memiliki periode atau string era terkait.

Jika penentu format "g" digunakan tanpa penentu format kustom lainnya, itu ditafsirkan sebagai penentu format tanggal dan waktu standar "g". Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut menyertakan penentu format kustom "g" dalam string format kustom.

let
    Source =
    {
        Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = ""]),
        // Displays 08/04/0070 A.D.

        Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = "fr-FR"])
        // Displays 08/04/0070 ap. J.-C.
    }
in
    Source

Kembali ke tabel

Penentu format "h" jam huruf kecil

Penentu format kustom "h"

Penentu format kustom "h" mewakili jam sebagai angka dari 1 hingga 12; artinya, jam diwakili oleh jam 12 jam yang menghitung seluruh jam sejak tengah malam atau siang. Jam tertentu setelah tengah malam tidak dapat dibedakan dari jam yang sama setelah siang. Jam tidak dibulatkan, dan satu digit jam diformat tanpa nol di depannya. Misalnya, mengingat waktu 05.43 di pagi atau sore hari, penentu format kustom ini menampilkan "5".

Jika penentu format "h" digunakan tanpa penentu format kustom lainnya, itu ditafsirkan sebagai penentu format tanggal dan waktu standar dan memunculkan kesalahan ekspresi. Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut mencakup penentu format kustom "h" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

Kembali ke tabel

Penentu format kustom "hh"

Penentu format kustom "hh" (ditambah sejumlah penentu "h" tambahan) mewakili jam sebagai angka dari 01 hingga 12; artinya, jam diwakili oleh jam 12 jam yang menghitung seluruh jam sejak tengah malam atau siang. Jam tertentu setelah tengah malam tidak dapat dibedakan dari jam yang sama setelah siang. Jam tidak dibulatkan, dan satu digit jam diformat dengan nol di depannya. Misalnya, mengingat waktu 05.43 di pagi hari atau sore hari, penentu format ini menampilkan "05".

Contoh berikut mencakup penentu format kustom "hh" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

Kembali ke tabel

Penentu format "H" jam huruf besar

Penentu format kustom "h"

Penentu format kustom "H" mewakili jam sebagai angka dari 0 hingga 23; artinya, jam diwakili oleh jam 24 jam berbasis nol yang menghitung jam sejak tengah malam. Satu digit jam diformat tanpa nol di depannya.

Jika penentu format "H" digunakan tanpa penentu format kustom lainnya, penentu format ini ditafsirkan sebagai penentu format tanggal dan waktu standar dan memunculkan kesalahan ekspresi. Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut mencakup penentu format kustom "H" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "H:mm:ss", Culture = ""])
        // Displays 6:09:01
    }
in
    Source

Kembali ke tabel

Penentu format kustom "HH"

Penentu format kustom "HH" (ditambah sejumlah penentu "H" tambahan) mewakili jam sebagai angka dari 00 hingga 23; artinya, jam diwakili oleh jam 24 jam berbasis nol yang menghitung jam sejak tengah malam. Satu digit jam diformat dengan nol di depannya.

Contoh berikut mencakup penentu format kustom "HH" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "HH:mm:ss", Culture = ""])
        // Displays 06:09:01
    }
in
    Source

Kembali ke tabel

Penentu format "K" zona waktu

Penentu format kustom "K"

Penentu format kustom "K" mewakili informasi zona waktu dari nilai tanggal dan waktu. Ketika penentu format ini digunakan dengan nilai DateTimeZone , string hasil didefinisikan sebagai:

  • Untuk zona waktu lokal, penentu ini menghasilkan string hasil yang berisi offset lokal dari Waktu Universal Terkoordinasi (UTC), misalnya, "-07:00", jika kueri Anda berjalan di Power Query Desktop. Jika kueri Anda berjalan di Power Query Online, string hasil tidak menghasilkan offset dari waktu UTC, yaitu, "+00:00".

  • Untuk waktu UTC, string hasil tidak menghasilkan offset dari waktu UTC; yaitu, "+00:00 untuk mewakili tanggal UTC.

  • Untuk waktu dari zona waktu yang tidak ditentukan, hasilnya kosong.

Jika penentu format "K" digunakan tanpa penentu format kustom lainnya, penentu format ini ditafsirkan sebagai penentu format tanggal dan waktu standar dan memunculkan kesalahan ekspresi. Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut menampilkan string yang dihasilkan dari penggunaan penentu format kustom "K" dengan berbagai nilai pada sistem di zona Waktu Pasifik AS.

let
    Source =
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(),[Format="%K"]),
        // Displays -07:00 (Desktop) or +00:00 (Online)

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="%K"]),
        // Displays +00:00

        Text.Format("'#{0}'", {DateTime.ToText(DateTime.LocalNow(),[Format="%K"])})
        // Displays ''
    }
in
    Source

Catatan

Nilai yang dikembalikan oleh DateTimeZone.LocalNow 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 AS, Power Query Desktop kembali 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.

Kembali ke tabel

Penentu format "m" menit

Penentu format kustom "m"

Penentu format kustom "m" mewakili menit sebagai angka dari 0 hingga 59. Menit mewakili seluruh menit yang telah berlalu sejak satu jam terakhir. Satu digit menit diformat tanpa nol di depannya.

Jika penentu format "m" digunakan tanpa penentu format kustom lainnya, itu ditafsirkan sebagai penentu format tanggal dan waktu standar "m". Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut menyertakan penentu format kustom "m" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

Kembali ke tabel

Penentu format kustom "mm"

Penentu format kustom "mm" (ditambah sejumlah penentu "m" tambahan) mewakili menit sebagai angka dari 00 hingga 59. Menit mewakili seluruh menit yang telah berlalu sejak satu jam terakhir. Satu digit menit diformat dengan nol di depannya.

Contoh berikut mencakup penentu format kustom "mm" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

Kembali ke tabel

Penentu format "M" bulan

Penentu format kustom "M"

Penentu format kustom "M" mewakili bulan sebagai angka dari 1 hingga 12 (atau dari 1 hingga 13 untuk kalender yang memiliki 13 bulan). Bulan satu digit diformat tanpa nol di depannya.

Jika penentu format "M" digunakan tanpa penentu format kustom lainnya, itu ditafsirkan sebagai penentu format tanggal dan waktu standar "M". Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut menyertakan penentu format kustom "M" dalam string format kustom.

let
    Source =
    {
        Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "en-US"]),
        // Displays (8) Aug, August

        Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "nl-NL"]),
        // Displays (8) aug, augustus

        Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "lv-LV"])
        // Displays (8) aug., augusts
    }
in
    Source

Kembali ke tabel

Penentu format kustom "MM"

Penentu format kustom "MM" mewakili bulan sebagai angka dari 01 hingga 12 (atau dari 1 hingga 13 untuk kalender yang memiliki 13 bulan). Bulan satu digit diformat dengan nol di depannya.

Contoh berikut mencakup penentu format kustom "MM" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
        // Displays 02, 01
    }
in
    Source

Kembali ke tabel

Penentu format kustom "MMM"

Penentu format kustom "MMM" mewakili nama singkatan bulan tersebut. Nama singkatan yang dilokalkan dari bulan diambil dari nama bulan yang disingkat dari budaya saat ini atau yang ditentukan. Jika ada penentu format kustom "d" atau "dd" dalam string format kustom, nama bulan diambil dari nama genitif yang disingkat sebagai gantinya.

Contoh berikut mencakup penentu format kustom "MMM" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
        // Displays Thu 29 Aug

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
        // Displays jeu. 29 août
    }
in
    Source

Kembali ke tabel

Penentu format kustom "MMMM"

Penentu format kustom "MMMM" mewakili nama lengkap bulan tersebut. Nama bulan yang dilokalkan diambil dari budaya saat ini atau yang ditentukan. Jika ada penentu format kustom "d" atau "dd" dalam string format kustom, nama bulan diambil dari nama genitif yang disingkat sebagai gantinya.

Contoh berikut mencakup penentu format kustom "MMMM" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
        // Displays Thursday 29 August

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
        // Displays giovedì 29 agosto
    }
in
    Source

Kembali ke tabel

Penentu format "s" detik

Penentu format kustom "s"

Penentu format kustom "s" mewakili detik sebagai angka dari 0 hingga 59. Hasilnya mewakili seluruh detik yang telah berlalu sejak menit terakhir. Satu digit detik diformat tanpa nol di depannya.

Jika penentu format "s" digunakan tanpa penentu format kustom lainnya, itu ditafsirkan sebagai penentu format tanggal dan waktu standar "s". Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut menyertakan penentu format kustom "s" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

Kembali ke tabel

Penentu format kustom "ss"

Penentu format kustom "ss" (ditambah sejumlah penentu "s" tambahan) mewakili detik sebagai angka dari 00 hingga 59. Hasilnya mewakili seluruh detik yang telah berlalu sejak menit terakhir. Satu digit detik diformat dengan nol di depannya.

Contoh berikut menyertakan penentu format kustom "ss" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

Kembali ke tabel

Penentu format "t" meridiem

Penentu format kustom "t"

Penentu format kustom "t" mewakili karakter pertama penunjuk AM/PM. Perancang yang dilokalkan yang sesuai diambil dari budaya saat ini atau tertentu. Penunjuk AM digunakan untuk semua waktu dari pukul 0:00:00 (tengah malam) hingga 11:59:59.999. Penunjuk PM digunakan untuk semua waktu dari pukul 12:00:00 (siang) hingga 23:59:59.999.

Jika penentu format "t" digunakan tanpa penentu format kustom lainnya, itu ditafsirkan sebagai penentu format tanggal dan waktu standar "t". Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut menyertakan penentu format kustom "t" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

Kembali ke tabel

Penentu format kustom "tt"

Penentu format kustom "tt" (ditambah sejumlah penentu "t" tambahan) mewakili seluruh penunjuk AM/PM. Perancang yang dilokalkan yang sesuai diambil dari budaya saat ini atau tertentu. Penunjuk AM digunakan untuk semua waktu dari pukul 0:00:00 (tengah malam) hingga 11:59:59.999. Penunjuk PM digunakan untuk semua waktu dari pukul 12:00:00 (siang) hingga 23:59:59.999.

Pastikan untuk menggunakan penentu "tt" untuk bahasa yang perlu mempertahankan perbedaan antara AM dan PM. Contohnya adalah Bahasa Jepang, di mana penunjuk AM dan PM berbeda dalam karakter kedua dan bukan karakter pertama.

Contoh berikut menyertakan penentu format kustom "tt" dalam string format kustom.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

Kembali ke tabel

Penentu format "y" tahun

Penentu format kustom "y"

Penentu format kustom "y" mewakili tahun sebagai angka satu digit atau dua digit. Jika tahun memiliki lebih dari dua digit, hanya dua digit urutan rendah yang muncul dalam hasilnya. Jika digit pertama dari dua digit tahun dimulai dengan nol (misalnya, 2008), angka tersebut diformat tanpa nol di depannya.

Jika penentu format "y" digunakan tanpa penentu format kustom lainnya, itu ditafsirkan sebagai penentu tanggal dan format waktu standar "y". Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut menyertakan penentu format kustom "y" dalam string format kustom.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "%y"]),
        // Displays 1

        Date.ToText(#date(2024, 1, 1), [Format = "%y"])
        // Displays 24
    }
in
    Source

Kembali ke tabel

Penentu format kustom "yy"

Penentu format kustom "yy" mewakili tahun sebagai angka dua digit. Jika tahun memiliki lebih dari dua digit, hanya dua digit urutan rendah yang muncul dalam hasilnya. Jika tahun dua digit memiliki kurang dari dua digit signifikan, angka tersebut dilapisi dengan nol di depannya untuk menghasilkan dua digit.

Dalam operasi penguraian, tahun dua digit yang diurai menggunakan penentu format kustom "yy" ditafsirkan berdasarkan kalender penyedia format saat ini. Contoh berikut menguraikan representasi string dari tanggal yang memiliki dua digit tahun dengan menggunakan kalender Gregorian default dari budaya en-US, yang, dalam hal ini, adalah budaya saat ini. Nilai yang dikembalikan untuk tanggal empat digit bergantung pada rentang 100 tahun yang ditetapkan oleh sistem operasi.

let
    // Define the date format and value
    fmt = "dd-MMM-yy",

    // Convert year 49 to a 4-digit year
    firstDate = Text.Format("#{0}", { Date.FromText("24-Jan-49", [Format = fmt]) }),

    // Convert year 50 to a 4-digit year
    finalDate = Text.Format("#{0}", { Date.FromText("24-Jan-50", [Format = fmt]) }),
    Heading = "Default Two Digit Year Range: 1950 - 2049",
    result = {Heading, firstDate, finalDate}
in
    result

// The example displays the following output:
//       Default Two Digit Year Range: 1950 - 2049
//       1/24/2049
//       1/24/1950

Contoh berikut menyertakan penentu format kustom "yy" dalam string format kustom.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yy"]),
        // Displays 01

        Date.ToText(#date(2024, 1, 1), [Format = "yy"])
        // Displays 24
    }
in
    Source

Kembali ke tabel

Penentu format kustom "yyy"

Penentu format kustom "yyy" mewakili tahun dengan minimal tiga digit. Jika tahun memiliki lebih dari tiga digit signifikan, mereka disertakan dalam string hasil. Jika tahun memiliki kurang dari tiga digit, angka tersebut dilapisi dengan nol di depannya untuk menghasilkan tiga digit.

Catatan

Untuk kalender Buddha Thailand, yang dapat memiliki lima digit tahun, penentu format ini menampilkan semua digit signifikan.

Contoh berikut menyertakan penentu format kustom "yyy" dalam string format kustom.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyy"]),
        // Displays 001

        Date.ToText(#date(2024, 1, 1), [Format = "yyy"])
        // Displays 2024
    }
in
    Source

Kembali ke tabel

Penentu format kustom "yyyy"

Penentu format kustom "yyyy" mewakili tahun dengan minimal empat digit. Jika tahun ini memiliki lebih dari empat digit yang signifikan, mereka termasuk dalam string hasil. Jika tahun memiliki kurang dari empat digit, angka dilapisi dengan nol di depannya untuk menghasilkan empat digit.

Catatan

Untuk kalender Buddha Thailand, yang dapat memiliki lima digit tahun, penentu format ini menampilkan minimal empat digit.

Contoh berikut menyertakan penentu format kustom "yyyy" dalam string format kustom.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyyy"]),
        // Displays 0001

        Date.ToText(#date(2024, 1, 1), [Format = "yyyy"])
        // Displays 2024
    }
in
    Source

Kembali ke tabel

Penentu format kustom "yyyyy"

Penentu format kustom "yyyyy" (ditambah sejumlah penentu "y" tambahan) mewakili tahun dengan minimal lima digit. Jika tahun memiliki lebih dari lima digit signifikan, mereka disertakan dalam string hasil. Jika tahun memiliki kurang dari lima digit, angka tersebut dilapisi dengan nol di depannya untuk menghasilkan lima digit.

Jika ada penentu "y" tambahan, angka tersebut dilapisi dengan nol di depan sebanyak yang diperlukan untuk menghasilkan jumlah penentu "y".

Contoh berikut menyertakan penentu format kustom "yyyyy" dalam string format kustom.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyyyy"]),
        // Displays 00001

        Date.ToText(#date(2024, 1, 1), [Format = "yyyyy"])
        // Displays 02024
    }
in
    Source

Kembali ke tabel

Offset penentu format "z"

Penentu format kustom "z"

Dengan nilai DateTimeZone , penentu format kustom "z" mewakili offset yang ditandatangani dari zona waktu yang ditentukan dari Waktu Universal Terkoordinasi (UTC), diukur dalam jam. Offset selalu ditampilkan dengan tanda di awal. Tanda plus (+) menunjukkan jam sebelum UTC, dan tanda minus (-) menunjukkan jam di belakang UTC. Offset satu digit diformat tanpa nol di awal.

Tabel berikut ini memperlihatkan bagaimana nilai offset berubah tergantung pada fungsi DateTimeZone .

Nilai DateTimeZone Nilai Offset
DateTimeZone.LocalNow Di Power Query Desktop, offset yang ditandatangani dari zona waktu sistem operasi lokal dari UTC. Di Power Query Online, mengembalikan +00.
DateTimeZone.UtcNow Menampilkan +0.

Jika penentu format "z" digunakan tanpa penentu format kustom lainnya, penentu format ini ditafsirkan sebagai penentu format tanggal dan waktu standar dan memunculkan kesalahan ekspresi. Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Contoh berikut mencakup penentu format kustom "z" dalam string format kustom pada sistem di zona Waktu Pasifik A.S.

let
    Source = 
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:%z}"]),
        // Displays {0:-7} on Power Query Desktop
        // Displays {0:+0} on Power Query Online

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:%z}"]),
        // Displays {0:+0}

        DateTimeZone.ToText(DateTimeZone.SwitchZone(
            #datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6), 
            [Format = "{0:%z}"]
        )
        // Displays {0:+6}
    }
in
    Source

Catatan

Nilai yang dikembalikan oleh DateTimeZone.LocalNow bergantung pada apakah Anda menjalankan Power Query di komputer lokal atau online. Misalnya, dalam sampel di atas pada sistem di zona Waktu Pasifik {0:-7} AS, Power Query Desktop kembali karena membaca waktu yang ditetapkan pada komputer lokal Anda. Namun, Power Query Online kembali {0:+0} karena membaca waktu yang diatur pada komputer virtual cloud, yang diatur ke UTC.

Kembali ke tabel

Penentu format kustom "zz"

Dengan nilai DateTimeZone , penentu format kustom "zz" mewakili offset yang ditandatangani dari zona waktu yang ditentukan dari UTC, diukur dalam jam. Offset selalu ditampilkan dengan tanda di awal. Tanda plus (+) menunjukkan jam sebelum UTC, dan tanda minus (-) menunjukkan jam di belakang UTC. Offset satu digit diformat dengan nol di awal.

Tabel berikut ini memperlihatkan bagaimana nilai offset berubah tergantung pada fungsi DateTimeZone .

Nilai DateTimeZone Nilai Offset
DateTimeZone.LocalNow Di Power Query Desktop, offset yang ditandatangani dari zona waktu sistem operasi lokal dari UTC. Di Power Query Online, mengembalikan +00.
DateTimeZone.UtcNow Menampilkan +00.

Contoh berikut mencakup penentu format kustom "zz" dalam string format kustom pada sistem di zona Waktu Pasifik A.S.

let
    Source = 
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zz}"]),
        // Displays {0:-07} on Power Query Desktop
        // Displays {0:+00} on Power Query Online

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zz}"]),
        // Displays {0:+00}

        DateTimeZone.ToText(DateTimeZone.SwitchZone(
            #datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6), 
            [Format = "{0:zz}"]
        )
        // Displays {0:+06}
    }
in
    Source

Catatan

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

Kembali ke tabel

Penentu format kustom "zzz"

Dengan nilai DateTimeZone , penentu format kustom "zzz" mewakili offset yang ditandatangani dari zona waktu yang ditentukan dari UTC, diukur dalam jam dan menit. Offset selalu ditampilkan dengan tanda di awal. Tanda plus (+) menunjukkan jam sebelum UTC, dan tanda minus (-) menunjukkan jam di belakang UTC. Offset satu digit diformat dengan nol di awal.

Tabel berikut ini memperlihatkan bagaimana nilai offset berubah tergantung pada fungsi DateTimeZone .

Nilai DateTimeZoneValue Nilai Offset
DateTimeZone.LocalNow Di Power Query Desktop, offset yang ditandatangani dari zona waktu sistem operasi lokal dari UTC. Di Power Query Online, mengembalikan +00.
DateTimeZone.UtcNow Menampilkan +00:00.

Contoh berikut mencakup penentu format kustom "zzz" dalam string format kustom pada sistem di zona Waktu Pasifik A.S.

let
    Source = 
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zzz}"]),
        // Displays {0:-07:00} on Power Query Desktop
        // Displays {0:+00:00} on Power Query Online

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zzz}"]),
        // Displays {0:+00:00}

        DateTimeZone.ToText(DateTimeZone.SwitchZone(
            #datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6), 
            [Format = "{0:zzz}"]
        )
        // Displays {0:+06:00}
    }
in
    Source

Catatan

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

Kembali ke tabel

Penentu pemisah tanggal dan waktu

Penentu format kustom ":"

Penentu format khusus ":" mewakili pemisah waktu, yang digunakan untuk membedakan jam, menit, dan detik. Pemisah waktu yang dilokalkan yang sesuai diambil dari budaya saat ini atau yang ditentukan.

Catatan

Untuk mengubah pemisah waktu untuk string tanggal dan waktu tertentu, tentukan karakter pemisah di dalam pembatas string harfiah. Misalnya, string hh_dd_ss format kustom menghasilkan string hasil di mana "_" (garis bawah) selalu digunakan sebagai pemisah waktu.

Jika penentu format ":" digunakan tanpa penentu format kustom lainnya, penentu format format tanggal dan waktu standar ditafsirkan sebagai penentu format tanggal dan waktu standar dan memunculkan kesalahan ekspresi. Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Kembali ke tabel

Penentu format kustom "/"

Penentu format kustom "/" mewakili pemisah tanggal, yang digunakan untuk membedakan tahun, bulan, dan hari. Pemisah tanggal yang dilokalkan yang sesuai diambil dari budaya saat ini atau yang ditentukan.

Catatan

Untuk mengubah pemisah tanggal untuk string tanggal dan waktu tertentu, tentukan karakter pemisah dalam pemisah string harfiah. Misalnya, string format khusus mm/dd/yyyy menghasilkan string hasil di mana "/" selalu digunakan sebagai pemisah tanggal.

Jika penentu format "/" digunakan tanpa penentu format kustom lainnya, penentu format ini ditafsirkan sebagai penentu format tanggal dan waktu standar dan memunculkan kesalahan ekspresi. Untuk informasi selengkapnya tentang menggunakan penentu format tunggal, buka Menggunakan Penentu Format Kustom Tunggal nanti di artikel ini.

Kembali ke tabel

Harfiah karakter

Karakter berikut dalam string format tanggal dan waktu khusus dicadangkan dan selalu ditafsirkan sebagai karakter pemformatan atau, dalam hal ", ', /, dan \, sebagai karakter khusus.

  • F
  • H
  • K
  • M
  • d
  • f
  • g
  • h
  • m
  • s
  • t
  • y
  • z
  • %
  • :
  • /
  • "
  • '
  • \

Semua karakter lain selalu ditafsirkan sebagai harfiah karakter dan, dalam operasi pemformatan, disertakan dalam string hasil tanpa diubah. Dalam operasi penguraian, mereka harus mencocokkan karakter dalam string input dengan tepat; perbandingannya peka huruf besar/kecil.

Contoh berikut menyertakan karakter harfiah "PST" (untuk Waktu Standar Pasifik) dan "PDT" (untuk Waktu Musim Panas Pasifik) untuk mewakili zona waktu lokal dalam format string. Perhatikan bahwa string disertakan dalam string hasil, dan bahwa string yang menyertakan string zona waktu lokal juga berhasil diurai.

let
    #"Date Formats" = {"dd MMM yyyy hh:mm tt PST", "dd MMM yyyy hh:mm tt PDT"},
    Source = 
    {
        DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Formats"{1}]),
        try DateTime.ToText(DateTime.FromText(
            "25 Dec 2023 12:00 pm PST", [Format = #"Date Formats"{0}])) 
            otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm PST" & "'"
    }
in
    Source

// The example displays the following output text:
//       18 Aug 2024 04:50 PM PDT
//       12/25/2023 12:00:00 PM

Ada dua cara untuk menunjukkan bahwa karakter harus ditafsirkan sebagai karakter harfiah dan bukan sebagai karakter cadangan, sehingga karakter tersebut dapat disertakan dalam string hasil atau berhasil diuraikan dalam string input:

  • Dengan melarikan diri dari setiap karakter khusus. Untuk informasi selengkapnya, buka Menggunakan urutan escape.

    Contoh berikut mencakup karakter harfiah "pst" (untuk waktu Standar Pasifik) untuk mewakili zona waktu lokal dalam string format. Karena "s" dan "t" keduanya adalah string format khusus, kedua karakter harus di-escape untuk ditafsirkan sebagai harfiah karakter.

    let
      #"Date Format" = "dd MMM yyyy hh:mm tt p's''t'",
      Source = 
      {
          DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Format"]),
          try DateTime.ToText(DateTime.FromText(
              "25 Dec 2023 12:00 pm pst", [Format = #"Date Format"]))
              otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm pst" & "'"
      }
in
      Source

// The example displays the following output text:
//       18 Aug 2024 04:50 PM pst
//       12/25/2016 12:00:00 PM

  • Dengan mengapit seluruh string harfiah dalam apostrof. Contoh berikut seperti yang sebelumnya, kecuali bahwa "pst" diapit dalam apostrof untuk menunjukkan bahwa seluruh string yang dibatasi harus ditafsirkan sebagai literal karakter.

    let
      #"Date Format" = "dd MMM yyyy hh:mm tt 'pst'",
      Source = 
      {
          DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Format"]),
          try DateTime.ToText(DateTime.FromText(
              "25 Dec 2023 12:00 pm pst", [Format = #"Date Format"]))
              otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm pst" & "'"
      }
in
      Source

// The example displays the following output text:
//       18 Aug 2024 04:50 PM pst
//       12/25/2016 12:00:00 PM

Catatan

Menggunakan penentu format kustom tunggal

String format tanggal dan waktu kustom terdiri dari dua karakter atau lebih. Metode pemformatan tanggal dan waktu menginterpretasikan string karakter tunggal apa pun sebagai string format tanggal dan waktu standar. Jika mereka tidak mengenali karakter sebagai penentu format yang valid, karakter tersebut akan menampilkan kesalahan ekspresi. Misalnya, string format yang hanya terdiri dari penentu "h" ditafsirkan sebagai string format tanggal dan waktu standar. Namun, dalam kasus khusus ini, pengecualian ditampilkan karena tidak ada penentu tanggal dan format waktu standar "h".

Untuk menggunakan salah satu penentu format tanggal dan waktu kustom sebagai satu-satunya penentu dalam string format (yaitu, menggunakan "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", atau "/" penentu format khusus dengan sendirinya), sertakan spasi sebelum atau sesudah penentu, atau sertakan penentu format persen ("%") sebelum penentu tanggal dan waktu khusus tunggal.

Misalnya, "%h" ditafsirkan sebagai string format tanggal dan waktu kustom yang menampilkan jam yang diwakili oleh nilai tanggal dan waktu saat ini. Anda juga dapat menggunakan string format " h" atau "h ", meskipun ini menyertakan spasi dalam string hasil bersama dengan jam. Contoh berikut mengilustrasikan ketiga string format ini.

let
    date = #datetime(2024, 6, 15, 13, 45, 0),
    Source =
    {
        Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "%h"])}),
        Text.Format("'#{0}'", {DateTime.ToText(date, [Format = " h"])}),
        Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "h "])})
    }
in
    Source

// The example displays a list with the following output text, 
//   with <sp> representing a space:
//       '1'
//       ' 1'
//       '1 '

Menggunakan urutan escape

"d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", " z", ":", atau "/" karakter dalam string format ditafsirkan sebagai penentu format khusus daripada sebagai karakter harfiah.

Untuk mencegah karakter ditafsirkan sebagai penentu format, Anda dapat:

  • Mendahuluinya dengan garis miring terbalik.
  • Kelilingi dengan satu kutipan.
  • Kelilingi dengan dua tanda kutip ganda.

Masing-masing karakter ini bertindak sebagai urutan escape. Urutan escape menandakan bahwa karakter berikut atau karakter yang dikelilingi adalah teks literal yang harus disertakan dalam string hasil yang tidak berubah.

Untuk menyertakan tanda kutip ganda dalam string hasil, Anda harus menghindarinya dengan tanda kutip ganda lainnya ("").

Contoh berikut menggunakan urutan escape yang berbeda untuk mencegah operasi pemformatan menginterpretasikan karakter "h" dan "m" sebagai penentu format.

let
    date = #datetime(2024, 6, 15, 13, 45, 30.90),
    format1 = "h \h m \m",
    format2 = "h ""h"" m ""m""",
    format3 = "h 'h' m 'm'",
    Source = 
    {
        Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format1, DateTime.ToText(date, format1)}),
        Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format2, DateTime.ToText(date, format2)}),
        Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format3, DateTime.ToText(date, format3)})
    }
in
    Source

// The example displays the following output text:
//       6/15/2024 1:45:30 PM (h \h m \m) -> 1 h 45 m
//       6/15/2024 1:45:30 PM (h "h" m "m") -> 1 h 45 m
//       6/15/2024 1:45:30 PM (h 'h' m 'm') -> 1 h 45 m

Konten terkait