Format tanggal-waktu dan angka memungkinkan Anda mengontrol bagaimana data Anda muncul dalam lembar. Google Spreadsheet menyediakan beberapa format umum untuk dipilih, tetapi Anda juga dapat menentukan format Anda sendiri
Di UI Spreadsheet, Anda menerapkan format angka dan tanggal ke sel menggunakan menu Format > Angka. Di Sheets API, Anda menyetel format ini menggunakan panggilan metode spreadsheets.batchUpdate untuk mengirim atau
Halaman ini menjelaskan cara menentukan pola format tanggal dan angka baru, yang dapat Anda sertakan dalam permintaan API Anda. Contoh menunjukkan cara menyetel pola format menggunakan API. Perhatikan bahwa rendering sebenarnya dari format bergantung pada locale spreadsheet. Panduan ini mengasumsikan locale adalah en_US. Anda dapat menentukan locale_ dari spreadsheet dengan membaca dengan permintaan [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]1
Tentang nilai tanggal dan waktu
Spreadsheet, seperti kebanyakan aplikasi spreadsheet lainnya, memperlakukan nilai tanggal dan waktu sebagai nilai desimal. Ini memungkinkan Anda melakukan aritmatika pada mereka dalam rumus, sehingga Anda dapat menambah hari atau minggu, menambah atau mengurangi 2 tanggal dan waktu, dan melakukan operasi serupa lainnya
Spreadsheet menggunakan bentuk tanggal zaman 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 dari satu hari. Misalnya, 1 Januari 1900 siang adalah [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]2, [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]3 karena 2 hari setelah 30 Desember 1899, dan [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]4 karena siang adalah setengah hari. Tanggal 1 Februari 1900 pukul 15.00 adalah [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]5
Sheets memperlakukan tahun 1900 dengan benar sebagai tahun biasa, bukan tahun kabisat
Catatan. Saat Anda membaca nilai sel, Anda bisa mendapatkan tanggal yang dirender sebagai string alih-alih sebagai nilai seri, dengan menggunakan [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]6 bersama dengan [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]7Pola format tanggal & waktu
Pola format tanggal-waktu adalah string substring token yang, ketika 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 [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]8 menunjukkan bahwa karakter sebelumnya dapat muncul satu kali atau lebih dan masih sesuai dengan pola. Karakter yang tidak tercantum dalam tabel di bawah diperlakukan sebagai literal, dan ditampilkan tanpa perubahan
Contoh format tanggal & waktu
Mengingat tanggal dan waktu RepeatCellRequest_0, tabel berikut menunjukkan beberapa contoh pola dan rendering tanggal-waktu yang sesuai. Bagian kedua tabel menunjukkan contoh format waktu berlalu untuk waktu berlalu RepeatCellRequest1
Date-time PatternsRepeatCellRequest0RepeatCellRequest34. 08. 53. 53 pRepeatCellRequest_404. 08 hal. M. RepeatCellRequest52016-04-05RepeatCellRequest65 April [Selasa]RepeatCellRequest74 PM, Sel Apr 05RepeatCellRequest8Selasa, 5/4/16 pukul 16. 08 Pola Waktu Berlalu RepeatCellRequest1locale 003. 13. 41. 255locale_10193. 41. 255Pola format angka
Pola format angka adalah string substring token yang, ketika diurai, diganti dengan representasi angka yang sesuai. Pola format angka dapat terdiri dari hingga empat bagian, dipisahkan oleh titik koma, yang menentukan format terpisah yang digunakan untuk angka positif, angka negatif, nol, dan teks (dalam urutan itu)
[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 menyebabkan format pertama diterapkan ke angka nol dan positif dan format kedua ke angka negatif. Menggunakan tiga bagian menentukan format terpisah untuk angka positif, negatif, dan nol. Misalnya
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]Namun, jika ada 2 bagian atau lebih dan bagian terakhir adalah format teks, bagian tersebut diperlakukan sebagai format teks dan yang lainnya berperilaku seolah-olah ada satu bagian yang dikurangi. Jadi, dengan menyertakan format teks final, Anda dapat menentukan format seperti
Penguraian format menjadi beberapa bagian terjadi sebelum penguraian lainnya, jadi dimungkinkan untuk menyertakan format tanggal atau waktu sebagai salah satu bagian (walaupun utilitas ini terbatas)
Token format angka
Tabel berikut menentukan substring token yang dapat Anda gunakan di bagian format untuk menentukan cara merepresentasikan nilai untuk bagian tersebut
TokenDeskripsiUpdateCellsRequest5Mewakili digit dalam angka. Jika angkanya adalah 0 yang tidak signifikan, angka itu dirender sebagai 0. Misalnya, format angka locale_3 menjadikan angka 3 sebagai "locale4". locale5Mewakili digit dalam angka. Jika digitnya adalah 0 yang tidak signifikan, digit tersebut tidak akan dirender. Misalnya, format angka locale_6 menjadikan angka 12 sebagai "locale7". locale8Mewakili digit dalam angka. Jika digitnya adalah 0 yang tidak signifikan, digit tersebut dirender sebagai spasi. Ini sering digunakan untuk menyelaraskan titik desimal dalam kolom saat menggunakan font dengan lebar tetap. Misalnya, format angka locale_9 menghasilkan angka 12. 4 sebagai. " locale0 ". locale1Periode pertama mewakili titik desimal dalam angka. Periode berikutnya diterjemahkan sebagai literal. Jika Anda menyertakan titik desimal dalam format, titik desimal selalu dirender, bahkan untuk bilangan bulat. Misalnya, locale2 menjadikan angka 3 sebagai "locale3". locale4Tampak sebagai literal tetapi juga menyebabkan angka yang ada dikalikan dengan 100 sebelum dirender, untuk membuat persentase lebih mudah dibaca. locale5Jika muncul di antara karakter dua digit (UpdateCellsRequest5, locale5, atau locale8), ini merender seluruh nomor dengan pemisah pengelompokan (pengelompokan dalam ribuan). Jika mengikuti karakter digit, ini menskalakan digit dengan seribu per koma (misalnya, format locale9 menjadikan angka 12.200.000 sebagai en_US0). en_US1Membuat angka dalam format ilmiah, dengan pemformatan di sebelah kiri en_US2 digunakan untuk bagian non-eksponen dan pemformatan di sebelah kanan E digunakan untuk bagian eksponen. en_US3 menunjukkan tanda [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]8 untuk eksponen positif. en_US1 hanya menunjukkan tanda untuk eksponen negatif. Jika menggunakan huruf kecil, keluaran en_US6 juga dalam huruf kecil. en_US3en_US8en_US9locale0Jika muncul di antara karakter dua digit (UpdateCellsRequest5, locale5, atau locale8), grup digit tersebut akan diperlakukan sebagai format pecahan. Misalnya, format angka locale_4 menghasilkan angka 23. 25 sebagai locale_5. Penyebut juga bisa berupa bilangan bulat literal, dalam hal ini memberlakukan bilangan bulat itu sebagai penyebut. Format angka locale_6 menampilkan angka 23. 25 sebagai locale_7. Bagian pecahan tidak diberikan jika pembilangnya menjadi 0. Nomor 23. 1 dengan format angka locale_8 dirender hanya sebagai locale9 (karena 0. 1 dibulatkan menjadi 0/3). locale0 tidak kompatibel dengan format ilmiah atau format dengan titik desimal di dalamnya. [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]_01Ini disertakan untuk kompatibilitas dengan format angka Microsoft Excel. Saat ini diabaikan. [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]_02Melewati karakter berikutnya dan membuat spasi. Ini digunakan untuk menyusun format angka di mana nilai negatif dikelilingi oleh tanda kurung. UpdateCellsRequest8Memperlakukan karakter berikutnya sebagai nilai literal dan bukan arti khusus yang mungkin dimilikinya. UpdateCellsRequest9Menampilkan teks apa pun yang ada di dalam tanda kutip sebagai literal. [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]05Jika sel memiliki input teks, sel tersebut akan menyisipkan teks mentah untuk sel tersebut. Tidak kompatibel dengan karakter khusus lainnya dan tidak ditampilkan untuk nilai numerik (yang ditampilkan sebagai format umum). [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]06Sheets memperlakukan karakter ini sebagai literal dan menampilkannya tidak berubahInstruksi meta
Selain itu, setiap bagian format dapat memiliki instruksi meta opsional, diapit dalam [NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]07 karakter, yang mendahului format dan memberikan instruksi tambahan. Ada 2 jenis instruksi meta dan bagian tertentu dapat menggunakan keduanya