Round Dates and Times

Version 1.6.5 (8.04 KB) by Stephen23
Round dates/times to the selected unit (round/floor/ceiling).

1.2K Downloads

Updated 30 Nov 2020

View License

This function rounds datetime or serial date numbers or date vectors to the nearest year, month, day, hour, minute, or second. With a choice of rounding, floor, or ceiling.

### Examples ###

Examples use the date+time described by the vector [1999,1,3,15,6,48.0568].

datevec(dateround(730123.62972287962))
ans = [1999,1,3,15,6,48]

datevec(dateround([1999,1,3,15,6,48.0568]))
ans = [1999,1,3,15,6,48]

datevec(dateround([1999,1,3,15,6,48.0568],'minute'))
ans = [1999,1,3,15,7,0]

datevec(dateround([1999,1,3,15,6,48.0568],5)) % 5=='minute'
ans = [1999,1,3,15,7,0]

datevec(dateround([1999,1,3,15,6,48.0568],5,'floor'))
ans = [1999,1,3,15,6,0]

datevec(dateround([1999,12,31,23,59,59.5000;1999,12,31,23,59,59.4999]))
ans = [2000,1,1,0,0,0;1999,12,31,23,59,59]

Cite As

Stephen23 (2023). Round Dates and Times (https://www.mathworks.com/matlabcentral/fileexchange/39274-round-dates-and-times), MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2010b
Compatible with any release
Platform Compatibility
Windows macOS Linux

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes
1.6.5

* Improve summary

1.6.4

* Add error IDs.

1.6.3.0

* Update FEX screenshot

1.6.2.0

* Update screenshot

1.6.1.0

* Update FEX screenshot

1.6

* Fixed orientation bug.
* Supports datetime inputs.
* Added HTML documentation.

1.5.0.0

* Make string arguments case insensitive.
* Improve input argument checking.

1.4.0.0

- Revert conversion precision adjustment to original value.

1.3.0.0

- Fixed incorrect order when rounding multiple dates.
- Improve internal precision management.

1.2.0.0

- Now only returns Date Numbers. This simplifies the code and the help comments.

1.1.0.0

- Fix bug in 'ceiling'.
- Unit tokens changed to match datestr8601/datenum8601 tokens.
- Simplify date format selection code.

1.0.0.0