日期時間和數字格式可用來控制工作表顯示資料的方式。 Google 試算表提供部分常用格式讓您選擇 您可以自行定義格式
在試算表 UI 中，您可以使用下列選項為儲存格套用數字和日期格式：
格式 >數字選單：在 Sheets API 中，您可以使用
spreadsheets.batchUpdate敬上
方法來傳送
UpdateCellsRequest
或
RepeatCellRequest。
本頁說明如何定義新的日期和數字格式模式，並且
這些 通常都包含在 API 要求中範例
設定範圍的自訂日期時間或小數格式
示範瞭如何使用 API 設定格式模式。請注意
格式則取決於試算表的 locale。本指南假設
locale為 en_US。如要判斷試算表的 locale，請參閱
這個
SpreadsheetProperties
有 spreadsheets.get
請求。
關於日期和時間值
Google 試算表和其他大多數試算表應用程式一樣，會將日期和時間值視為 小數值。這樣一來，您就可以在公式中對它們執行算術 增加或減少天數或週數、增加或減少兩個日期和時間，並執行其他 執行類似作業
Google 試算表採用格式為
Epoch 日期
這項功能常用於試算表值的整數部分
(小數點左側) 會計算自 1899 年 12 月 30 日以來的天數。分數
部分 (小數點右側) 是以一天內的小數計算時間。適用對象
例如，1900 年 1 月 1 日中午的下午是 2.5，2，因為現在過了 2 天
1899 年 12 月 30 日，以及 0.5，因為中午是半天。1900 年 2 月 1 日下午 3 點
為 33.625。
Google 試算表正確將 1900 年的資料視為一整年，而非閏年。
日期和時間格式模式
「日期時間格式模式」是一串權杖子字串，剖析後 會以對應的日期時間元素取代 (例如月份或 小時)。
日期和時間格式權杖
下表定義您可以在日期時間中使用的符記子字串
格式。+ 字元代表前一個字元
且仍然符合模式。字元未列於
下列資料表將視為常值，並在沒有變更的情況下輸出。
| 權杖 | 說明 |
|---|---|
h |
時段。切換 12 小時制和 24 小時制，具體取決於 字串中是否有上午或下午指標。 |
hh+ |
與上一個相同，但以 0 表示 1-9。 |
m |
如果先前的非常值符記為小時，或者後續符記為 秒，代表小時中的分鐘 (無前置 0)。否則 並以數字表示是一年中的月份 (無前置 0)。 |
M |
每年的月份，前面不加 0。利用這個權杖在模式中明確註明一個月 (而非一分鐘)。 |
mm |
與 m 相同，但兩者的開頭為 0。 |
MM |
一年中的月份，前方加 0。利用這個權杖在模式中明確註明一個月 (而非一分鐘)。 |
mmm |
由三個字母組成的月份縮寫 (例如「2」)。 |
mmmm |
完整月份名稱。「mmmmmm+」也與這個關鍵字相符。 |
mmmmm |
月份的第一個字母 (例如「J」代表 6 月)。 |
s |
一分鐘內的第幾秒，無前置 0。 |
ss |
一分鐘內的第幾秒，前方加 0。 |
[h+] |
在特定時間範圍內的經過時數。字母數量 表示數字位數的下限 (相加 0 秒)。 |
[m+] |
指定時間長度中的經過分鐘數。字母數量 表示數字位數的下限 (相加 0 秒)。 |
[s+] |
時間長度中的經過秒數。字母數量 表示數字位數的下限 (相加 0 秒)。 |
d |
日期，未前置 0 表示小於 10 的數字。 |
dd |
日期，前 0 位數代表小於 10 的數字。 |
ddd |
星期幾，三個字母的縮寫 (例如「Mon」)。 |
dddd+ |
星期幾，全名。 |
y |
2 位數的年份。 |
yy |
|
yyy |
4 位數年份。 |
yyyy+ |
|
a/p |
顯示「a」代表上午，「p」下午 4 點。一併將營業時間調整為 12 小時制。如果符記字母為大寫，輸出結果會是： 。 |
am/pm |
如上所述，但顯示「AM」或「下午」而且一律 大寫。 |
0 |
數十秒。您可以使用
00 或 3 位數 (毫秒)，含 000。 |
\ |
將下一個字元視為常值，而不是任何特殊字元 代表了檔案 |
"text" |
以常值的形式顯示引號內的任何文字。 |
日期和時間格式範例
以 Tuesday, April 5, 2016, 4:08:53.528 PM 這個日期和時間來說
下表提供一些範例模式及其對應的日期時間
算繪。表格第二部分會顯示經過時間的範例
經過時間格式3 hours, 13 minutes, 41.255 seconds：
| 日期時間模式 | 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 |
yyyy-mm-dd |
2016-04-05 |
mmmm d \[dddd\] |
4 月 5 日 [星期二] |
h PM, ddd mmm dd |
4 月 5 日星期二下午 4 點 |
dddd, m/d/yy at h:mm |
2016 年 4 月 5 日星期二 16:08 |
| 經過時間模式 | 3 hours, 13 minutes, 41.255 seconds |
[hh]:[mm]:[ss].000 |
03:13:41.255 |
[mmmm]:[ss].000 |
0193:41.255 |
數字格式模式
數字格式模式是一串符記子字串，剖析後 替換成對應的數字表示法數字格式模式 最多可包含四個部分 (以半形分號分隔) 分別用於正數、負數、零和文字 ( 順序)：
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
您不必將四個部分都以同一種格式加入。如果您只加入一個 區段，該格式適用於所有值。使用兩個部分會導致 這個格式應套用到零和正數，第二個格式則用於 負數。三個部分定義了不同的正向格式 代表整數，與 0 的數字例如：
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
不過，如果有兩個以上的部分，最後一個部分則是文字 系統會將該區段視為文字格式，其他部分則做為 還有一個區塊因此，只要加入最終的文字格式 定義以下格式：
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
系統會在其他剖析前將格式剖析為區段，因此 即可將日期或時間格式加入其中一個版面 (不過 且該用途有限)。
數字格式權杖
下表定義了可在格式區段中使用的符記子字串 定義如何表示該區的值
| 權杖 | 說明 |
|---|---|
0 |
代表數字中的數字。如果數字是無意義的 0，
卻顯示為 0例如數字格式
00.0 會將數字 3 轉譯為「03.0」。 |
# |
代表數字中的數字。如果數字是無意義的 0，
都不會顯示例如，格式為 ##0
會將數字 12 顯示為「12」。 |
? |
代表數字中的數字。如果數字是無意義的 0，
顯示為空格這通常用來對齊
。例如數字格式
???.??? 會將數字 12.4 算繪為：
」12.4」 |
. |
第一個句號代表數字中的小數點。隨後
句號會顯示為常值如果您的
即時顯示內容，即使是整數也不例外。例如：
#0.# 會將數字 3 轉譯為「3.」。 |
% |
顯示為常值，但也會導致現有數字相乘
即可顯示超過 100 個百分比
。例如，格式為 #%
會將數字 0.25 算繪為「25%」。 |
, |
如果內容出現在兩位數字元 (0,
# 或 ?)，則轉譯整個數字
和分組分隔符 (按千分之一分組)。假設符合
這會將數字乘以一千
(例如，#0.0,, 格式會將數字轉譯為數字)
12,200,000 為 12.2)。 |
E- |
以科學格式呈現數字，並使用
格式設為非指數的 E 左邊格式
做為指數
部分。E+顯示 + 符號表示正向
指數。E- 只會顯示負指數。如果
如果使用小寫，則輸出 e 也會使用小寫。
例如，格式為 ##0.00#E+##
會將數字 0.0000001 算繪為「100.00E-9」。 |
E+ |
|
e- |
|
e+ |
|
/ |
如果內容出現在兩位數字元 (0,
# 或 ?)，系統會將這些數字分組視為
分數格式。舉例來說，數字格式 0 #/# 會轉譯。
數字 23.25 為 23 1/4。分母
也可以是常值整數，在這種情況下，會強制將該整數視為
計算分母0 #/8 為數字格式
會將數字 23.25 顯示為 23 2/8。分數部分則非
。圖表中的數字
23.1 和數字格式 0 #/3 的算繪方式像
23 (因為 0.1 會四捨五入為 0/3)。/ 是
與科學格式或含有小數點的格式不相容
。 |
* |
此為與 Microsoft Excel 數字格式的相容性。目前忽略。 |
_ |
底線符記會略過下一個字元，並轉譯空格。這可用來 數字格式，也就是負值以括號括住。 |
\ |
將下一個字元視為常值，而不是任何特殊字元
代表了檔案例如，格式為 \#0
會將數字 10 顯示為「#10」。 |
"text" |
以常值的形式顯示引號內的任何文字。 |
@ |
如果儲存格有文字輸入，就會插入儲存格的原始文字。非 也無法與任何其他特殊字元相容 數值 (以一般格式顯示)。 |
$ - + ( ) : space |
Google 試算表會將這些字元視為常值，並顯示 不變。 |
中繼操作說明
此外，每個格式部分都有選用的中繼指示。
以 [] 字元分隔，位在格式前面，並提供
。中繼指示類型和指定兩種
區段可以同時使用：
| 操作說明 | 說明 |
|---|---|
[condition] |
取代以下項目的預設正數、負數或零比較
另一個條件運算式例如：
[<100]”Low”;[>1000]”High”;000 會轉譯字詞
值小於 100 時為「低」，超過 1000 的值則為「高」；上方為三位數
數字 (以 0 秒開頭) 表示兩者之間的任何物品。條件的
會套用至前兩種子格式。如果數字與多個子格式相符，
就會使用第一個相符的結果如果是第三種格式
「其他」值，否則當數字與
的格式，就會成為所有「#」填滿儲存格寬度。如果存在
第四種格式一律用於文字。 |
[Color] or [Color#] |
讓這個子格式呈現的所有值會與 指定的文字顏色。Color 的有效值為黑色。 藍色、青色、綠色、洋紅色、紅色、白色或黃色。 「#」的有效值Color# 中的值是 0&ndash1;56 (這個 調色盤 會顯示與每個數字對應的顏色清單)。數字格式 顏色會覆寫使用者在儲存格中輸入的色彩，但不包含 覆寫條件式格式設定設定的顏色。 |
數字格式範例
下表列出一些模式範例及對應的 格式化數字顯示：
| 數字 | 模式 | 格式化值 |
|---|---|---|
| 12345.125 | ####.# |
12345.1 |
| 12.34 | 000.0000 |
012.3400 |
| 12 | #.0# |
12.0 |
| 5 月 125 日 | # ???/??? |
5 1/8 吋 |
| 12000 | #,### |
12,000 |
| 1230000 | 0.0,,"M" |
120 萬 |
| 1234500000 | 0.00e+00 |
1.23e+09 |
| 123114.15115 MyText |
###0.000;"TEXT: "_(@_) |
123114.151 文字：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 |
高 低 0527 |