日期和数字格式

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

在表格界面中，您可以使用 Format（格式）> Number（数字）菜单向单元格应用数字和日期格式。在表格 API 中，您可以通过使用 spreadsheets.batchUpdate 方法调用发送 UpdateCellsRequest 或 RepeatCellRequest 的方式设置这些格式。

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

日期和时间值简介

与大多数其他电子表格应用一样，Google 表格也以十进制值形式处理日期和时间值。这样，您就可以在公式中对这些值执行算数运算，从而递增天数或周数、将两个日期和时间相加或相减，以及执行其他类似运算。

表格使用电子表格中常用的公元纪年日期格式。值的整数部分（小数点左侧）表示自 1899 年 12 月 30 日以来的天数。小数部分（小数点右侧）表示时间在一天中所占的比例。例如，1900 年 1 月 1 日中午是 2.5，2 表示自 1899 年 12 月 30 日已过去 2 天，0.5 则是因为中午刚好是一天的一半。1900 年 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]

先将格式解析为多个部分，然后再进行其他解析，因此，可以在一个部分中包含日期或时间格式（不过效用有限）。

数字格式令牌

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

元指令

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

数字格式示例

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