# Time#Функция скрипта и диаграммы

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

Синтаксис:

time#(text[, format])

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

Аргументы

| Аргумент | Описание |
| --- | --- |
| text | Текстовая строка для оценки. |
| format | Строка, описывающая формат, который следует использовать для интерпретации текстовой строки. Если пропущено, то используется формат времени и десятичный разделитель из операционной системы.<br><br>Функция `Time#` поддерживает много вариантов формата для различных структур времени, например:<br><br>​`hh:mm:ss`― форматирует значение времени в стандартном формате и отображает часы, минуты и секунды с ведущими нулями.<br><br>​`hh:mm TT` ― ​использует 12-часовой формат с суффиксом AM/PM.<br><br>​`hh:mm` ― ​показывает только часы и минуты, опуская секунды.<br><br>​`hh.mm.ss` ― ​формат времени с другими разделителями, такими как точка (`.`), вместо двоеточия.<br><br>​`hh TT` ― ​включает только час и AM/PM.<br><br>​`hh "Hrs" mm "Mins"`― показывает время с пользовательским текстом, например Hrs.​<br><br>[Описания для форматов числа и времени](https://help.qlik.com/ru-RU/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |

Пример: выражения диаграммы

| Пример | Результат |
| --- | --- |
| `Time#('09:00:00')` | Возвращает `09:00:00`, если параметр `TimeFormat` равен `'hh:mm:ss'`. |
| `Time#( '09:00:00','hh:mm:ss' )` | Возвращает `09:00:00`, когда передан формат `'hh:mm:ss'`. |
| `Time#('03:25 PM', 'hh:mm TT')` | Возвращает `03:25 PM`, когда передан формат `'hh:mm TT'`. |

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

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/time_hash.htm)

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

Обзор

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

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

* Набор данных, который загружается в таблицу данных под именем `Example`.

* Следующее поле в таблице данных:

  * `InputTime`

* Переменная `TimeFormat`, которая использует формат `h:mm:ss TT`.

* Предшествующая загрузка, которая использует функцию `Time#` для преобразования текстового значения `InputTime` в поле времени/числовое поле `ParsedTime`, которое может использовать система.

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

```
SET TimeFormat='h:mm:ss TT';
Example:
Load
InputTime,
Time#(InputTime, 'hh-mm-ss') as ParsedTime
Inline [
InputTime
12-30-45
05-15-00
22-10-55
08-20-35
19-45-15
];
```

Результаты

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

* ` InputTime
                                       `

* `ParsedTime`

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

* `=Time(ParsedTime)`, чтобы посмотреть время в формате, который задан в скрипте загрузки по умолчанию.

Результирующая таблица

| Время ввода | Разобранное время | Время(РазобранноеВремя) |
| --- | --- | --- |
| 05-15-00 | 05-15-00 | 5:15:00 AM |
| 08-20-35 | 08-20-35 | 8:20:35 AM |
| 12-30-45 | 12-30-45 | 12:30:45 PM |
| 19-45-15 | 19-45-15 | 7:45:15 PM |
| 22-10-55 | 22-10-55 | 10:10:55 PM |

Значения в поле `InputTime` отображаются в виде текста с выравниванием по левому краю. После того как значения в `InputTime` будут разобраны с помощью функции `Time#`, будет создано результирующее поле `ParsedTime`. Значения в новом поле выравниваются по правому краю, поскольку теперь они рассматриваются как действительное значение времени. В третьем столбце функция `Time` используется для оценки значений `ParsedTime` как даты и форматирует их в соответствии с `TimeFormat` в скрипте загрузки.

## Пример. Сценарий использования функции Time\#

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/time_hash.htm)

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

Обзор

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

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

* Набор данных, который загружается в таблицу данных под именем `Example`.

* Следующее поле в таблице данных:

  * `NoDelimiterTime`

* Переменная `TimeFormat`, которая использует формат `hh.mm.ss`.

* Предшествующая загрузка, которая использует функцию `Time#` для преобразования текстового значения `NoDelimiterTime` в поле времени/числовое поле `ParsedNoDelimiterTime`.

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

```
SET TimeFormat='hh.mm.ss';
Example:
Load
NoDelimiterTime,
Time#(NoDelimiterTime, 'hhmmss') as ParsedNoDelimiterTime
Inline [
NoDelimiterTime
143015
091045
235959
060530
184010
]; 
```

Результаты

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

* ` NoDelimiterTime
                                       `

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

* `=Time(ParsedNoDelimiterTime,'hh:mm:ss')`, чтобы посмотреть время в формате, который задан в скрипте загрузки по умолчанию.

Результирующая таблица

| ВремяБезРазделителей | Время(РазобранноеВремяБезРазделителей,'hh:mm:ss') |
| --- | --- |
| 060530 | 06:05:30 |
| 091045 | 09:10:45 |
| 143015 | 14:30:15 |
| 184010 | 18:40:10 |
| 235959 | 23:59:59 |

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