Now, Today, IsTodayUTCTodayUTCNowIsUTCToday функции

Functions	Применимо к
Now	Приложения На основе холста Copilot Studio Desktop потоки формул dataverse, управляемые моделью приложений Power Platform CLI, функции Power Pages
Today IsToday	Приложения На основе холста Copilot Studio Desktop поддерживают функции Power Platform CLI Dataverse, управляемые моделью
UTCNow UTCToday	Столбцы формул dataverse

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

Description

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

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

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

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

UTCNow, UTCTodayи IsUTCToday функции совпадают со своими коллегами в формате UTC, но работают с независимыми значениями часового пояса и используют согласованное универсальное время (UTC).

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

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

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

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

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

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

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

Синтаксис

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

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 следующую формулу:

   Текст(ТекущееВремя, ДолгоеВремя24)

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

   

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

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

   

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

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

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

   Set(CurrentTime, Now())

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