# Timestamp — функция скриптa и диаграммы TimeStamp() преобразует формат выражения в значение времени и даты, используя формат системных переменных в скрипте загрузки данных или в операционной системе (если не указана строка форматирования). Синтаксис: Timestamp(number[, format]) Возвращаемые типы данных: двойное значение Аргументы | Аргумент | Описание | | --- | --- | | number | Число для изменения формата. | | format | Строка, описывающая, как будет отформатирована полученная строка метки времени. Если пропущено, то используется краткий формат даты, формат времени и десятичный разделитель из операционной системы.

Функция `Timestamp` поддерживает много вариантов формата для различных структур времени, например:

`DD/MM/YYYY`: отображается только дата (например: `15/11/2024`).

​`YYYY-MM-DD hh:mm:ss`: ​отображается полная метка времени (например: `2024-11-15 13:30:45`).

`​MMM DD, YYYY`: ​отображается краткая версия месяца и полный год (например: `Nov 15, 2024`).

​`hh:mm:ss TT`: ​отображается только время в 12-часовом формате (например: `01:30:45 PM`).

`​HH:mm:ss`: ​отображается время в 24-часовом формате (например: `13:30:45`).

`​wwww, MMM DD YYYY`: ​отображается полный день недели и дата (например: `Friday, Nov 15 2024`).

`​YYYY-MM-DD hh:mm:ss.fff`: ​включает миллисекунды (например: `2024-11-15 13:30:45.123`​).

[Описания для форматов числа и времени](https://help.qlik.com/ru-RU/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) | Пример: выражения диаграммы | Пример | Результат | | --- | --- | | `Timestamp( 35648 )` | Возвращает `97-08-06 00:00:00`, когда `TimestampFormat` имеет значение `YY-MM-DD hh:mm:ss`. | | `Timestamp(35648,'YYYY-MM-DD hh.mm')` | Возвращает `1997-08-06 00.00`, когда передан формат `YYYY-MM-DD hh.mm`. | | `Timestamp( 35648,'M/D/YYYY h:mm:ss[.fff] TT')` | Возвращает `8/6/1997 12:00:00 AM`, когда передан формат `M/D/YYYY h:mm:ss[.fff] TT`. | | `Timestamp( 35648,'www, DD MMM YYYY hh:mm TT')` | Возвращает `Wed, 06 Aug 1997 12:00 AM`, когда передан формат `www, DD MMM YYYY hh:mm TT`. | ## Пример. Основы использования функции Timestamp [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.htm) #### Выражение диаграммы Обзор Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел. Скрипт загрузки содержит следующее: * Набор данных, который загружается в таблицу данных под именем `Example`. * Следующее поле в таблице данных: * `TimeStampValue` * Переменная `TimestampFormat`, которая использует формат `YY-MM-DD hh:mm:ss`. Скрипт загрузки ``` SET TimestampFormat='YY-MM-DD hh:mm:ss'; Example: Load * inline [ TimeStampValue 35648.375 35648 36648.875 36648.8756789 ]; ``` Результаты Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение: * `TimeStampValue` Создайте следующие меры: * `=Timestamp(TimeStampValue)`, чтобы просмотреть значение в виде метки времени, используя системный параметр. * `=Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. * `=Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. * `=Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. * `=Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. * `=Timestamp(TimeStampValue,'wwww, MMM DD YYYY')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. Таблица результатов | TimeStampValue | Timestamp(TimeStampValue) | Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm' | Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT') | Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff') | Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT') | Timestamp(TimeStampValue,'wwww, MMM DD YYYY') | | --- | --- | --- | --- | --- | --- | --- | | 35648 | 97-08-06 00:00:00 | 1997-08-06 00.00 | 8/6/1997 12:00:00 AM | 1997-08-06 00:00:00.000 | Wed, 06 Aug 1997 12:00 AM | Wednesday, Aug 06 1997 | | 35648.375 | 97-08-06 09:00:00 | 1997-08-06 09.00 | 8/6/1997 9:00:00 AM | 1997-08-06 09:00:00.000 | Wed, 06 Aug 1997 09:00 AM | Wednesday, Aug 06 1997 | | 36648.875 | 00-05-02 21:00:00 | 2000-05-02 21.00 | 5/2/2000 9:00:00 PM | 2000-05-02 21:00:00.000 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 | | 36648.8756789 | 00-05-02 21:00:58 | 2000-05-02 21.00 | 5/2/2000 9:00:58 PM | 2000-05-02 21:00:58.657 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 | Результаты показывают, как функция `TimestampFormat` может отображать значения, используя другие параметры формата. ## Пример. Основы использования функции Timestamp с другим параметром TimestampFormat [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.htm) #### Выражение диаграммы Обзор Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел. Скрипт загрузки содержит следующее: * Набор данных, который загружается в таблицу данных под именем `Example`. * Следующее поле в таблице данных: * `TimeStampValue` * Переменная `TimestampFormat`, которая использует формат `YY-MM-DD hh:mm:ss`. Скрипт загрузки ``` SET TimestampFormat='M/D/YY hh:mm:ss'; Example: Load * inline [ TimeStampValue 35648.375 35648 36648.875 36648.8756789 ]; ``` Результаты Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение: * `TimeStampValue` Создайте следующие меры: * `=Timestamp(TimeStampValue)`, чтобы просмотреть значение в виде метки времени, используя системный параметр. * `=Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. * `=Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. * `=Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. * `=Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. * `=Timestamp(TimeStampValue,'wwww, MMM DD YYYY')`, чтобы просмотреть значение в виде метки времени с использованием формата, заданного в функции. Таблица результатов | TimeStampValue | Timestamp(TimeStampValue) | Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm' | Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT') | Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff') | Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT') | Timestamp(TimeStampValue,'wwww, MMM DD YYYY') | | --- | --- | --- | --- | --- | --- | --- | | 35648 | 8/6/97 00:00:00 | 1997-08-06 00.00 | 8/6/1997 12:00:00 AM | 1997-08-06 00:00:00.000 | Wed, 06 Aug 1997 12:00 AM | Wednesday, Aug 06 1997 | | 35648.375 | 8/6/97 09:00:00 | 1997-08-06 09.00 | 8/6/1997 9:00:00 AM | 1997-08-06 09:00:00.000 | Wed, 06 Aug 1997 09:00 AM | Wednesday, Aug 06 1997 | | 36648.875 | 5/2/00 21:00:00 | 2000-05-02 21.00 | 5/2/2000 9:00:00 PM | 2000-05-02 21:00:00.000 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 | | 36648.8756789 | 5/2/00 21:00:58 | 2000-05-02 21.00 | 5/2/2000 9:00:58 PM | 2000-05-02 21:00:58.657 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 | Результаты показывают, как функция `TimestampFormat` может отображать значения, используя другие параметры формата. ## Пример. Изменение формата метки времени в заказах клиентов [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.htm) #### Выражение диаграммы Обзор Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел. Скрипт загрузки содержит следующее: * Набор данных, который загружается в таблицу данных под именем `Example`. * Следующие поля в таблице данных: * `Customer` * `CustomerName` * `OrderTimestamp` Скрипт загрузки ``` Example: Load * inline [ OrderID, CustomerName, OrderTimestamp 1, Alice, 2024-02-20 11:00:00 2, Bob, 2024-03-01 15:30:00 3, Charlie, 2024-04-12 09:45:00 4, David, 2024-05-21 21:10:00 5, Eve, 2024-06-30 14:25:00 ]; ``` Результаты Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения: * `OrderID` * `CustomerName` Создайте следующую меру: * `=Timestamp(OrderTimestamp, 'WWWW, DD MMM YYYY hh:mm TT')`, чтобы показать метку времени заказа в формате, который отображает день недели, дату и время. Таблица результатов | OrderID | CustomerName | Timestamp(OrderTimestamp, 'WWWW, DD MMM YYYY hh:mm TT') | | --- | --- | --- | | 1 | Alice | Tuesday, 20 Feb 2024 11:00 AM | | 2 | Bob | Friday, 01 Mar 2024 03:30 PM | | 3 | Charlie | Friday, 12 Apr 2024 09:45 AM | | 4 | David | Tuesday, 21 May 2024 09:10 PM | | 5 | Eve | Sunday, 30 Jun 2024 02:25 PM | С помощью функции `Timestamp` данные метки времени теперь форматируются с учетом дня недели и нового формата даты и времени.