Format tanggal & angka

Format tanggal-waktu dan angka memungkinkan Anda mengontrol tampilan data di 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 > Angka. 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 baru, yang dapat Anda sertakan dalam permintaan API. Contoh Menetapkan format desimal atau tanggal-waktu kustom untuk 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 sebagian besar 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 lain yang serupa.

Spreadsheet menggunakan bentuk tanggal epoch yang biasa digunakan dalam spreadsheet. Bagian bilangan bulat dari nilai (di sebelah kiri desimal) menghitung hari sejak 30 Desember 1899. Bagian pecahan (kanan dari desimal) menghitung waktu sebagai pecahan dari 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 hari 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 substring token yang, saat diuraikan, 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 masih cocok dengan pola. Karakter yang tidak tercantum dalam tabel di bawah diperlakukan sebagai literal, dan ditampilkan tanpa perubahan.

Contoh format tanggal & waktu

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

Pola format angka

Pola format angka adalah string 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 format. Jika Anda hanya menyertakan satu bagian, format tersebut akan digunakan untuk semua nilai. Menggunakan dua bagian akan menyebabkan format pertama diterapkan ke nol dan bilangan positif, serta format kedua diterapkan ke bilangan negatif. Menggunakan tiga bagian akan menentukan format terpisah untuk angka positif, negatif, dan nol. Contoh:

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

Namun, jika ada dua bagian atau lebih dan bagian terakhir 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]

Pemisahan format menjadi beberapa bagian terjadi sebelum pemisahan lainnya, sehingga format tanggal atau waktu dapat disertakan sebagai salah satu bagian (meskipun utilitasnya terbatas).

Token format angka

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

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:

Contoh format angka

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