changeset 32277:036fdcd3e7c1

maint: Merge stable to default.
author Markus Mützel <markus.muetzel@gmx.de>
date Sat, 26 Aug 2023 13:28:43 +0200
parents 66d977e17588 (current diff) 2e8b8d38431c (diff)
children 3de9f020ce41
files scripts/time/datevec.m
diffstat 1 files changed, 11 insertions(+), 9 deletions(-) [+]
line wrap: on
line diff
--- a/scripts/time/datevec.m	Sat Aug 26 10:15:16 2023 +1200
+++ b/scripts/time/datevec.m	Sat Aug 26 13:28:43 2023 +0200
@@ -36,15 +36,17 @@
 ## month, day, hour, minute, and seconds respectively.
 ##
 ## @var{f} is the format string used to interpret date strings
-## (@pxref{XREFdatestr,,@code{datestr}}).  If @var{date} is a string, but no
-## format is specified, then a relatively slow search is performed through
-## various formats.  It is always preferable to specify the format string
-## @var{f} if it is known.  Formats which do not specify a particular time
-## component will have the value set to zero.  Formats which do not specify a
-## date will default to January 1st of the current year. @code{datevec} will
-## look for a string match up to the number of characters in @var{f}.  Trailing
-## characters are ignored for the purpose of calculating the dat vector, even
-## if the characters contain additional time/date information.
+## (@pxref{XREFdatestr,,@code{datestr}}).  If @var{date} is a string or a cell
+## array of strings, but no format is specified, heuristics are used to guess
+## the input format.  These heuristics could lead to matches that differ from
+## the result a user might expect.  Additionally, this involves a relatively
+## slow search through various formats.  It is always preferable to specify the
+## format string @var{f} if it is known.  Formats which do not specify a
+## particular time component will have the value set to zero.  Formats which do
+## not specify a particular date component will default that component to
+## January 1st of the current year.  Trailing characters are ignored for the
+## purpose of calculating the date vector, even if the characters contain
+## additional time/date information.
 ##
 ## @var{p} is the year at the start of the century to which two-digit years
 ## will be referenced.  If not specified, it defaults to the current year minus