Функции Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday

Применимо к: приложениям на основе холста классическим потокам столбцам формул Dataverse приложениям на основе модели интерфейсу командной строки Power Platform

Возвращают текущие дату и время, а также проверяют, относится ли значение даты и времени к сегодняшнему дню.

Description

Функция Now возвращает текущее значение даты и времени в формате даты и времени.

Функция Today возвращает текущее значение даты в формате даты и времени. В качестве времени в этом значении указывается полночь. Функция Today возвращает одно и то же значение в течение всех суток (с полуночи сегодняшнего до полуночи завтрашнего дня).

Функция IsToday проверяет, попадает ли заданное значение даты и времени в промежуток между полночью сегодняшнего и завтрашнего дня. Она возвращает логическое значение (true или false).

Функции Now, Today и IsToday работают с локальным временем текущего пользователя.

Функции UTCNow, UTCToday и IsUTCToday такие же, как и их аналоги без UTC, но работают со значениями, не зависящими от часового пояса, и используют время в формате UTC.

Дополнительные сведения см. в Дата, время и дата/время в документации по типам данных и работа с датами и временем.

Переменные функции

Now, Today, UTCNow и UTCToday — это переменные функции. Эти функции возвращают разные значения для каждой оценки.

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

Например, элемент управления Label со значением Label1.Text = Now() не изменится в активном приложении. Новое значение возвращается только после закрытия и повторного открытия приложения.

Если функция является частью формулы в которой изменилось что-то еще, она будет вычислена повторно. Например, если мы изменим пример и включим в него элемент управления Slider со значением Label1.Text = DateAdd( Now(), Slider1.Value, Minutes ), то при каждом изменении значения элемента управления Slider извлекается значение текущего времени и повторно вычисляется свойство Text элемента управления Label.

При использовании в формуле поведения переменные функции вычисляются каждый раз при вычислении этой формулы. Пример см. ниже.

Синтаксис

Использование местного времени пользователя

Now()

Today()

IsToday( дата и время )

• DateTime — обязательно. Значение даты и времени, которое нужно проверить.

Время в формате UTC

UTCNow()

UTCToday()

IsUTCToday( TimeZoneIndependentTime )

• TimeZoneIndependentDateTime — обязательно. Независимое от часового пояса значение даты/времени для проверки.

Примеры

Для примеров в этом разделе текущее время — 8:58 PM11 июля 2021, тихоокеанский часовой пояс (UTC-8) и язык en-us.

Отображение часов, обновляющихся в режиме реального времени

1. Добавьте элемент управления Timer, задайте его свойству Duration значение 1000, а свойству Repeat — значение true.

   Таймер будет работать в течение одной секунды, автоматически перезапустится и будет работать по этой схеме.

2. Задайте для свойства OnTimerEnd элемента управления следующую формулу в качестве значения.

   Set( CurrentTime, Now() )

   При каждом повторном запуске таймера (через каждую секунду) эта формула задает глобальной переменной CurrentTime текущее значение функции Now.

   

3. Добавьте элемент управления Label и задайте в качестве значения свойства Text следующую формулу:

   Text( CurrentTime, LongTime24 )

   С помощью функции Text отформатируйте дату и время, как вам нужно, или задайте этому свойству значение CurrentTime для отображения часов и минут, но не секунд.

   

4. Просмотрите приложение, нажав клавишу F5, а затем запустите таймер, щелкнув или коснувшись его.

   Элемент управления Labelпостоянно показывает текущее время вплоть до секунды.

   

5. Задайте свойству AutoStart таймера значение true, а свойству Visible — значение false.

   Таймер становится невидимым и запускается автоматически.

6. Задайте свойство OnStart экрана таким образом, чтобы переменная CurrentTime имела допустимое значение, как показано в этом примере:

   Set(CurrentTime, Now())

   Метка отображается сразу после запуска приложения (до того, как таймер проработает целую секунду).