Format tanggal-waktu dan angka memungkinkan Anda mengontrol tampilan data dalam {i>sheet<i}. Google Spreadsheet menyediakan beberapa pilihan format umum, 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 dapat menyetel 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 tanggal dan waktu khusus untuk rentang tanggal
menunjukkan cara menetapkan pola format menggunakan API. Perhatikan bahwa rendering format yang sebenarnya
bergantung pada locale
spreadsheet. Panduan ini mengasumsikan
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 aritmatika pada keduanya 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 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 3 sore
adalah 33.625
.
Spreadsheet dengan benar memperlakukan tahun 1900 sebagai tahun biasa, bukan tahun kabisat.
Pola format tanggal & waktu
Pola format tanggal-waktu adalah string dari substring token yang, saat diurai, 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 ini diperlakukan sebagai literal, dan merupakan output tanpa perubahan.
Token | Deskripsi |
---|---|
h |
Jam. 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 mewakili menit dalam jam (tanpa 0 di awal). Jika tidak, kolom tersebut mewakili bulan dalam setahun sebagai angka (tanpa 0 di depan). |
M |
Bulan dalam setahun tanpa 0 di depan. Gunakan token ini untuk menyatakan secara jelas bulan, bukan satu menit, dalam pola Anda. |
mm |
Sama seperti m , tetapi dengan 0 di awal untuk kedua kasus. |
MM |
Bulan dalam setahun dengan 0 di depan. Gunakan token ini untuk menyatakan secara jelas bulan, bukan satu menit, dalam 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 yang berlalu dalam durasi waktu. Jumlah huruf menunjukkan jumlah digit minimum (menambahkan 0 di depan). |
[m+] |
Jumlah menit yang telah berlalu dalam durasi waktu. Jumlah huruf menunjukkan jumlah digit minimum (menambahkan 0 di depan). |
[s+] |
Jumlah detik yang berlalu dalam 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, "Mon"). |
dddd+ |
Hari dalam seminggu, nama lengkap. |
y |
2 digit tahun. |
yy |
|
yyy |
4 digit tahun. |
yyyy+ |
|
a/p |
Menampilkan "a" untuk AM, dan "p" untuk PM. Juga mengubah jam ke format 12 jam. Jika huruf token ditulis dengan huruf kapital, outputnya juga demikian. |
am/pm |
Seperti di atas, tetapi menampilkan "AM" atau "PM" dan selalu dalam 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 yang ada di dalam tanda kutip sebagai literal. |
Contoh format tanggal & waktu
Dengan mempertimbangkan tanggal dan waktu Tuesday, April 5, 2016, 4:08:53.528 PM
, tabel berikut menunjukkan beberapa pola contoh dan rendering tanggal-waktu yang sesuai. Bagian kedua dari tabel menunjukkan contoh format waktu
berlalu 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 |
hh:mm A/P".M." |
04.08 P. |
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 pada 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 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 sebuah 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 bilangan positif dan format kedua 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 bagian atau lebih dan bagian terakhir adalah format teks, bagian tersebut diperlakukan sebagai format teks dan bagian lainnya akan berperilaku seolah-olah ada satu bagian yang lebih sedikit. Oleh karena itu, 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 ini adalah utilitas terbatas).
Token format angka
Tabel berikut menentukan substring token yang dapat Anda gunakan di bagian format untuk menentukan cara merepresentasikan nilai untuk bagian tersebut.
Token | Deskripsi |
---|---|
0 |
Mewakili 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 ". |
# |
Mewakili digit dalam angka. Jika digit tersebut merupakan 0 yang tidak signifikan,
maka tidak akan dirender. Misalnya, format angka ##0
merender angka 12 sebagai "12 ". |
? |
Mewakili digit dalam angka. Jika digit tersebut adalah 0 yang tidak signifikan,
maka akan dirender sebagai spasi. Jenis font ini sering digunakan untuk meratakan titik desimal di
kolom saat menggunakan font dengan lebar tetap. Misalnya, format angka
???.??? merender angka 12,4 sebagai:
" 12.4 ". |
. |
Titik pertama mewakili titik desimal dalam angka. Titik
selanjutnya dirender sebagai literal. Jika Anda menyertakan titik desimal dalam
format, titik tersebut 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 ? ), sistem akan merender seluruh angka
dengan pemisah pengelompokan (pengelompokan berdasarkan ribuan). Jika mengikuti
karakter digit, sistem 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-eksponen dan pemformatan di sebelah kanan E yang digunakan untuk bagian eksponen. E+ menunjukkan tanda + untuk eksponen positif. E- hanya menampilkan tanda untuk eksponen negatif. Jika
huruf kecil digunakan, 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 ? ), sistem akan memperlakukan kelompok digit tersebut 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 pembilangnya menjadi 0. Angka 23.1 dengan format angka 0 #/3 dirender hanya sebagai 23 (karena 0,1 dibulatkan menjadi 0/3). /
tidak kompatibel dengan format ilmiah atau format yang berisi 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 menyejajarkan 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 yang ada di dalam tanda kutip sebagai literal. |
@ |
Jika sel memiliki input teks, sel akan menyisipkan teks mentah untuk sel tersebut. Tidak kompatibel dengan karakter khusus lainnya dan tidak ditampilkan untuk nilai numerik (yang ditampilkan sebagai format umum). |
$ - + ( ) : space |
Sheets memperlakukan karakter ini sebagai literal dan menampilkannya tanpa perubahan. |
Instruksi 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 dari
bagian dengan ekspresi kondisional lainnya. Misalnya,
[<100]”Low”;[>1000]”High”;000 merender kata
"Rendah" untuk nilai di bawah 100, "Tinggi" untuk nilai di atas 1000, dan angka tiga digit (dengan 0 di depan) untuk nilai apa pun di antaranya. Kondisi hanya dapat diterapkan pada dua sub-format pertama, dan jika angka cocok dengan lebih dari satu, sub-format pertama akan digunakan. Jika ada format ketiga,
angka tersebut akan digunakan untuk "lainnya", jika tidak, jika angka tidak cocok dengan salah satu
format tersebut, angka akan dirender karena semua "#" 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, Sian, Hijau, Magenta, Merah, Putih, atau Kuning. Nilai yang valid untuk "#" di Color# adalah 0&ndash1;56 (palet warna ini menampilkan daftar warna yang sesuai dengan setiap angka). Warna format angka akan mengganti warna yang dimasukkan pengguna pada sel, tetapi tidak mengganti warna yang ditetapkan oleh format bersyarat. |
Contoh format angka
Tabel berikut menunjukkan beberapa pola contoh dan rendering angka berformat yang sesuai:
Angka | Pola | Nilai Terformat |
---|---|---|
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 |