日期和数字格式

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

在表格界面中，您可以使用格式 > 数字菜单将数字和日期格式应用于单元格。在 Sheets 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 年视为常见年份，而非闰年。

日期和时间格式模式

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

日期和时间格式令牌

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

令牌	说明
h	一天中的时段。在 12 小时制和 24 小时制之间切换，具体取决于字符串中是否存在“上午”或“下午”指示符。
hh+	与上一个相同，但为 1-9 带前导 0。
m	如果前面的非字面令牌为小时或后面的为秒，它表示一小时中的分钟（没有前导 0）。否则，它以数字（不带前导 0）表示一年中的月份。
M	一年中不含前导 0 的月份。使用此令牌在您的模式中明确说明月份而不是一分钟。
mm	与 m 相同，但在两种情况下均带前导 0。
MM	一年中前导 0 的月份。使用此令牌在您的模式中明确说明月份而不是一分钟。
mmm	用 3 个字母表示的月份缩写（例如“January”）。
mmmm	月份的全名。mmmmmm+ 也匹配此项。
mmmmm	月份的第一个字母（例如，“J”表示 6 月）。
s	一分钟中的秒，不带前导 0。
ss	一分钟中的秒，含前导 0。
[h+]	一段时间中经过的小时数。字母数量表示最小位数（添加前导 0）。
[m+]	某个时间段内经过的分钟数。字母数量表示最小位数（添加前导 0）。
[s+]	一段时间中经过的秒数。字母数量表示最小位数（添加前导 0）。
d	一个月中的第几天，小于 10 的数字不带前导 0。
dd	一个月中的日，如果数字小于 10，则以 0 开头。
ddd	星期几，使用三个字母的缩写（例如“Mon”）。
dddd+	星期几，全名。
y	年（2 位数）。
yy
yyy	年（4 位数）。
yyyy+
a/p	针对上午显示“a”，针对下午显示“p”。此外，将小时格式更改为 12 小时制。如果词法单元字母大写，输出内容也是大写的。
am/pm	如上所述，但显示“AM”或“PM”，且始终大写。
0	十分之一秒。您可以使用 00 精确到两位数，或使用 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."	下午 4: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]

您无需在格式中包含全部四个部分。如果您只添加一个部分，则所有值都将采用该格式。使用两个部分会使第一个格式应用于零和正数，将第二个格式应用于负数。使用三个部分可定义正数、负数和零数的单独格式。例如：

[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- 只显示负指数符号。如果使用小写字母，则输出 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。如果分子变为 0，则不渲染分数部分。具有数字格式 0 #/3 的数字 23.1 将呈现为 23（因为 0.1 已四舍五入为 0/3）。/ 与科学格式或包含小数点的格式不兼容。
*	添加此文件是为了与 Microsoft Excel 数字格式兼容。目前已被忽略。
_	下划线标记跳过下一个字符并呈现一个空格。当负值用括号括起来时，用于对数字格式进行对齐。
\	将下一个字符视为字面量值，而不将其可能具有的任何特殊含义。例如，数字格式 \#0 会将数字 10 呈现为“#10”。
"text"	将引号内的所有文本显示为字面量。
@	如果单元格有文本输入，则会插入单元格的原始文本。与任何其他特殊字符均不兼容，并且系统不会为数值（显示为常规格式）显示该字符。
$ - + ( ) : space	Google 表格会将这些字符视为字面量，并按原样显示它们。

元指令

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

教学	说明
[condition]	将该部分的默认正数、负数或零比较替换为另一个条件表达式。例如，[<100]”Low”;[>1000]”High”;000 会为低于 100 的值呈现“Low”一词，如果值高于 1000，则会呈现“High”一词，如果该值介于 1000 之间，则会显示三位数数字（含前导 0）。条件只能应用于前两种子格式，如果某个数字与多个格式匹配，则使用匹配的第一个格式。如果有第三种格式，它就会用于“其他一切”；如果数字与任何一种格式都不匹配，它就会呈现为填满单元格宽度的所有“#”。如果存在第四种格式，则该格式将始终用于文本。
[Color] or [Color#]	会使此子格式渲染的任何值以给定的文本颜色显示。Color 的有效值包括 Black、Blue、Cyan、Green、Magenta、Red、White 或 Yellow。 Color# 中“#”的有效值为 0&ndash1;56（此调色板显示了与每个数字对应的颜色列表）。数字格式颜色会替换用户在单元格中输入的任何颜色，但不会替换通过条件格式设置的颜色。

数字格式示例

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

数字	模式	设置了格式的值
12345.125	####.#	12345.1
12.34	000.0000	012.3400
12	#.0#	12.0
5,125	# ???/???	5 月 8 日
12000	#,###	12000
1230000	0.0,,"M"	120 万
1234500000	0.00e+00	1.23e+09
123114.15115 我的文本	###0.000;"TEXT: "_(@_)	123114.151 文本：MyText
1234 -1234 0 我的文本	[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_)	1234 1234 0.0 MyText
1005 32 527	[>1000]"HIGH";[Color43][<=200]"LOW";0000	高 低 0527