Time — функция скриптa и диаграммы

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

Синтаксис:

Time(number[, format])

Возвращаемые типы данных: двойное значение

Аргументы
Аргумент	Описание
number	Число для изменения формата.
format	Строка, описывающая, как будет отформатирована полученная строка времени. Если пропущено, то используется формат времени и десятичный разделитель из операционной системы. Функция Time поддерживает много вариантов формата для различных структур времени, например: hh:mm:ss ― формирует значение времени в стандартном формате и отображает часы, минуты и секунды с ведущими нулями. hh:mm TT ― использует 12-часовой формат с суффиксом AM/PM. hh:mm ― показывает только часы и минуты, опуская секунды. hh.mm.ss ― формат времени с другими разделителями, такими как точка (.) вместо двоеточия. hh TT ― включает только час и AM/PM. hh "Hrs" mm "Mins" ― показывает время с пользовательским текстом, например Hrs. Описания для форматов числа и времени

Пример: выражения диаграммы
Пример	Результат
Time( 0.375 )	Возвращает 09:00:00, если параметр TimeFormat равен 'hh:mm:ss'.
Time( 35648.375 )	Возвращает 09:00:00, когда параметр Timeformat передан со значением 'hh:mm:ss'.
Time( 0.99999, 'hh-mm' )	Возвращает 23-59, игнорируя параметр TimeFormat, поскольку формат задан в мере.

Пример. Основы использования функции Time

Обзор

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.

Скрипт загрузки содержит следующее:

Набор данных, который загружается в таблицу данных под именем Example.
Следующее поле в таблице данных:
- TimeValue
Переменная TimeFormat, которая использует формат hh:mm:ss.

Скрипт загрузки

SET TimeFormat='hh:mm:ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение:

TimeValue

Создайте следующие меры:

=Time(TimeValue ), чтобы просмотреть значение в виде времени, используя системный параметр.
=Time(TimeValue, 'hh-mm' ), чтобы просмотреть значение в виде времени с использованием формата, заданного в функции.
=Time(TimeValue, 'hh:mm:ss' ), чтобы просмотреть значение в виде времени с использованием формата, заданного в функции.
=Time(TimeValue, 'hh:mm TT' ), чтобы просмотреть значение в виде времени с использованием формата, заданного в функции.
=Time(TimeValue, 'hh:mm' ), чтобы просмотреть значение в виде времени с использованием формата, заданного в функции.
=Time(TimeValue, 'hh.mm.ss' ), чтобы просмотреть значение в виде времени с использованием формата, заданного в функции.
=Time(TimeValue, 'hh TT' ), чтобы просмотреть значение в виде времени с использованием формата, заданного в функции.
=Time(TimeValue, 'hh "Hrs" mm "Mins"' ), чтобы просмотреть значение в виде времени с использованием формата, заданного в функции.

Таблица результатов
TimeValue	Time(TimeValue)	Time(TimeValue, 'hh-mm')	Time(TimeValue, 'hh:mm:ss')	Time(TimeValue, 'hh:mm TT')	Time(TimeValue, 'hh:mm')	Time(TimeValue, 'hh.mm.ss')	Time(TimeValue, 'hh TT')	Time(TimeValue, 'hh "Hrs" mm "Mins"')
0.375	09:00:00	09-00	09:00:00	09:00 AM	09:00	09.00.00	09 AM	09 Hrs 00 Mins
0.99999	23:59:59	23-59	23:59:59	11:59 PM	23:59	23.59.59	11 PM	23 Hrs 59 Mins
35648.375	09:00:00	09-00	09:00:00	09:00 AM	09:00	09.00.00	09 AM	09 Hrs 00 Mins

Результаты показывают, как функция Time может отображать значения на основе формата, заданном в выражении функции.

Пример. Основы использования функции Time с другим параметром TimeFormat