日期和数字格式

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

在 Google 表格界面中，您可以使用格式 > 数字菜单将数字和日期格式应用于单元格。在 Sheets 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，因为它是 1899 年 12 月 30 日之后的第 2 天，而 0.5 是因为中午是半天。21900 年 2 月 1 日下午 3 点是 33.625。

Google 表格正确地将 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]

将格式解析为各个部分的过程发生在其他解析之前，因此可以将日期或时间格式作为其中一个部分包含在内（尽管这种做法的实用性有限）。

数字格式令牌

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

Meta 说明

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

数字格式示例

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