DateConvert: Simple but fast date conversion
DateConvert converts the DATESTR(0) format to a date vector or serial date number and backwards.
Matlab's DATENUM, DATEVEC and DATESTR accept a variety of inputs, but in consequence they are slow. If the input format is exactly known, the conversion can be much faster:
DATENUM('17-Oct-2009 11:08:23'): 2.97 sec
DateConvert('17-Oct-2009 11:08:23', 'number'): 0.039 sec
=> 1.3% (1000 loops, 1.5GHz Pentium-M, Matlab 7.7)
DateConvert does *not* validate the input date as Matlab's date functions:
DATEVEC('32-Feb-2008 25:62:63') replies [2008 3 4 2 2 7],
DateConvert('32-Feb-2008 25:61:67' , 'vector') replies [2008 2 32 25 61 67] !
So DateConvert is nearly trivial, but optimized for speed. I needed it for sorting 200'000 time stamps and reduced the time from 217 to 11 sec.
Please run the unit-test TestDateVec to check validity and speed.
Tested: Matlab 6.5, 7.7, 7.8, WinXP, 32bit.
Pure Matlab code, so compatibility to MacOS, Linux, 64 bit is expected.
English month names are needed.
Suggestions and question by email or in the comment section are very welcome.
See also: DateStr2Num (Jan Simon)
Jan (2020). DateConvert (https://www.mathworks.com/matlabcentral/fileexchange/25594-dateconvert), MATLAB Central File Exchange. Retrieved .
Call to external function "isEqualTol" removed from the test function. No changes in the main function.