Extracts the Gregorian year from a serial Julian date
Excel: YEAR
Function Documentation
intyear(
int
nDate
calendar
dateSystem
)[inline]
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>usingnamespace Units::Date;
int main(){printf("\n The year is %d", year(1741667)); // The year is 0056printf("\n The year is %d", year(1841667, cal_Julian)); // The year is 0330return0;
}
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):
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>usingnamespace Units::Date;
void main(){printf("\n The year is %d", year(27325)); // The year is 1974printf("\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.