Extracts the year from a serial Julian date. Excel: MONTH

Contents

Interface Function Documentation Page Comments

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:

#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;
}

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): 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.

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:

#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
}

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.

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.

Authors:

Will Bateman (Sep 2004)