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

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

Синтаксис:

timestamp#(text[, format])

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

Аргументы

| Аргумент | Описание |
| --- | --- |
| text | Текстовая строка для оценки. |
| format | Строка, описывающая формат, который должен использоваться для интерпретации текстовой строки. Если пропущено, то используется краткий формат даты, формат времени и десятичный разделитель из операционной системы. Для меток времени поддерживается ISO 8601.<br><br>Функция `Timestamp#` поддерживает много вариантов формата для различных структур времени, например:<br><br>`DD/MM/YYYY`: отображается только дата (например: `15/11/2024`).<br><br>​`YYYY-MM-DD hh:mm:ss`: ​отображается полная метка времени (например: `2024-11-15 13:30:45`).<br><br>`​MMM DD, YYYY`: ​отображается краткая версия месяца и полный год (например: `Nov 15, 2024`).<br><br>​`hh:mm:ss TT`: ​отображается только время в 12-часовом формате (например: `01:30:45 PM`).<br><br>`​HH:mm:ss`: ​отображается время в 24-часовом формате (например: `13:30:45`).<br><br>`​wwww, MMM DD YYYY`: ​отображается полный день недели и дата (например: `Friday, Nov 15 2024`).<br><br>`​YYYY-MM-DD hh:mm:ss.fff`: ​включает миллисекунды (например: `2024-11-15 13:30:45.123`​).<br><br>[Описания для форматов числа и времени](https://help.qlik.com/ru-RU/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |

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

| Пример | Результат |
| --- | --- |
| `Timestamp#('12-03-2023 10:25:30', 'DD-MM-YYYY hh:mm:ss')` | Возвращает `12-03-2023 10:25:30` |
| `Timestamp#('2023/03/15 13:45', 'YYYY/MM/DD hh:mm')` | Возвращает `2023/03/15 13:45` |

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

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

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

Обзор

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

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

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

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

  * `InputString`

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

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

```
SET DateFormat='M/D/YYYY'
Example:
Load *,
Timestamp(Timestamp#(InputString)) as TimeStamp_InputString;
LOAD * INLINE [
InputString
2015-09-15T12:13:14
1952-10-16T13:14:00+0200
1109-03-01T14:15
];
```

Результаты

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

* ` InputString
                                       `

* `TimeStamp_InputString`

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

| InputString | TimeStamp\_InputString |
| --- | --- |
| 1109-03-01T14:15 | 3/1/1109 2:15:00 PM |
| 1952-10-16T13:14:00+0200 | 10/16/1952 11:14:00 AM |
| 2015-09-15T12:13:14 | 9/15/2015 12:13:14 PM |

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

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

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

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

Обзор

Данные из журнала событий содержат формат метки времени, который требуется использовать.

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

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

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

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

  * `Event`
  * `EventDateTime`

* Предшествующая загрузка, которая использует функцию `Timestamp#` для преобразования значений в поле `EventDateTime` в формат даты и времени, распознаваемый системой. При его выполнении создается дополнительное поле под именем `EventTimestamp`.

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

```
SET TimestampFormat='M/D/YYYY h:mm:ss[.fff] TT';
Example:
LOAD
Event,
EventDateTime,
Timestamp#(EventDateTime, 'DD-MM-YYYY hh:mm:ss') AS EventTimestamp
INLINE [
Event, EventDateTime
"Login", "12-03-2023 10:25:30"
"Logout", "12-03-2023 12:45:10"
"Login", "13-03-2023 09:10:15"
"Logout", "13-03-2023 17:30:20"
"Login", "14-03-2023 08:00:00"
];
```

Результаты

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

* ` Event
                                       `

* `EventDateTime`

* `EventTimestamp`

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

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

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

| Событие | EventDateTime | EventTimestamp | Timestamp(EventTimestamp) |
| --- | --- | --- | --- |
| Вход | 12-03-2023 10:25:30 | 12-03-2023 10:25:30 | 3/12/2023 10:25:30 AM |
| Вход | 13-03-2023 09:10:15 | 13-03-2023 09:10:15 | 3/13/2023 9:10:15 AM |
| Вход | 14-03-2023 08:00:00 | 14-03-2023 08:00:00 | 3/14/2023 8:00:00 AM |
| Выход | 12-03-2023 12:45:10 | 12-03-2023 12:45:10 | 3/12/2023 12:45:10 PM |
| Выход | 13-03-2023 17:30:20 | 13-03-2023 17:30:20 | 3/13/2023 5:30:20 PM |

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