Now、Today、IsToday、UTCNow、UTCToday、IsUTCToday 函数

  • 项目

适用于：画布应用桌面流 Dataverse 公式列模型驱动应用 Power Platform CLI

返回当前日期和时间，以及测试某个日期/时间值是否为今天。

备注

PAC CLI pac power-fx 命令不支持 UTCNow、UTCToday 和 IsUTCToday 函数。

描述

Now 函数以日期/时间值返回当前日期和时间。

Today 函数以日期/时间值返回当前日期。 时间部分为午夜。 Today 在今天午夜到明天午夜的一整天中具有相同的值。

IsToday 函数测试某个日期/时间值是否介于今天午夜和明天午夜之间。 此函数返回布尔（true 或 false）值。

Now、Today 和 IsToday 函数使用的都是当前用户的本地时间。

UTCNow、UTCToday 和 IsUTCToday 函数与其非 UTC 对应部分相同，但使用时区无关值并使用协调世界时 (UTC)。

备注

  • UTCNow、UTCToday 和 IsUTCToday 仅在 Microsoft Dataverse for Teams 公式列中可用，并且仅适用于与时间无关的字段和值。
  • Now、Today 和 IsToday 在 Dataverse for Teams 公式列中不可用，因为计算是在不知道当前用户的本地时区的情况下完成的。
    详细信息：使用 Dataverse for Teams 中的公式表列

有关详细信息，请参阅数据类型文档中的日期、时间和日期/时间和使用日期和时间。

易失函数

Now、Today、UTCNow 和 UTCToday 是易失函数。 每次计算时，这些函数会返回不同的值。

在数据流公式中使用易失函数时，如果对含有该函数的公式进行重新计算，该函数会返回不同的值。 如果公式中没有任何其他更改，在应用执行期间，它会具有相同的值。

例如，如果一个 Label 控件设为 Label1.Text = Now()，则应用处于活动状态时，该控件不会改变。 只有关闭和重新打开应用会得到新值。

如果包含该函数的公式的其他内容发生了任何更改，会导致该函数进行重新计算。 例如，如果将示例更改为包含一个 Slider 控件，即设为 Label1.Text = DateAdd( Now(), Slider1.Value, Minutes )，则每当 Slider 控件的值发生更改时会检索当前时间，标签的 text 属性会进行重新计算。

如果在行为公式中使用易失函数，则每当计算该公式时，也会计算该函数。 请参阅下文查看示例。

语法

使用用户的本地时间

Now()

Today()

IsToday( DateTime )

  • DateTime - 必需。 要测试的日期/时间值。

使用协调世界时 (UTC)

UTCNow()

UTCToday()

IsUTCToday( TimeZoneIndependentTime )

  • TimeZoneIndependentDateTime - 必需。 要测试的时区无关日期/时间值。

示例

在本部分的示例中，当前时间是 2021 年 7 月 11 日的晚上 8:58，时区是太平洋时区 (UTC-8)，语言是 en-us。

公式 说明 结果
Text( Now(), "mm/dd/yyyy hh:mm:ss" ) 检索用户时区中的当前日期和时间，并将其显示为字符串。 "07/11/2021 20:58:00"
Text( Today(), "mm/dd/yyyy hh:mm:ss" ) 仅检索当前日期，时间部分为午夜，并将其显示为字符串。 "07/12/2021 00:00:00"
IsToday( Now() ) 测试当前日期和时间是否介于今天午夜和明天午夜之间。 true
IsToday( Today() ) 测试当前日期是否介于今天午夜和明天午夜之间。 true
Text( DateAdd( Now(), 12 ), "mm/dd/yyyy hh:mm:ss" ) 检索当前日期和时间，在结果基础上加 12 天，并将其显示为字符串。 "07/23/2021 20:58:00"
Text( DateAdd( Today(), 12 ), "mm/dd/yyyy hh:mm:ss" ) 检索当前日期，在结果基础上加 12 天，并将其显示为字符串。 "07/23/2021 00:00:00"
IsToday( DateAdd( Now(), 12 ) ) 测试当前日期和时间加 12 天是否介于今天午夜和明天午夜之间。 false
IsToday( DateAdd( Today(), 12 ) ) 测试当前日期加 12 天是否介于今天午夜和明天午夜之间。 false
Hour( UTCNow() ) 检索 UTC 格式的当前日期和时间并仅提取小时，此小时比本地时间早 8 小时。 4
Day( UTCToday() ) 仅检索 UTC 格式的当前日期并提取日，此日比本地时间早 1 天。 12
IsUTCToday( UTCNow() ) 测试当前日期和时间是否介于今天午夜和明天午夜之间（所有时间均为 UTC 时间）。 true
IsUTCToday( UTCToday() ) 测试当前日期是否介于今天午夜和明天午夜之间（所有时间均为 UTC 时间）。 true

显示一个会实时更新的时钟

  1. 添加一个 Timer 控件，将其 Duration 属性设置为 1000，并将其 Repeat 属性设置为 true。

    计时器将运行一秒钟，然后自动重新开始，并持续该模式。

  2. 将该控件的 OnTimerEnd 属性设置为以下公式：

    Set( CurrentTime, Now() )

    每当计时器重新开始（在一秒后），此公式会将 CurrentTime 全局变量设置为 Now 函数的当前值。

    屏幕包含一个 Timer 控件，其公式为 OnTimerEnd = Set(CurrentTime, Now())。

  3. 添加一个 Label 控件，然后将 Text 属性设置为以下公式：

    Text( CurrentTime, LongTime24 )

    使用 Text 函数来设置所需的日期和时间格式，或将此属性设置为 CurrentTime 以显示小时和分钟值，但不显示秒。

    屏幕包含一个 Label 控件，其“文本”属性设置为 Text( CurrentTime, LongTime24)。

  4. 按 F5 可预览应用，然后通过单击或点击计时器可启动计时器。

    标签持续显示当前时间（细化到秒）。

    四个屏幕显示四个时间值（13: 50:22、13:50:45、13:51:03 和 13:51:25）。

  5. 将计时器的 AutoStart 属性设置为 true，其 Visible 属性设置 false。

    计时器变为不可见，并自动启动。

  6. 设置屏幕的 OnStart属性，以使 CurrentTime 变量具有一个有效值，如以下示例所示：

    Set(CurrentTime, Now())

    标签会在应用启动时立即显示（在计时器运行完 1 秒之前）。