Halaman ini diterjemahkan oleh Cloud Translation API.

Format tanggal & angka

Format tanggal-waktu dan angka memungkinkan Anda mengontrol bagaimana data muncul dalam {i>sheet<i}. Google Sheets menyediakan beberapa format umum untuk dipilih, tetapi Anda juga dapat menentukan format Anda sendiri.

Di Sheets UI, Anda menerapkan format angka dan tanggal ke sel menggunakan Format > Menu Nomor. Di Sheets API, Anda menyetel format ini menggunakan spreadsheets.batchUpdate panggilan metode untuk mengirim UpdateCellsRequest atau RepeatCellRequest.

Halaman ini menjelaskan cara menetapkan pola format tanggal dan angka yang baru, yang dapat disertakan dalam permintaan API. Contoh Menetapkan format datetime atau desimal kustom untuk rentang menunjukkan cara menyetel pola format menggunakan API. Perhatikan bahwa rendering yang sebenarnya formatnya bergantung pada locale spreadsheet. Panduan ini mengasumsikan locale adalah en_US. Anda dapat menentukan locale spreadsheet dengan membaca tindakan SpreadsheetProperties dengan spreadsheets.get permintaan.

Tentang tanggal & nilai waktu

Spreadsheet, seperti kebanyakan aplikasi {i>spreadsheet<i} lainnya, memperlakukan nilai tanggal dan waktu sebagai nilai desimal. Ini memungkinkan Anda melakukan aritmatika pada {i>formula<i} dalam formula, sehingga Anda dapat menambah hari atau minggu, menambah atau mengurangi dua tanggal dan waktu, dan melakukan operasi yang serupa.

{i>Sheets<i} menggunakan bentuk tanggal epoch yang biasa digunakan di {i>spreadsheet<i}. Bagian bilangan bulat dari nilai (di kiri desimal) menghitung hari sejak 30 Desember 1899. Pecahan bagian (kanan desimal) menghitung waktu sebagai pecahan dari satu hari. Sebagai misalnya, 1 Januari 1900 siang hari adalah 2.5, 2 karena 2 hari setelahnya 30 Desember 1899, dan 0.5 karena tengah 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.

Tanggal & pola format waktu

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

Tanggal & token format waktu

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

Token	Deskripsi
`h`	Jam. Beralih antara format 12 dan 24 jam bergantung pada apakah indikator AM atau PM ada 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, mewakili menit dalam jam (tanpa 0 di depan). Jika tidak, mewakili bulan dalam setahun sebagai angka (tanpa 0 di depan).
`M`	Bulan dalam setahun tanpa 0 di depan. Gunakan token ini untuk menyatakan bulan secara jelas, bukan satu menit, di pola Anda.
`mm`	Sama seperti `m`, tetapi dengan 0 di depan untuk kedua kasus.
`MM`	Bulan dalam setahun dengan 0 di depan. Gunakan token ini untuk menyatakan bulan secara jelas, bukan satu menit, di pola Anda.
`mmm`	Singkatan tiga huruf bulan (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 0 di depan.
`[h+]`	Jumlah jam berlalu dalam durasi waktu. Jumlah huruf menunjukkan jumlah digit minimum (menambahkan 0 di depan).
`[m+]`	Jumlah menit berlalu dalam durasi waktu. Jumlah huruf menunjukkan jumlah digit minimum (menambahkan 0 di depan).
`[s+]`	Jumlah detik berlalu dalam durasi waktu. Jumlah huruf menunjukkan jumlah digit minimum (menambahkan 0 di depan).
`d`	Hari dalam sebulan, tanpa 0 di awal untuk angka yang kurang dari 10.
`dd`	Hari dalam sebulan, dengan 0 di awal untuk angka yang kurang dari 10.
`ddd`	Hari, 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 menjadi Format 12 jam. Jika huruf token ditulis dengan huruf kapital, {i>outputnya<i} adalah, berikutnya
`am/pm`	Seperti di atas, tetapi menampilkan "AM" atau "Sore" dan selalu menggunakan 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 nilai khusus yang berarti.
`"text"`	Menampilkan teks apa pun yang ada di dalam tanda kutip sebagai literal.

Tanggal & contoh format waktu

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

Pola Tanggal-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."`	16.08
`yyyy-mm-dd`	2016-04-05
`mmmm d \[dddd\]`	5 April [Selasa]
`h PM, ddd mmm dd`	16.00, Sel 05 Apr
`dddd, m/d/yy at h:mm`	Selasa, 4/5/16 pukul 16:08
Pola Waktu Berlalu	`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 substring token yang, saat diuraikan, akan diganti dengan representasi angka yang sesuai. Pola format angka dapat terdiri dari hingga empat bagian, dipisahkan dengan titik koma, yang mendefinisikan format terpisah yang digunakan untuk bilangan positif, angka negatif, nol, dan teks (di urutan tersebut):

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

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

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

Namun, jika ada dua atau lebih bagian dan bagian terakhir adalah , bagian tersebut diperlakukan sebagai format teks dan bagian lainnya berkurang satu bagian. Jadi, dengan menyertakan format teks final, kita bisa untuk menentukan format seperti:

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

Penguraian format menjadi beberapa bagian terjadi sebelum penguraian lain, jadi mungkin untuk menyertakan format tanggal atau waktu sebagai salah satu bagian (meskipun ini utilitasnya terbatas).

Token format angka

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

Token	Deskripsi
`0`	Mewakili digit dalam angka. Jika digit itu adalah 0 yang tidak signifikan, itu akan dirender sebagai 0. Misalnya, format angka `00.0` merender angka 3 sebagai "`03.0`".
`#`	Mewakili digit dalam angka. Jika digit itu adalah 0 yang tidak signifikan, dan tidak dirender. Misalnya, format angka `##0` merender angka 12 sebagai "`12`".
`?`	Mewakili digit dalam angka. Jika digit itu adalah 0 yang tidak signifikan, itu dirender sebagai spasi. Ini sering digunakan untuk menyelaraskan titik desimal dalam kolom ketika menggunakan {i>font<i} dengan lebar tetap. Misalnya, format angka `???.???` merender angka 12.4 sebagai: " `12.4` ".
`.`	Titik pertama mewakili titik desimal dalam angka. Setelah tanda titik dirender sebagai literal. Jika Anda menyertakan titik desimal pada , akan selalu dirender, bahkan untuk bilangan bulat. Misalnya, `#0.#` merender angka 3 sebagai "`3.`".
`%`	Muncul sebagai literal tetapi juga menyebabkan angka yang ada dikalikan sebanyak 100 sebelum dirender untuk meningkatkan persentase dapat dibaca. Misalnya, format angka `#%` merender angka 0,25 sebagai "`25%`".
`,`	Jika muncul di antara karakter dua digit (`0`, `#`, atau `?`), sistem akan merender seluruh angka dengan pemisah kelompok (pengelompokan berdasarkan ribuan). Jika mengikuti karakter angka, sistem akan menskalakan digit dengan seribu per koma (misalnya, format `#0.0,,` merender angka 12.200.000 sebagai `12.2`).
`E-`	Menampilkan angka dalam format ilmiah, dengan pemformatan di sebelah kiri `E` yang digunakan untuk non-eksponen dan pemformatan di sebelah kanan E yang digunakan untuk eksponen bagian ini. `E+` menunjukkan tanda `+` untuk positif eksponen. `E-` hanya menunjukkan tanda untuk eksponen negatif. Jika digunakan huruf kecil, output `e` juga dalam 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 `?`), kode ini memperlakukan kelompok digit tersebut sebagai bentuk pecahan. Misalnya, format angka `0 #/#` merender angka 23,25 sebagai `23 1/4`. Penyebut bisa juga berupa bilangan bulat literal, yang dalam hal ini memberlakukan bilangan bulat tersebut sebagai penyebut. Format angka `0 #/8` menampilkan angka 23,25 sebagai `23 2/8`. Bagian pecahan bukan dirender jika pembilangnya menjadi 0. Nomor 23.1 dengan format angka `0 #/3` dirender hanya `23` (karena 0,1 dibulatkan menjadi 0/3). `/` sama dengan tidak kompatibel dengan format ilmiah atau format dengan titik desimal di dalamnya.
`*`	Hal ini disertakan untuk kompatibilitas dengan format angka Microsoft Excel. Saat ini diabaikan.
`_`	Token garis bawah melewati karakter berikutnya dan merender spasi. Ini digunakan untuk menyejajarkan format angka yang nilai negatifnya diapit oleh tanda kurung.
`\`	Memperlakukan karakter berikutnya sebagai nilai literal dan bukan nilai khusus yang berarti. Misalnya, format angka `\#0` merender angka 10 sebagai "`#10`".
`"text"`	Menampilkan teks apa pun yang ada di dalam tanda kutip sebagai literal.
`@`	Jika sel memiliki input teks, teks mentah untuk sel akan disisipkan. Bukan kompatibel dengan salah satu karakter khusus lainnya dan tidak ditampilkan untuk nilai numerik (yang ditampilkan sebagai format umum).
`$ - + ( ) : space`	Spreadsheet memperlakukan karakter ini sebagai literal dan menampilkannya tidak berubah.

Petunjuk meta

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

Petunjuk Deskripsi

[condition] Mengganti perbandingan positif, negatif, atau nol default dari dengan ekspresi kondisional lainnya. Misalnya, [<100]”Low”;[>1000]”High”;000 merender kata "Rendah" untuk nilai di bawah 100, "Tinggi" untuk nilai di atas 1.000, dan tiga digit angka (dengan 0 di depan) untuk apa pun di antaranya. Kondisi hanya dapat diterapkan pada dua sub-format pertama dan jika suatu angka cocok dengan lebih dari satu, menggunakan format pertama yang cocok dengannya. Jika ada format ketiga, digunakan untuk "lainnya", jika tidak, jika suatu angka tidak cocok , ini dirender karena semua "#" mengisi lebar sel. Jika ada, format keempat selalu digunakan untuk teks.

[Color] or [Color#] Menyebabkan nilai apa pun yang dirender sub-format ini muncul dengan warna teks tertentu. Nilai yang valid untuk Color adalah Black, Biru, Sian, Hijau, Magenta, Merah, Putih, atau Kuning. Nilai yang valid untuk "#" di Color# adalah 0&ndash1;56 (ini palet warna menampilkan daftar warna yang sesuai dengan setiap angka). Format angka warna mengganti warna apa pun yang dimasukkan pengguna pada sel, tetapi tidak mengganti warna yang ditetapkan oleh pemformatan bersyarat.

Petunjuk	Deskripsi
`[condition]`	Mengganti perbandingan positif, negatif, atau nol default dari dengan ekspresi kondisional lainnya. Misalnya, `[<100]”Low”;[>1000]”High”;000` merender kata "Rendah" untuk nilai di bawah 100, "Tinggi" untuk nilai di atas 1.000, dan tiga digit angka (dengan 0 di depan) untuk apa pun di antaranya. Kondisi hanya dapat diterapkan pada dua sub-format pertama dan jika suatu angka cocok dengan lebih dari satu, menggunakan format pertama yang cocok dengannya. Jika ada format ketiga, digunakan untuk "lainnya", jika tidak, jika suatu angka tidak cocok , ini dirender karena semua "#" mengisi lebar sel. Jika ada, format keempat selalu digunakan untuk teks.
`[Color] or [Color#]`	Menyebabkan nilai apa pun yang dirender sub-format ini muncul dengan warna teks tertentu. Nilai yang valid untuk `Color` adalah Black, Biru, Sian, Hijau, Magenta, Merah, Putih, atau Kuning. Nilai yang valid untuk "#" di `Color#` adalah 0&ndash1;56 (ini palet warna menampilkan daftar warna yang sesuai dengan setiap angka). Format angka warna mengganti warna apa pun yang dimasukkan pengguna pada sel, tetapi tidak mengganti warna yang ditetapkan oleh pemformatan bersyarat.

Contoh format angka

Tabel berikut menunjukkan beberapa pola contoh dan setiap pola rendering angka berformat:

Angka	Pola	Nilai Terformat
12.345,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 TEKS: MyText
1234 -1234 0 Teks Saya	`[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_)`	1.234 1.234 0,0 MyText
1.005 32 527	`[>1000]"HIGH";[Color43][<=200]"LOW";0000`	TINGGI RENDAH 0527