diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index d83135ba03..e61a20aa39 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -1,4 +1,4 @@ - + Functions and Operators @@ -5906,14 +5906,13 @@ SELECT (DATE '2001-02-16', INTERVAL '100 days') OVERLAPS - Note that when the age function operates on multi-month - intervals, PostgreSQL adds days to the earlier date - until full months can be added. This yields a different result than - adding full months first if the interval crosses from one month to the - next. For example, age('2004-06-01', '2004-04-30') yeilds - 1 mon 1 day using the PostgreSQL method, - while adding the month first would yield 1 mon 2 days - because May has 31 days, while April has only 30. + Note there can be ambiguity in the months returned by + age because different months have a different number of + days. PostgreSQL's approach uses the month from the + earlier of the two dates when calculating partial months. For example, + age('2004-06-01', '2004-04-30') uses April to yield + 1 mon 1 day, while using May would yield 1 mon 2 + days because May has 31 days, while April has only 30.