Difference between revisions of "Category:Date/Time Functions"

From Mailutils
Jump to navigationJump to search
 
(One intermediate revision by the same user not shown)
Line 7: Line 7:
  
 
* Year is greater than 0 for years AD and less than 0 for years BC.
 
* Year is greater than 0 for years AD and less than 0 for years BC.
* 1 <= month <= 12
+
* 1 <= Month <= 12
 
* Days start at 1.
 
* Days start at 1.
  
The functions do no take into account the [http://en.wikipedia.org/wiki/Gregorian_calendar#Adoption change] from Julian to Gregorian calendars, as it occurred in various dates, depending on the country.  Hopefully no one would need to go that far back in time when dealing with email timestamps, so that's not considered a limitation.
+
The functions operate on Gregorian dates and do no take into account the [http://en.wikipedia.org/wiki/Gregorian_calendar#Adoption change] from Julian to Gregorian calendars, as it occurred in various dates, depending on the country.  Hopefully no one would need to go that far back in time when dealing with email timestamps, so that's not considered a limitation.
  
 
== Notes ==
 
== Notes ==
 
<references/>
 
<references/>

Latest revision as of 12:17, 17 December 2011

Mailutils date/time functions convert date/time between internal and human- or machine-readable representations in various formats. Special functions are provided for date calculations.

The function prototypes, data type declarations and macro definitions are located in file mailutils/datetime.h[1].

Whenever a function takes year, month or day as its input parameters, the following ranges are assumed:

  • Year is greater than 0 for years AD and less than 0 for years BC.
  • 1 <= Month <= 12
  • Days start at 1.

The functions operate on Gregorian dates and do no take into account the change from Julian to Gregorian calendars, as it occurred in various dates, depending on the country. Hopefully no one would need to go that far back in time when dealing with email timestamps, so that's not considered a limitation.

Notes