Tài liệu này mô tả cách xác định các mẫu định dạng ngày và số mới mà bạn có thể đưa vào yêu cầu API của mình.
Định dạng ngày giờ và số cho phép bạn kiểm soát cách dữ liệu xuất hiện trong trang tính. Google Trang tính cung cấp một số định dạng phổ biến để bạn lựa chọn, nhưng bạn cũng có thể xác định định dạng của riêng mình.
Trong giao diện người dùng của Trang tính, bạn áp dụng định dạng số và ngày cho các ô bằng trình đơn Định dạng > Số. Trong API Google Trang tính, bạn đặt các định dạng này bằng cách sử dụng lệnh gọi phương thức spreadsheets.batchUpdate để gửi UpdateCellsRequest hoặc RepeatCellRequest.
Trong yêu cầu, bạn định cấu hình đối tượng NumberFormat bằng cách chỉ định một NumberFormatType (chẳng hạn như NUMBER, CURRENCY, PERCENT, DATE hoặc TIME) và một chuỗi pattern không bắt buộc. Nếu bạn bỏ qua pattern, Trang tính sẽ sử dụng mẫu định dạng mặc định cho type được chỉ định dựa trên locale của bảng tính (ví dụ: $1,000.12 cho CURRENCY trong en_US).
Mẫu Đặt định dạng ngày giờ hoặc số thập phân tuỳ chỉnh cho một dải ô cho biết cách đặt mẫu định dạng bằng API Trang tính. Xin lưu ý rằng việc hiển thị thực tế của định dạng phụ thuộc vào locale của bảng tính.
Tài liệu này giả định locale là en_US. Bạn có thể xác định locale của một bảng tính bằng cách đọc đối tượng SpreadsheetProperties bằng phương thức spreadsheets.get trên tài nguyên spreadsheets.
Để xem thêm các mẫu, hãy xem phần Định dạng cơ bản và Định dạng có điều kiện.
Giới thiệu về giá trị ngày và giờ
Trang tính, giống như hầu hết các ứng dụng bảng tính khác, coi các giá trị ngày và giờ là giá trị thập phân. Nhờ đó, bạn có thể thực hiện phép tính số học trên các giá trị này trong công thức, chẳng hạn như tăng ngày hoặc tuần, cộng hoặc trừ hai ngày và giờ, cũng như thực hiện các phép tính tương tự khác.
Trang tính sử dụng một dạng ngày kỷ nguyên thường dùng trong bảng tính. Phần số nguyên của giá trị (bên trái dấu thập phân) tính số ngày kể từ ngày 30 tháng 12 năm 1899. Phần thập phân (bên phải dấu thập phân) tính thời gian dưới dạng một phần của một ngày. Ví dụ: Ngày 1 tháng 1 năm 1900 vào buổi trưa
là 2.5, 2 vì đó là 2 ngày sau ngày 30 tháng 12 năm 1899 và 0.5 vì
buổi trưa là nửa ngày. Ngày 1 tháng 2 năm 1900 lúc 3 giờ chiều là 33.625.
Trang tính coi năm 1900 là năm thường, không phải năm nhuận. Số sê-ri ngày và giờ không lưu trữ độ lệch múi giờ. Thay vào đó,
các giá trị này dựa trên
timeZone của bảng tính,
bạn có thể đọc từ đối tượng
SpreadsheetProperties
bằng phương thức
spreadsheets.get.
Mẫu định dạng ngày và giờ
Mẫu định dạng ngày giờ là một chuỗi các chuỗi con mã thông báo mà Trang tính thay thế bằng các thành phần ngày giờ tương ứng (chẳng hạn như tháng hoặc giờ) khi phân tích cú pháp.
Mã thông báo định dạng ngày và giờ
Bảng sau đây xác định các chuỗi con của mã thông báo mà bạn có thể sử dụng trong mẫu định dạng ngày giờ. Ký tự + cho biết ký tự trước đó có thể xuất hiện một hoặc nhiều lần mà vẫn khớp với mẫu. Trang tính coi các ký tự không có trong bảng này là ký tự cố định và xuất ra mà không thay đổi.
| Mã thông báo | Mô tả |
|---|---|
h |
Giờ trong ngày. Chuyển đổi giữa định dạng 12 và 24 giờ tuỳ thuộc vào việc chỉ báo AM hoặc PM có trong chuỗi hay không. |
hh+ |
Tương tự như trên, nhưng có số 0 ở đầu cho các số từ 1 đến 9. |
m |
Nếu mã thông báo không phải giá trị cố định trước đó là giờ hoặc mã thông báo tiếp theo là giây, thì mã thông báo này đại diện cho phút trong giờ (không có số 0 ở đầu). Nếu không, biến này sẽ biểu thị tháng trong năm dưới dạng số (không có số 0 ở đầu). |
M |
Tháng trong năm không có số 0 ở đầu. Hãy sử dụng mã thông báo này để nêu rõ tháng, thay vì phút, trong mẫu của bạn. |
mm |
Giống như m, nhưng có số 0 ở đầu cho cả hai trường hợp. |
MM |
Tháng trong năm có số 0 ở đầu. Hãy sử dụng mã thông báo này để nêu rõ tháng, thay vì phút, trong mẫu của bạn. |
mmm |
Tên tháng viết tắt gồm ba chữ cái (ví dụ: "Feb"). |
mmmm |
Tên đầy đủ của tháng. mmmmmm+ cũng khớp với điều này. |
mmmmm |
Chữ cái đầu tiên của tháng (ví dụ: "T" cho tháng 6). |
s |
Số giây trong phút không có số 0 ở đầu. |
ss |
Số giây trong phút có số 0 ở đầu. |
[h+] |
Số giờ đã trôi qua trong một khoảng thời gian. Số lượng chữ cái cho biết số chữ số tối thiểu (thêm các số 0 ở đầu). |
[m+] |
Số phút đã trôi qua trong một khoảng thời gian. Số lượng chữ cái cho biết số chữ số tối thiểu (thêm các số 0 ở đầu). |
[s+] |
Số giây đã trôi qua trong một khoảng thời gian. Số lượng chữ cái cho biết số chữ số tối thiểu (thêm các số 0 ở đầu). |
d |
Ngày trong tháng, không có số 0 ở đầu đối với các số nhỏ hơn 10. |
dd |
Ngày trong tháng, có số 0 ở đầu cho các số nhỏ hơn 10. |
ddd |
Ngày trong tuần, viết tắt bằng ba chữ cái (ví dụ: "Mon"). |
dddd+ |
Ngày trong tuần, tên đầy đủ. |
y |
Năm có 2 chữ số. |
yy |
|
yyy |
Năm viết dưới dạng 4 chữ số. |
yyyy+ |
|
a/p |
Hiển thị "a" cho AM và "p" cho PM. Đồng thời thay đổi giờ thành định dạng 12 giờ. Nếu chữ cái của mã thông báo được viết hoa, thì kết quả cũng sẽ được viết hoa. |
am/pm |
Tương tự như trên, nhưng hiển thị "AM" hoặc "PM" và luôn được viết hoa. |
0 |
Phần mười giây. Bạn có thể tăng độ chính xác lên hai chữ số bằng 00 hoặc ba chữ số (mili giây) bằng 000. |
\ |
Coi ký tự tiếp theo là một giá trị cố định và không có ý nghĩa đặc biệt nào. |
"text" |
Hiển thị bất kỳ văn bản nào nằm trong dấu ngoặc kép dưới dạng giá trị cố định. |
Ví dụ về định dạng ngày và giờ
Với ngày và giờ Tuesday, April 5, 2016, 4:08:53.528 PM, bảng sau đây trình bày một số mẫu và cách hiển thị ngày giờ tương ứng. Phần thứ hai của bảng cho thấy ví dụ về các định dạng thời gian đã trôi qua cho thời gian đã trôi qua là 3 hours, 13 minutes, 41.255 seconds:
| Mẫu ngày giờ | Tuesday, April 5, 2016, 4:08:53.528 PM |
|---|---|
h:mm:ss.00 a/p |
4:08:53.53 chiều |
hh:mm A/P".M." |
04:08 CH |
yyyy-mm-dd |
2016-04-05 |
mmmm d \[dddd\] |
Ngày 5 tháng 4 [Thứ Ba] |
h PM, ddd mmm dd |
4 giờ chiều, thứ Ba, ngày 5 tháng 4 |
dddd, m/d/yy at h:mm |
Thứ Ba, ngày 5/4/16 lúc 16:08 |
| Mẫu thời gian đã trôi qua | 3 hours, 13 minutes, 41.255 seconds |
[hh] |
03 |
[mmmm] |
0193 |
[ss] |
11621 |
Mẫu định dạng số
Mẫu định dạng số là một chuỗi các chuỗi con mã thông báo mà Trang tính thay thế bằng các biểu diễn số tương ứng khi được phân tích cú pháp. Một mẫu định dạng số có thể bao gồm tối đa bốn phần, được phân tách bằng dấu chấm phẩy, xác định các định dạng riêng biệt được sử dụng cho số dương, số âm, số không và văn bản (theo thứ tự đó):
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
Bạn không cần phải đưa cả 4 phần vào một định dạng. Nếu bạn chỉ thêm một phần, thì Trang tính sẽ sử dụng định dạng đó cho tất cả các giá trị. Khi sử dụng hai phần, định dạng đầu tiên sẽ áp dụng cho số 0 và số dương, còn định dạng thứ hai sẽ áp dụng cho số âm. Việc sử dụng ba phần sẽ xác định các định dạng riêng biệt cho số dương, số âm và số không. Ví dụ:
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
Tuy nhiên, nếu có từ hai phần trở lên và phần cuối cùng là định dạng văn bản, thì Trang tính sẽ coi phần đó là định dạng văn bản và các phần khác sẽ hoạt động như thể có ít hơn một phần. Do đó, bằng cách thêm định dạng văn bản cuối cùng, bạn có thể xác định các định dạng như:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
Quá trình phân tích cú pháp một định dạng thành các phần diễn ra trước các quá trình phân tích cú pháp khác, vì vậy, bạn có thể đưa định dạng ngày hoặc giờ vào một trong các phần (mặc dù việc này có một số hạn chế).
Mã thông báo định dạng số
Bảng sau đây xác định các chuỗi con của mã thông báo mà bạn có thể sử dụng trong phần định dạng để xác định cách biểu thị các giá trị cho phần đó.
| Mã thông báo | Mô tả |
|---|---|
0 |
Đại diện cho một chữ số trong số. Nếu chữ số là số 0 không có ý nghĩa, thì chữ số đó sẽ được hiển thị là 0. Ví dụ: định dạng số 00.0 hiển thị số 3 dưới dạng "03.0". |
# |
Đại diện cho một chữ số trong số. Nếu chữ số là số 0 không có ý nghĩa, thì chữ số đó sẽ không được hiển thị. Ví dụ: định dạng số ##0 sẽ hiển thị số 12 dưới dạng "12". |
? |
Đại diện cho một chữ số trong số. Nếu chữ số là số 0 không có ý nghĩa,
thì chữ số đó sẽ được hiển thị dưới dạng dấu cách. Thường được dùng để căn chỉnh dấu thập phân trong một cột khi sử dụng phông chữ có chiều rộng cố định. Ví dụ: định dạng số ???.??? sẽ hiển thị số 12, 4 dưới dạng: " 12.4 ". |
. |
Dấu chấm đầu tiên đại diện cho dấu thập phân trong số. Các dấu chấm tiếp theo được hiển thị dưới dạng ký tự. Nếu bạn thêm dấu thập phân vào định dạng, thì dấu này sẽ luôn được hiển thị, ngay cả đối với số nguyên. Ví dụ:
#0.# hiển thị số 3 dưới dạng "3.". |
% |
Xuất hiện dưới dạng giá trị cố định nhưng cũng khiến các số hiện có được nhân với 100 trước khi hiển thị để giúp tỷ lệ phần trăm dễ đọc hơn. Ví dụ: định dạng số #% sẽ hiển thị số 0, 25 dưới dạng "25%". |
, |
Nếu xuất hiện giữa các ký tự có hai chữ số (0, # hoặc ?), thì ký tự này sẽ hiển thị toàn bộ số có dấu phân tách nhóm (nhóm theo hàng nghìn). Nếu theo sau các ký tự chữ số, thì dấu phẩy sẽ điều chỉnh tỷ lệ các chữ số theo hệ số một nghìn cho mỗi dấu phẩy (ví dụ: định dạng #0.0,, sẽ hiển thị số 12.200.000 dưới dạng 12.2). |
E- |
Hiển thị số ở định dạng khoa học, với định dạng ở bên trái của E được dùng cho phần không có số mũ và định dạng ở bên phải của E được dùng cho phần có số mũ. E+ cho thấy dấu + cho số mũ dương. E- chỉ hiển thị dấu cho số mũ âm. Nếu
bạn sử dụng chữ thường, thì kết quả e cũng sẽ là chữ thường.
Ví dụ: định dạng số ##0.00#E+##
hiển thị số 0, 0000001 dưới dạng "100.00E-9". |
E+ |
|
e- |
|
e+ |
|
/ |
Nếu dấu chấm xuất hiện giữa các ký tự có hai chữ số (0, # hoặc ?), thì dấu chấm sẽ coi các nhóm chữ số đó là định dạng phân số. Ví dụ: định dạng số 0 #/# sẽ hiển thị số 23, 25 dưới dạng 23 1/4. Mẫu số cũng có thể là một số nguyên cố định, trong trường hợp đó, mẫu số sẽ là số nguyên đó. Định dạng số 0 #/8
hiển thị số 23,25 dưới dạng 23 2/8. Phần phân số không được hiển thị nếu tử số trở thành 0. Số 23,1 có định dạng số 0 #/3 sẽ chỉ hiển thị là 23 (vì 0,1 được làm tròn thành 0/3). / không tương thích với định dạng khoa học hoặc định dạng có dấu thập phân. |
* |
Được đưa vào để tương thích với các định dạng số của Microsoft Excel. Trang tính bỏ qua mã thông báo này. |
_ |
Bỏ qua ký tự tiếp theo và kết xuất một khoảng trắng. Sử dụng mã thông báo này để căn chỉnh định dạng số trong đó dấu ngoặc đơn bao quanh giá trị âm. |
\ |
Coi ký tự tiếp theo là một giá trị cố định và không có ý nghĩa đặc biệt nào. Ví dụ: định dạng số \#0 sẽ hiển thị số 10 dưới dạng "#10". |
"text" |
Hiển thị bất kỳ văn bản nào nằm trong dấu ngoặc kép dưới dạng giá trị cố định. |
@ |
Nếu ô có dữ liệu nhập dạng văn bản, thì ô đó sẽ chèn văn bản thô. Không tương thích với bất kỳ ký tự đặc biệt nào khác và không hiển thị cho các giá trị số (hiển thị dưới dạng định dạng chung). |
$ - + ( ) : space |
Trang tính coi các ký tự này và các ký hiệu tiền tệ phổ biến (chẳng hạn như $, €, £ và ¥) là giá trị cố định và hiển thị các ký tự này mà không thay đổi. |
Hướng dẫn về siêu dữ liệu
Ngoài ra, mỗi phần định dạng có thể có các lệnh meta không bắt buộc, được đặt trong các ký tự [], đứng trước định dạng và cung cấp các lệnh bổ sung:
| Hướng dẫn | Mô tả |
|---|---|
[condition] |
Thay thế phép so sánh dương, âm hoặc bằng 0 mặc định của phần bằng một biểu thức có điều kiện khác. Ví dụ: [<100]"Low";[>1000]"High";000 hiển thị từ "Thấp" cho các giá trị dưới 100, "Cao" cho các giá trị trên 1000 và một số có ba chữ số (với số 0 ở đầu) cho bất kỳ giá trị nào ở giữa. Bạn chỉ có thể áp dụng điều kiện cho hai định dạng phụ đầu tiên và nếu một số khớp với nhiều định dạng, thì Trang tính sẽ sử dụng định dạng khớp đầu tiên. Nếu có định dạng thứ ba, Trang tính sẽ sử dụng định dạng đó cho "mọi thứ khác"; nếu không, nếu một số không khớp với một trong hai định dạng, Trang tính sẽ hiển thị tất cả ký tự "#" trên chiều rộng ô. Nếu có, định dạng thứ tư luôn được dùng cho văn bản. |
[Color] or [Color#] |
Khiến mọi giá trị mà định dạng phụ này hiển thị xuất hiện cùng với màu văn bản đã cho. Các giá trị hợp lệ cho Color là Đen, Xanh dương, Lục lam, Xanh lục, Đỏ tươi, Đỏ, Trắng hoặc Vàng.
Giá trị hợp lệ cho "#" trong Color# là từ 1 đến 56. Màu định dạng số sẽ ghi đè mọi màu do người dùng nhập vào ô, nhưng không ghi đè màu do định dạng có điều kiện đặt. Bảng màu này cho thấy danh sách các màu tương ứng với từng số. Các thuộc tính này dựa trên thuộc tính ColorIndex trong Microsoft Excel. |
[$currency] |
Hiển thị ký hiệu hoặc mã đơn vị tiền tệ được chỉ định dưới dạng giá trị cố định (ví dụ: [$€]#,##0.00 hoặc [$CAD]#,##0.00). Nếu bạn thêm mã ngôn ngữ không bắt buộc sau dấu gạch nối (chẳng hạn như [$CAD-1009]), thì Trang tính sẽ bỏ qua mã ngôn ngữ đó. |
Ví dụ về định dạng số
Bảng sau đây trình bày một số mẫu và cách hiển thị số được định dạng tương ứng:
| Số | Mẫu | Giá trị được định dạng |
|---|---|---|
| 12345.125 | ####.# |
12345.1 |
| 12,34 | 000.0000 |
012.3400 |
| 12 | #.0# |
12.0 |
| 5,125 | # ???/??? |
5 1/8 |
| 12000 | #,### |
12.000 |
| 1234.56 -1234.56 |
$#,##0.00;($#,##0.00) |
1.234,56 USD (1.234,56 USD) |
| 1230000 | 0.0,,"M" |
1,2 triệu |
| 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 |
CAO THẤP 0527 |