viewed 2071 times and licensed 28 times
Extracts the year from a serial Julian date.
Excel: MONTH
View version details
Contents  |
|
Interface
#include <codecogs/units/date/year.h>
using namespace Units::Date;
| int | year (int nDate, calendar dateSystem)[inline] Extracts the year from a serial Julian date
Excel: MONTH |
| int | year (int nDate)[inline] Extracts the Gregorian year from a serial Julian date
Excel: YEAR |
Function Documentation
Returns the
year contained within a serial Julian date as an integer. This function uses
dateYMD, to convert the serial Date into a
day/ month/ year, from which the year is returned.
Example 1:
#include <stdio.h>
#include <codecogs/units/date/year.h>
using namespace Units::Date;
int main()
{
printf("\n The year is %d", year(1741667)); // The year is 0056
printf("\n The year is %d", year(1841667, cal_Julian)); // The year is 0330
return 0;
}
- cal_Gregorian - n.b. there is an optimised year function for Gregorian dates.
- cal_Julian - the only sensible mode (for the time being!!)
- cal_Excel (same as Gregorian)
Note:
- It may be faster to simply use dateYMD, particularly if you also need the day and year from a date.
Parameters:
| nDate | is a serial number of days from 24 November 4714 BC (1 January 4713BC in the Julian Calendar) - also known as the Julian Period. |
| dateSystem | selects which date system should be used (see constants): |
Authors:
- Will Bateman (Sep 2004)
Returns as an integer the Gregorian
year for the serial Julian date,
nDate. This function performs the following calculation:
where all division are integer divisions with the remainder discarded.
References:
www.ortelius.de/kalender/calc_en.php
Example 2:
#include <stdio.h>
#include <codecogs/units/date/year.h>
using namespace Units::Date;
void main()
{
printf("\n The year is %d", year(27325)); // The year is 1974
printf("\n The year is %d", year(169304)); // The year is 2367
}
Note:
- If you require the day, month and year from the Julian Date it may be faster to simply use dateYMD, particularly if you need two or more parts of a date.
Parameters:
| nDate | is a serial number of days from 24 November 4714 BC (1 January 4713BC in the Julian Calendar) - also known as the Julian Period. |
Authors:
- Will Bateman (Sep 2004)
Page Comments
You must login to leave a messge
Last Modified: 25 Oct 08 @ 09:56 Page Rendered: 2010-02-09 06:17:40