日期和数字格式

日期时间和数字格式可用于控制数据在工作表中的显示方式。Google 表格提供了一些常见格式供您选择，但您也可以自行定义格式。

在 Google 表格界面中，您可以使用格式 > 数字菜单为单元格应用数字格式和日期格式。在 Google 表格 API 中，您可以使用 spreadsheets.batchUpdate 方法调用来设置这些格式，以发送 UpdateCellsRequest 或 RepeatCellRequest。

本页介绍了如何定义新的日期和数字格式模式，您可以将这些模式添加到 API 请求中。为范围设置自定义日期时间格式或小数格式示例展示了如何使用该 API 设置格式模式。请注意，该格式的实际呈现方式取决于电子表格的 locale。本指南假定 locale 为 en_US。您可以通过使用 spreadsheets.get 请求读取 SpreadsheetProperties 来确定电子表格的 locale。

日期和时间值简介

与大多数其他电子表格应用一样，Google 表格会将日期和时间值视为小数值。这样，您就可以在公式中对它们执行算术运算，从而增加或减少天数或星期、对两个日期和时间进行加减运算，以及执行其他类似操作。

Google 表格使用电子表格中常用的公元纪年日期格式。值的整数部分（小数点左侧）用于计算自 1899 年 12 月 30 日以来的天数。小数部分（小数点右侧）将时间计为一天的一部分。例如，1900 年 1 月 1 日正午是 2.5，2，因为它是 1899 年 12 月 30 日之后的第 2 天，0.5，因为正午是半天。1900 年 2 月 1 日下午 3 点的值为 33.625。

Google 表格会正确地将 1900 年视为平年，而不是闰年。

日期和时间格式模式

日期时间格式模式是一系列令牌子字符串，在解析时会替换为相应的日期时间元素（例如月份或小时）。

日期和时间格式令牌

下表定义了您可以在日期时间格式模式中使用的令牌子字符串。+ 字符表示前一个字符可以出现 1 次或多次，并且仍与模式匹配。下表中未列出的字符会被视为字面量，并以原样输出。

日期和时间格式示例

下表列举了一些示例格式及其对应的日期时间呈现方式，假设日期和时间为 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]

将格式解析为部分是在其他解析之前进行的，因此可以将日期或时间格式作为其中一个部分包含在内（不过，这很少有用）。

数字格式令牌

下表定义了您可以在格式部分中使用的令牌子字符串，以定义如何表示该部分的值。

元指令

此外，每个格式部分都可以包含可选的元说明（用 [] 字符括起来），这些说明位于格式之前，用于提供其他说明。元指令有两种类型，给定分块可以同时使用这两种类型：

数字格式示例

下表列出了一些示例模式及其对应的格式化数字呈现方式：