Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

clock

Current date and time as date vector

Syntax

c = clock
[c tf] = clock

Description

example

c = clock returns a six-element date vector containing the current date and time in decimal form:

[year month day hour minute seconds]

The clock function calculates the current date and time from the system time.

example

[c tf] = clock returns a second output argument that is 1 (true) if the current date and time occur during Daylight Saving Time (DST) in your system's time zone, and 0 (false) otherwise.

Examples

collapse all

To return the current date and time, use the clock function. Set the output format so that floating-point values display with up to five digits.

format shortg
c = clock
c = 
         2017            9            1           16           59       40.437

The sixth element of the date vector output (seconds) is accurate to several digits beyond the decimal point.

To round to integer display format, use the fix function.

fix(c)
ans = 
        2017           9           1          16          59          40

To test whether the current date and time occur during Daylight Saving Time (DST), use the second output of the clock function. tf is 1 (true) if c occurs during DST, and 0 (false) otherwise.

format shortg
[c tf] = clock
c = 
         2017            9            1           17           11       38.746

tf = logical
   1

Tips

  • To time the duration of an event, use the timeit or tic and toc functions instead of clock and etime. The clock function is based on the system time, which can be adjusted periodically by the operating system, and thus might not be reliable in time comparison operations.

  • To return a datetime scalar representing the current date and time, type:

    t = datetime('now')

See Also

| | | | | | | |

Introduced before R2006a

Was this topic helpful?