日期(&P)；數字格式

透過日期/時間和數字格式，您可以控制資料在試算表中的顯示方式。Google 試算表提供了一些常見格式供您選擇，但您也可以自行定義格式。

在試算表 UI 中，您可以使用「格式」 >「數字」選單，將數字和日期格式套用至儲存格。在 Google 試算表 API 中，您可以使用 spreadsheets.batchUpdate 方法呼叫來設定這些格式，以便傳送 UpdateCellsRequest 或 RepeatCellRequest。

本頁說明如何定義新的日期和數字格式模式，並納入 API 要求。範例「為範圍設定自訂日期時間或小數格式」說明如何使用 API 設定格式模式。請注意，實際的格式算繪作業取決於試算表的 locale。本指南假設 locale 為 en_US。您可以使用 spreadsheets.get 要求讀取 SpreadsheetProperties，藉此判斷試算表的 locale。

關於日期和時間值

與大多數試算表應用程式一樣，Sheets 會將日期和時間值視為十進制值。這樣一來，您就能在公式中對這些值執行算術運算，藉此增加天數或週數、加減兩個日期和時間，以及執行其他類似作業。

試算表採用的紀元日期格式，是試算表中常用的格式。值的整數部分 (小數點左側) 會從 1899 年 12 月 30 日算起，計算天數。小數部分 (小數點右側) 會將時間計為一天的一部分。舉例來說，1900 年 1 月 1 日中午的時間是 2.5，2 是因為它是 1899 年 12 月 30 日後的 2 天，0.5 是因為中午是半天。1900 年 2 月 1 日下午 3 點是 33.625。

Sheets 會正確將 1900 年視為平年，而非閏年。

日期和時間格式模式

日期時間格式模式是符號子字串的字串，在剖析時會替換為對應的日期時間元素 (例如月份或小時)。

日期和時間格式符記

下表定義了可用於日期/時間格式模式的符記子字串。+ 字元表示前一個字元可出現一或多次，仍可與模式相符。下表未列出的字元會視為常值，並以原樣輸出。

日期和時間格式範例

假設日期和時間為 Tuesday, April 5, 2016, 4:08:53.528 PM，下表列出了日期模式範例，及其對應的日期時間算繪結果。表格第二部分列出經過時間為 3 hours, 13 minutes, 41.255 seconds 的經過時間格式範例：

數字格式模式

數字格式模式是符記子字串的字串，在剖析時會替換為相應的數字表示法。數字格式模式最多可包含四個部分，以分號分隔，定義用於正數、負數、零和文字的個別格式 (依序為)：

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

您不需要在格式中加入所有四個部分。如果您只包含一個部分，系統會將該格式套用至所有值。使用兩個區段會導致第一個格式套用至零和正數，第二個格式套用至負數。使用三個部分，可為正數、負數和零數定義不同的格式。例如：

[NUMBER FORMAT]
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT]
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]

不過，如果有兩個以上的部分，且最後一個部分是文字格式，系統會將該部分視為文字格式，而其他部分的行為則會視為少了一個部分。因此，只要加入最終文字格式，即可定義下列格式：

[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT]
[NUMBER FORMAT];[TEXT FORMAT]

將格式剖析為各個部分的剖析作業會在其他剖析作業之前執行，因此可以將日期或時間格式納入其中一個部分 (但實用性有限)。

數字格式符記

下表定義了您可以在格式區段中使用的符記子字串，用於定義該區段的值表示方式。

中繼指示

此外，每個格式區段都可以有選用的中繼指示，以 [] 字元包圍，放在格式之前，提供額外指示。元指令類型有兩種，且指定的區段可同時使用這兩種：

數字格式範例

下表列出部分模式範例，以及對應的格式化數字呈現方式：