Дата и усилитель; числовые форматы

Форматы даты, времени и чисел позволяют управлять отображением данных в таблице. Google Таблицы предоставляют на выбор несколько распространённых форматов, но вы также можете определить свои собственные.

В пользовательском интерфейсе Таблиц форматы чисел и дат применяются к ячейкам через меню «Формат» > «Число» . В API Таблиц эти форматы задаются с помощью вызова метода spreadsheets.batchUpdate для отправки запроса UpdateCellsRequest или RepeatCellRequest .

На этой странице описывается, как определить новые шаблоны форматов дат и чисел, которые можно включить в запрос API. В примере «Задать пользовательский формат даты и времени или десятичный формат для диапазона» показано, как задать шаблон формата с помощью API. Обратите внимание, что фактическое отображение формата зависит от locale электронной таблицы. В данном руководстве предполагается, что locale — en_US . Вы можете определить locale электронной таблицы, прочитав SpreadsheetProperties с помощью запроса spreadsheets.get .

О значениях даты и времени

Таблицы, как и большинство других приложений для работы с электронными таблицами, обрабатывают значения даты и времени как десятичные числа. Это позволяет выполнять с ними арифметические действия в формулах, например, увеличивать дни или недели, складывать или вычитать две даты и времени, а также выполнять другие подобные операции.

В Google Таблицах используется форма записи даты эпохи , которая обычно применяется в электронных таблицах. Целая часть значения (слева от десятичной запятой) определяет количество дней, прошедших с 30 декабря 1899 года. Дробная часть (справа от десятичной запятой) определяет время как часть суток. Например, полдень 1 января 1900 года равен 2.5 : 2 , потому что это через 2 дня после 30 декабря 1899 года, и 0.5 потому что полдень — это половина суток. 1 февраля 1900 года в 15:00 равен 33.625 .

Шитс правильно считает 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]

Разбор формата на разделы происходит до другого разбора, поэтому можно включить формат даты или времени в качестве одного из разделов (хотя это имеет ограниченную полезность).

Токены числового формата

В следующей таблице определены подстроки токенов, которые можно использовать в разделе формата, чтобы определить, как представлять значения для этого раздела.

Мета-инструкции

Кроме того, каждый раздел формата может содержать необязательные метаинструкции, заключённые в символы [] , которые предшествуют формату и содержат дополнительные инструкции. Существует два типа метаинструкций, и данный раздел может использовать оба:

Примеры числовых форматов

В следующей таблице показаны некоторые примеры шаблонов и соответствующее им форматированное отображение чисел: