clock

（不推荐；请改用 datetime）日期向量形式的当前日期时间

不推荐使用 clock。要以 datetime 值形式返回当前日期和时间，请改用 datetime。有关更新代码的详细信息，请参阅版本历史记录或Replace Discouraged Instances of Serial Date Numbers and Date Strings。

语法

c = clock

[c tf] = clock

说明

示例

c = clock 返回一个六元素的日期向量，其中包含小数形式的当前日期时间：

[year month day hour minute seconds]

clock 函数根据系统时间计算当前日期时间。

示例

[c tf] = clock 返回第二个输出参量，如果当前日期时间发生在您系统时区的夏令时 (DST) 期间，则为 1 (true)，否则为 0 (false)。

示例

全部折叠

舍入为整数显示格式

打开实时脚本

要返回当前日期时间，请使用 clock 函数。设置输出格式，使浮点值最多显示五位数字。

format shortg
c = clock

c = 1×6

         2024            2           12           22           25       38.211

日期向量输出的第六个元素（秒）可以精确到小数点后的多个数字。

要舍入为整数显示格式，请使用 fix 函数。

fix(c)

ans = 1×6

        2024           2          12          22          25          38

确定当前时间是否发生在 DST 期间

打开实时脚本

要确定当前日期时间是否发生在夏令时 (DST) 期间，请使用 clock 函数的第二个输出。如果 c 发生在 DST 期间，则 tf 为 1 (true)，否则为 0 (false)。

format shortg
[c tf] = clock

c = 1×6

         2024            2           12           22           39       45.931

tf = logical
   0

局限性

MATLAB^® Online™ 返回当前协调世界时 (UTC)，而非本地时间。

提示

要确定事件持续时间，请使用 timeit 或 tic 和 toc 函数代替 clock 和 etime。clock 函数基于系统时间，系统时间可以由操作系统定期调整，因此在进行时间比较操作时该函数可能不可靠。

扩展功能

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

具有两个输出参量的 clock 不支持代码生成。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

版本历史记录

在 R2006a 之前推出

全部展开

R2022b: 不推荐

目前没有删除 clock 的计划。但是，推荐改用 datetime 函数。datetime 数据类型提供灵活的日期时间格式、纳秒精度的存储，以及考虑时区和夏令时的属性。

要以 datetime 值形式返回当前时间，请调用 datetime。您可以在不使用任何输入参量的情况下调用它，或使用 "now" 作为输入参量。

d = datetime
% or
d = datetime("now")

d = datetime
   15-Apr-2022 15:53:28

要以日期向量形式返回当前时间，请使用 datevec 函数将其拆分。

d = datevec(datetime)

另请参阅

tic | toc | cputime | fix | timeit | datetime