Format tanggal & angka

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