Halaman ini diterjemahkan oleh Cloud Translation API.

Format tanggal & angka

Format tanggal-waktu dan angka memungkinkan Anda mengontrol tampilan data dalam sheet. Google Spreadsheet menyediakan beberapa format umum yang dapat dipilih, tetapi Anda juga dapat menentukan format sendiri.

Di UI Spreadsheet, Anda menerapkan format angka dan tanggal ke sel menggunakan menu Format > Number. Di Sheets API, Anda menetapkan format ini menggunakan panggilan metode spreadsheets.batchUpdate untuk mengirim UpdateCellsRequest atau RepeatCellRequest.

Halaman ini menjelaskan cara menentukan pola format tanggal dan angka yang baru, yang dapat Anda sertakan dalam permintaan API. Contoh Menyetel format khusus tanggal-waktu atau desimal untuk suatu rentang menunjukkan cara menetapkan pola format menggunakan API. Perhatikan bahwa rendering format yang sebenarnya bergantung pada locale spreadsheet. Panduan ini mengasumsikan bahwa locale adalah en_US. Anda dapat menentukan locale spreadsheet dengan membaca SpreadsheetProperties dengan permintaan spreadsheets.get.

Tentang nilai tanggal & waktu

Spreadsheet, seperti kebanyakan aplikasi spreadsheet lainnya, memperlakukan nilai tanggal dan waktu sebagai nilai desimal. Hal ini memungkinkan Anda melakukan aritmetika pada tanggal dan waktu dalam formula, sehingga Anda dapat menambahkan hari atau minggu, menambahkan atau mengurangi dua tanggal dan waktu, serta melakukan operasi serupa lainnya.

Spreadsheet menggunakan bentuk tanggal epoch yang biasa digunakan di spreadsheet. Bagian bilangan bulat dari nilai (kiri desimal) menghitung hari sejak 30 Desember 1899. Bagian pecahan (kanan desimal) menghitung waktu sebagai pecahan satu hari. Misalnya, 1 Januari 1900 pada siang hari adalah 2.5, 2 karena 2 hari setelah 30 Desember 1899, dan 0.5 karena siang adalah setengah hari. 1 Februari 1900 pukul 15.00 adalah 33.625.

Spreadsheet memperlakukan tahun 1900 dengan benar sebagai tahun biasa, bukan tahun kabisat.

Pola format tanggal & waktu

Pola format tanggal-waktu adalah string dari substring token yang, saat diuraikan, akan diganti dengan elemen tanggal-waktu yang sesuai (seperti bulan atau jam).

Token format tanggal & waktu

Tabel berikut menentukan substring token yang dapat Anda gunakan dalam pola format tanggal-waktu. Karakter + menunjukkan bahwa karakter sebelumnya dapat muncul satu atau beberapa kali dan tetap cocok dengan polanya. Karakter yang tidak tercantum dalam tabel di bawah akan diperlakukan sebagai literal, dan outputnya tanpa perubahan.

Token	Deskripsi
`h`	Jam dalam sehari. Beralih antara format 12 dan 24 jam bergantung pada apakah ada indikator AM atau PM dalam string.
`hh+`	Sama seperti sebelumnya, tetapi dengan 0 di depan untuk 1-9.
`m`	Jika token non-literal sebelumnya berupa jam atau token berikutnya adalah detik, token ini akan menyatakan menit dalam jam (tanpa 0 di depan). Jika tidak, maka yang dinyatakan adalah bulan dalam setahun sebagai angka (tanpa 0 di depan).
`M`	Bulan dalam tahun tanpa awalan 0. Gunakan token ini untuk menyatakan bulan secara eksplisit, bukan menit, dalam pola Anda.
`mm`	Sama seperti `m`, tetapi dengan 0 di depan untuk kedua kasus.
`MM`	Bulan dalam tahun dengan awalan 0. Gunakan token ini untuk menyatakan bulan secara eksplisit, bukan menit, dalam pola Anda.
`mmm`	Singkatan nama bulan tiga huruf (misalnya, "Feb").
`mmmm`	Nama bulan lengkap. `mmmmmm+` juga cocok dengan ini.
`mmmmm`	Huruf pertama bulan (misalnya, "J" untuk Juni).
`s`	Detik dalam menit tanpa 0 di depan.
`ss`	Detik dalam menit dengan awalan 0.
`[h+]`	Jumlah jam yang telah dilewati dalam satu durasi waktu. Jumlah huruf menunjukkan jumlah digit minimum (menambahkan 0 di depan).
`[m+]`	Jumlah menit yang telah berlalu dalam satu durasi waktu. Jumlah huruf menunjukkan jumlah digit minimum (menambahkan 0 di depan).
`[s+]`	Jumlah detik yang telah dilewati dalam satu durasi waktu. Jumlah huruf menunjukkan jumlah digit minimum (menambahkan 0 di depan).
`d`	Hari dalam sebulan, tanpa 0 di depan untuk angka yang kurang dari 10.
`dd`	Hari dalam sebulan, dengan 0 di depan untuk angka yang kurang dari 10.
`ddd`	Hari dalam seminggu, singkatan tiga huruf (misalnya, "Sen").
`dddd+`	Hari dalam seminggu, nama lengkap.
`y`	Tahun 2 digit.
`yy`	Tahun 2 digit.
`yyy`	Tahun 4 digit.
`yyyy+`	Tahun 4 digit.
`a/p`	Menampilkan "a" untuk AM, dan "p" untuk PM. Juga mengubah jam ke format 12 jam. Jika huruf token dijadikan huruf kapital, outputnya juga demikian.
`am/pm`	Seperti di atas, tetapi menampilkan "AM" atau "PM" sebagai gantinya dan selalu huruf kapital.
`0`	Persepuluh detik. Anda dapat meningkatkan presisi menjadi dua digit dengan `00` atau tiga digit (milidetik) dengan `000`.
`\`	Memperlakukan karakter berikutnya sebagai nilai literal dan bukan arti khusus yang mungkin dimilikinya.
`"text"`	Menampilkan teks apa pun di dalam tanda petik sebagai literal.

Contoh format tanggal & waktu

Berdasarkan tanggal dan waktu Tuesday, April 5, 2016, 4:08:53.528 PM, tabel berikut menampilkan beberapa contoh pola dan rendering tanggal-waktu yang sesuai. Bagian kedua tabel menunjukkan contoh format waktu yang telah dilewati selama 3 hours, 13 minutes, 41.255 seconds:

Pola Tanggal dan Waktu	`Tuesday, April 5, 2016, 4:08:53.528 PM`
`h:mm:ss.00 a/p`	4:08:53.53 p
`hh:mm A/P".M."`	04.08
`yyyy-mm-dd`	2016-04-05
`mmmm d \[dddd\]`	5 April [Selasa]
`h PM, ddd mmm dd`	16.00, Selasa, 05 April
`dddd, m/d/yy at h:mm`	Selasa, 4/5/16 pukul 16.08
Pola Waktu yang Dilewati	`3 hours, 13 minutes, 41.255 seconds`
`[hh]:[mm]:[ss].000`	03:13:41.255
`[mmmm]:[ss].000`	0193:41.255

Pola format angka

Pola format angka adalah string dari substring token yang, saat diuraikan, diganti dengan representasi angka yang sesuai. Pola format angka dapat terdiri dari maksimal empat bagian, yang dipisahkan dengan titik koma, yang menentukan format terpisah yang digunakan untuk angka positif, angka negatif, nol, dan teks (dalam urutan tersebut):

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

Anda tidak perlu menyertakan keempat bagian dalam satu format. Jika Anda hanya menyertakan satu bagian, format tersebut akan digunakan untuk semua nilai. Penggunaan dua bagian menyebabkan format pertama diterapkan ke bilangan nol dan positif, serta format kedua diterapkan ke bilangan negatif. Penggunaan tiga bagian mendefinisikan format terpisah untuk bilangan positif, negatif, dan nol. Contoh:

[NUMBER FORMAT]
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT]
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]

Namun, jika ada dua atau beberapa bagian dan bagian akhir adalah format teks, bagian tersebut akan diperlakukan sebagai format teks dan bagian lainnya akan berperilaku seolah-olah ada satu bagian yang kurang. Dengan demikian, dengan menyertakan format teks akhir, Anda dapat menentukan format seperti:

[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT]
[NUMBER FORMAT];[TEXT FORMAT]

Penguraian format menjadi beberapa bagian terjadi sebelum penguraian lainnya, sehingga format tanggal atau waktu dapat disertakan sebagai salah satu bagian (meskipun hal ini memiliki utilitas terbatas).

Token format angka

Tabel berikut menentukan substring token yang dapat Anda gunakan di bagian format untuk menentukan cara menampilkan nilai untuk bagian tersebut.

Token	Deskripsi
`0`	Merepresentasikan digit dalam angka. Jika digit tersebut adalah 0 yang tidak signifikan, maka akan dirender sebagai 0. Misalnya, format angka `00.0` merender angka 3 sebagai "`03.0`".
`#`	Merepresentasikan digit dalam angka. Jika digit tersebut adalah 0 yang tidak signifikan, maka tidak akan dirender. Misalnya, format angka `##0` merender angka 12 sebagai "`12`".
`?`	Merepresentasikan digit dalam angka. Jika digit tersebut adalah 0 yang tidak signifikan, maka akan dirender sebagai spasi. Ini sering kali digunakan untuk meratakan titik desimal di kolom saat menggunakan font berlebar tetap. Misalnya, format angka `???.???` merender angka 12,4 sebagai: " `12.4` ".
`.`	Tanda titik yang pertama menyatakan tanda titik desimal dalam bilangan. Tanda titik berikutnya akan dirender sebagai literal. Jika Anda menyertakan titik desimal dalam format tersebut, ia akan selalu dirender, bahkan untuk bilangan bulat. Misalnya, `#0.#` merender angka 3 sebagai "`3.`".
`%`	Muncul sebagai literal, tetapi juga menyebabkan angka yang ada dikalikan dengan 100 sebelum dirender untuk membuat persentase lebih mudah dibaca. Misalnya, format angka `#%` merender angka 0,25 sebagai "`25%`".
`,`	Jika muncul di antara karakter dua digit (`0`, `#`, atau `?`), karakter ini akan merender seluruh angka dengan pemisah pengelompokan (pengelompokan berdasarkan ribuan). Jika mengikuti karakter digit, ini akan menskalakan digit sebanyak seribu per koma (misalnya, format `#0.0,,` merender angka 12.200.000 sebagai `12.2`).
`E-`	Merender angka dalam format ilmiah, dengan pemformatan di sebelah kiri `E` yang digunakan untuk bagian non-pangkat dan pemformatan di sebelah kanan E yang digunakan untuk bagian pangkat. `E+` menampilkan tanda `+` untuk eksponen positif. `E-` hanya menampilkan tanda untuk eksponen negatif. Jika huruf kecil digunakan, output `e` juga akan menggunakan huruf kecil. Misalnya, format angka `##0.00#E+##` merender angka 0,0000001 sebagai "`100.00E-9`".
`E+`
`e-`
`e+`
`/`	Jika muncul di antara karakter dua digit (`0`, `#`, atau `?`), grup digit tersebut akan diperlakukan sebagai format pecahan. Misalnya, format angka `0 #/#` merender angka 23,25 sebagai `23 1/4`. Penyebut juga dapat berupa bilangan bulat literal, yang akan memberlakukan bilangan bulat tersebut sebagai penyebut. Format angka `0 #/8` menampilkan angka 23,25 sebagai `23 2/8`. Bagian pecahan tidak dirender jika pembilang menjadi 0. Angka 23,1 dengan format angka `0 #/3` dirender sebagai `23` (karena 0,1 dibulatkan menjadi 0/3). `/` tidak kompatibel dengan format ilmiah atau format dengan titik desimal di dalamnya.
`*`	Ini disertakan untuk kompatibilitas dengan format angka Microsoft Excel. Saat ini diabaikan.
`_`	Token garis bawah melewati karakter berikutnya dan merender spasi. Ini digunakan untuk merapikan format angka dengan nilai negatif diapit oleh tanda kurung.
`\`	Memperlakukan karakter berikutnya sebagai nilai literal dan bukan arti khusus yang mungkin dimilikinya. Misalnya, format angka `\#0` merender angka 10 sebagai "`#10`".
`"text"`	Menampilkan teks apa pun di dalam tanda petik sebagai literal.
`@`	Jika sel berisi input teks, sel tersebut akan menyisipkan teks mentah untuk sel. Tidak kompatibel dengan karakter khusus lainnya dan tidak ditampilkan untuk nilai numerik (yang ditampilkan sebagai format umum).
`$ - + ( ) : space`	Spreadsheet memperlakukan karakter ini sebagai literal dan menampilkannya tanpa perubahan.

Petunjuk meta

Selain itu, setiap bagian format dapat memiliki petunjuk meta opsional, yang diapit dalam karakter [], yang mendahului format dan memberikan petunjuk tambahan. Ada dua jenis petunjuk meta dan bagian tertentu dapat menggunakan keduanya:

Petunjuk Deskripsi

[condition] Mengganti perbandingan default positif, negatif, atau nol untuk bagian dengan ekspresi bersyarat lainnya. Misalnya, [<100]”Low”;[>1000]”High”;000 merender kata “Low” untuk nilai di bawah 100, “High” untuk nilai di atas 1000, dan angka tiga digit (dengan 0 di depan) untuk nilai di antaranya. Ketentuan hanya dapat diterapkan pada dua sub-format pertama dan jika suatu angka cocok dengan lebih dari satu, maka akan digunakan hasil pertama yang cocok dengan ketentuan. Jika ada format ketiga, format tersebut digunakan untuk "yang lainnya". Jika tidak, jika angka tidak cocok dengan format mana pun, angka tersebut akan dirender sebagai semua "#" yang mengisi lebar sel. Jika ada, format keempat selalu digunakan untuk teks.

[Color] or [Color#] Menyebabkan semua nilai yang dirender oleh sub-format ini muncul dengan warna teks yang diberikan. Nilai yang valid untuk Color adalah Hitam, Biru, Cyan, Hijau, Magenta, Merah, Putih, atau Kuning. Nilai yang valid untuk "#" di Color# adalah 1–56 (palet warna ini menampilkan daftar warna yang sesuai dengan setiap angka). Warna format angka akan menggantikan semua warna yang telah dimasukkan pengguna pada sel, tetapi tidak menggantikan warna yang disetel oleh pemformatan bersyarat.

Petunjuk	Deskripsi
`[condition]`	Mengganti perbandingan default positif, negatif, atau nol untuk bagian dengan ekspresi bersyarat lainnya. Misalnya, `[<100]”Low”;[>1000]”High”;000` merender kata “Low” untuk nilai di bawah 100, “High” untuk nilai di atas 1000, dan angka tiga digit (dengan 0 di depan) untuk nilai di antaranya. Ketentuan hanya dapat diterapkan pada dua sub-format pertama dan jika suatu angka cocok dengan lebih dari satu, maka akan digunakan hasil pertama yang cocok dengan ketentuan. Jika ada format ketiga, format tersebut digunakan untuk "yang lainnya". Jika tidak, jika angka tidak cocok dengan format mana pun, angka tersebut akan dirender sebagai semua "#" yang mengisi lebar sel. Jika ada, format keempat selalu digunakan untuk teks.
`[Color] or [Color#]`	Menyebabkan semua nilai yang dirender oleh sub-format ini muncul dengan warna teks yang diberikan. Nilai yang valid untuk `Color` adalah Hitam, Biru, Cyan, Hijau, Magenta, Merah, Putih, atau Kuning. Nilai yang valid untuk "#" di `Color#` adalah 1–56 (palet warna ini menampilkan daftar warna yang sesuai dengan setiap angka). Warna format angka akan menggantikan semua warna yang telah dimasukkan pengguna pada sel, tetapi tidak menggantikan warna yang disetel oleh pemformatan bersyarat.

Contoh format angka

Tabel berikut menampilkan beberapa contoh pola dan rendering angka berformat yang sesuai:

Angka	Pola	Nilai Berformat
12345.125	`####.#`	12345.1
12,34	`000.0000`	012.3400
12	`#.0#`	12.0
5,125	`# ???/???`	5 1/8
12.000	`#,###`	12.000
1230000	`0.0,,"M"`	1,2 JT
1234500000	`0.00e+00`	1,23e+09
123114.15115 MyText	`###0.000;"TEXT: "_(@_)`	123114.151 TEXT: MyText
1234 -1234 0 MyText	`[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_)`	1.234 1.234 0.0 MyText
1005 32 527	`[>1000]"HIGH";[Color43][<=200]"LOW";0000`	TINGGI RENDAH 0527