Форматы даты и времени позволяют вам контролировать, как данные будут отображаться на листе. Google Таблицы предоставляют на выбор несколько общих форматов, но вы также можете определить свои собственные форматы.
В пользовательском интерфейсе Таблиц вы применяете числовые форматы и форматы дат к ячейкам с помощью меню «Формат» > «Числовой» . В API Таблиц вы устанавливаете эти форматы с помощью вызова метода spreadsheets.batchUpdate для отправки UpdateCellsRequest или RepeatCellRequest .
На этой странице описано, как определить новые шаблоны форматов даты и чисел, которые вы можете включить в свой запрос API. Пример установки пользовательского формата даты и времени или десятичного формата для диапазона показывает, как установить шаблон формата с помощью API. Обратите внимание, что фактическое отображение формата зависит от locale электронной таблицы. В этом руководстве предполагается, что locale — en_US . Вы можете определить locale электронной таблицы, прочитав SpreadsheetProperties с помощью запроса spreadsheets.get .
О значениях даты и времени
Таблицы, как и большинство других приложений для работы с электронными таблицами, обрабатывают значения даты и времени как десятичные значения. Это позволяет вам выполнять арифметические действия с ними в формулах: увеличивать дни или недели, добавлять или вычитать две даты и время и выполнять другие подобные операции.
В Таблицах используется форма даты эпохи , которая обычно используется в электронных таблицах. Целая часть значения (слева от десятичной точки) подсчитывает дни, прошедшие с 30 декабря 1899 года. Дробная часть (справа от десятичной точки) подсчитывает время как долю одного дня. Например, полдень 1 января 1900 года равен 2.5 , 2 , потому что это 2 дня после 30 декабря 1899 года, и 0.5 потому что полдень равен половине дня. 1 февраля 1900 года в 15:00 — 33.625 .
Шитс правильно считает 1900 год невисокосным, а не високосным.
Шаблоны формата даты и времени
Шаблон формата даты и времени представляет собой строку подстрок токенов, которые при анализе заменяются соответствующими элементами даты и времени (например, месяцем или часом).
Токены формата даты и времени
В следующей таблице определены подстроки токенов, которые можно использовать в шаблоне формата даты и времени. Символ + указывает, что предыдущий символ может появляться один или несколько раз и при этом соответствовать шаблону. Символы, не перечисленные в таблице ниже, рассматриваются как литералы и выводятся без изменений.
| Токен | Описание |
|---|---|
h | Час дня. Переключает между 12- и 24-часовым форматом в зависимости от того, присутствует ли в строке индикатор AM или PM. |
hh+ | То же, что и предыдущее, но с ведущим 0 для 1-9. |
m | Если предыдущий небуквенный токен был часами, а последующий — секундами, он представляет минуты в часе (без ведущего 0). В противном случае он представляет месяц года в виде числа (без ведущего 0). |
M | Месяц года без ведущего 0. Используйте этот токен, чтобы явно указать в шаблоне месяц, а не минуту. |
mm | То же, что и m , но в обоих случаях с ведущим 0. |
MM | Месяц года с ведущим 0. Используйте этот токен, чтобы явно указать в шаблоне месяц, а не минуту. |
mmm | Трехбуквенное сокращение месяца (например, «Фев»). |
mmmm | Полное название месяца. mmmmmm+ тоже соответствует этому. |
mmmmm | Первая буква месяца (например, «J» — июнь). |
s | Секунды в минуте без ведущего 0. |
ss | Секунды в минуте с ведущим 0. |
[h+] | Количество часов, прошедших за определенный период времени. Количество букв указывает минимальное количество цифр (добавляются ведущие 0). |
[m+] | Количество прошедших минут за определенный период времени. Количество букв указывает минимальное количество цифр (добавляются ведущие 0). |
[s+] | Количество прошедших секунд в течение определенного периода времени. Количество букв указывает минимальное количество цифр (добавляются ведущие 0). |
d | День месяца, без ведущего 0 для чисел меньше 10. |
dd | День месяца, с ведущим 0 для чисел меньше 10. |
ddd | День недели, трехбуквенная аббревиатура (например, «Пн»). |
dddd+ | День недели, полное название. |
y | 2-значный год. |
yy | |
yyy | 4-значный год. |
yyyy+ | |
a/p | Отображает «a» для AM и «p» для PM. Также меняет часы на 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." | 16:08 |
yyyy-mm-dd | 05.04.2016 |
mmmm d \[dddd\] | 5 апреля [вторник] |
h PM, ddd mmm dd | 16:00, вторник, 5 апреля |
dddd, m/d/yy at h:mm | Вторник, 05.04.16 в 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. Число 23,1 в числовом формате 0 #/3 отображается как просто 23 (поскольку 0,1 округляется до 0/3). / несовместим с научным форматом или форматом с десятичной точкой. |
* | Это включено для совместимости с числовыми форматами Microsoft Excel. В настоящее время это игнорируется. |
_ | Токен подчеркивания пропускает следующий символ и отображает пробел. Это используется для выравнивания числовых форматов, в которых отрицательное значение заключено в круглые скобки. |
\ | Рассматривает следующий символ как буквальное значение, а не какое-то особое значение, которое он может иметь. Например, числовой формат \#0 отображает число 10 как « #10 ». |
"text" | Отображает текст, находящийся внутри кавычек, как литерал. |
@ | Если ячейка имеет текстовый ввод, она вставляет необработанный текст для ячейки. Несовместим ни с какими другими специальными символами и не отображается для числовых значений (которые отображаются в общем формате). |
$ - + ( ) : space | Sheets рассматривает эти символы как литералы и отображает их без изменений. |
Мета-инструкции
Кроме того, каждый из разделов формата может иметь дополнительные метаинструкции, заключенные в символы [] , которые предшествуют формату и предоставляют дополнительные инструкции. Существует два типа метаинструкций, и в данном разделе можно использовать оба:
| Инструкция | Описание |
|---|---|
[ condition ] | Заменяет положительное, отрицательное или нулевое сравнение раздела по умолчанию другим условным выражением. Например, [<100]”Low”;[>1000]”High”;000 отображает слово «Низкий» для значений ниже 100, «Высокий» для значений выше 1000 и трехзначное число (с ведущими нулями). для чего-либо между ними. Условия могут применяться только к первым двум подформатам, и если число соответствует более чем одному, используется первый из них, которому оно соответствует. Если существует третий формат, он используется для «всего остального», в противном случае, если число не соответствует ни одному из форматов, оно отображается как все символы «#», заполняющие ширину ячейки. Если он существует, для текста всегда используется четвертый формат. |
[ Color ] or [ Color# ] | Приводит к тому, что любое значение, отображаемое этим подформатом, отображается с заданным цветом текста. Допустимые значения Color : черный, синий, голубой, зеленый, пурпурный, красный, белый или желтый. Допустимые значения «#» в Color# : 1–56 (эта цветовая палитра показывает список цветов, соответствующих каждому числу). Цвета числового формата переопределяют любые введенные пользователем цвета в ячейке, но не переопределяют цвета, заданные при условном форматировании. |
Примеры числового формата
В следующей таблице показаны некоторые примеры шаблонов и соответствующий им рендеринг форматированных чисел:
| Число | Шаблон | Форматированное значение |
|---|---|---|
| 12345.125 | ####.# | 12345.1 |
| 12.34 | 000.0000 | 012.3400 |
| 12 | #.0# | 12,0 |
| 5.125 | # ???/??? | 5 1/8 |
| 12000 | #,### | 12 000 |
| 1230000 | 0.0,,"M" | 1,2 млн. |
| 1234500000 | 0.00e+00 | 1.23e+09 |
| 123114.15115 Мойтекст | ###0.000;"TEXT: "_(@_) | 123114.151 ТЕКСТ: МойТекст |
| 1234 -1234 0 Мойтекст | [Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) | 1234 1234 0,0 Мойтекст |
| 1005 32 527 | [>1000]"HIGH";[Color43][<=200]"LOW";0000 | ВЫСОКИЙ НИЗКИЙ 0527 |