# Time Функция скрипта и диаграммы
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.
[Описания для форматов числа и времени](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |
Пример: выражения диаграммы
| Пример | Результат |
| --- | --- |
| `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
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)
#### Выражение диаграммы
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.
Скрипт загрузки содержит следующее:
* Набор данных, который загружается в таблицу данных под именем `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
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)
#### Выражение диаграммы
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.
Скрипт загрузки содержит следующее:
* Набор данных, который загружается в таблицу данных под именем `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` может отображать значения на основе формата, заданном в выражении функции.