Code covered by the BSD License

### Highlights from Round Serial Date Numbers or Date Vectors

5.0
5.0 | 3 ratings Rate this file 17 Downloads (last 30 days) File Size: 2.85 KB File ID: #39274 Version: 1.5

# Round Serial Date Numbers or Date Vectors

### Stephen Cobeldick (view profile)

03 Dec 2012 (Updated )

Round Serial Date Numbers or Date Vectors to the nearest desired unit (round/floor/ceiling).

File Information
Description

This function rounds 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]

Acknowledgements

This file inspired Iso 8601 Date String To Serial Date Number and Date Vector/Number To Iso 8601 Date String.

Required Products MATLAB
MATLAB release MATLAB 7.11 (R2010b)
MATLAB Search Path
`/`
14 Aug 2014 Jeff Jackson

### Jeff Jackson (view profile)

14 Aug 2014 Jeff Jackson

### Jeff Jackson (view profile)

16 Apr 2013 Jeff H

### Jeff H (view profile)

Nicely done. It is useful to have a time rounding fn to determine if times are equal within a tolerance, especially if they may have lost significant digits.

10 Dec 2012 1.1

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

21 May 2013 1.2

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

24 Jun 2013 1.3

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

08 Jul 2013 1.4

- Revert conversion precision adjustment to original value.

30 May 2015 1.5

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