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 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
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 |
|
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 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. |
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 |