Format tanggal & angka

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

Di Sheets UI, Anda menerapkan format angka dan tanggal ke sel menggunakan Format > Menu Angka. 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 tanggal dan 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 contoh, 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
yyy	Tahun 4 digit.
yyyy+
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 menghasilkan persentase lebih 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 format 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.

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