// GregorianCalendar.cs
//
// (C) Ulrich Kunitz 2002
//
//
// Copyright (C) 2004 Novell, Inc (http://www.novell.com)
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to
// permit persons to whom the Software is furnished to do so, subject to
// the following conditions:
//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
namespace System.Globalization {
using System;
using System.Runtime.InteropServices;
///
/// This is the Gregorian calendar.
///
///
/// The Gregorian calendar supports only the Common Era from
/// the Gregorian year 1 to the Gregorian year 9999.
///
/// The implementation uses the
/// namespace.
///
///
[Serializable]
#if NET_2_0
[ComVisible (true)]
#endif
[MonoTODO ("Serialization format not compatible with .NET")]
public class GregorianCalendar : Calendar {
///
/// The era number for the Common Era (C.E.) or Anno Domini (A.D.)
/// respective.
///
public const int ADEra = 1;
/// Overridden. Gives the eras supported by the Gregorian
/// calendar as an array of integers.
///
public override int[] Eras {
get {
return new int[] { ADEra };
}
}
public override int TwoDigitYearMax
{
get {
return twoDigitYearMax;
}
set {
CheckReadOnly ();
M_ArgumentInRange ("value", value, 100, M_MaxYear);
twoDigitYearMax = value;
}
}
///
/// A protected member storing the
/// .
///
[NonSerialized]
internal GregorianCalendarTypes m_type;
///
/// The property stores the
/// .
///
public virtual GregorianCalendarTypes CalendarType {
get { return m_type; }
set {
CheckReadOnly ();
// mscorlib 1:0:3300:0 doesn't check anything here
m_type = value;
}
}
///
/// A protected method checking the era number.
///
/// The era number.
///
/// The exception is thrown if the era is not equal
/// .
///
internal void M_CheckEra(ref int era) {
if (era == CurrentEra)
era = ADEra;
if (era != ADEra)
throw new ArgumentException("Era value was not valid.");
}
///
/// A protected method checking calendar year and the era number.
///
/// An integer representing the calendar year.
///
/// The era number.
///
/// The exception is thrown if the era is not equal
/// .
///
///
/// The exception is thrown if the calendar year is outside of
/// the allowed range.
///
internal override void M_CheckYE(int year, ref int era) {
M_CheckEra(ref era);
M_ArgumentInRange("year", year, 1, 9999);
}
///
/// A protected method checking the calendar year, month, and
/// era number.
///
/// An integer representing the calendar year.
///
/// An integer giving the calendar month.
///
/// The era number.
///
/// The exception is thrown if the era is not equal
/// .
///
///
/// The exception is thrown if the calendar year or month is
/// outside of the allowed range.
///
internal void M_CheckYME(int year, int month, ref int era) {
M_CheckYE(year, ref era);
if (month < 1 || month > 12)
throw new ArgumentOutOfRangeException("month",
"Month must be between one and twelve.");
}
///
/// A protected method checking the calendar day, month, and year
/// and the era number.
///
/// An integer representing the calendar year.
///
/// An integer giving the calendar month.
///
/// An integer giving the calendar day.
///
/// The era number.
///
/// The exception is thrown if the era is not equal
/// .
///
///
/// The exception is thrown if the calendar year, month, or day is
/// outside of the allowed range.
///
internal void M_CheckYMDE(int year, int month, int day, ref int era)
{
M_CheckYME(year, month, ref era);
M_ArgumentInRange("day", day, 1,
GetDaysInMonth(year, month, era));
}
///
/// Overridden. Adds months to a given date.
///
/// The
/// to which to add
/// months.
///
/// The number of months to add.
/// A new value, that
/// results from adding to the specified
/// DateTime.
public override DateTime AddMonths(DateTime time, int months) {
return CCGregorianCalendar.AddMonths(time, months);
}
///
/// Overridden. Adds years to a given date.
///
/// The
/// to which to add
/// years.
///
/// The number of years to add.
/// A new value, that
/// results from adding to the specified
/// DateTime.
public override DateTime AddYears(DateTime time, int years) {
return CCGregorianCalendar.AddYears(time, years);
}
///
/// Overridden. Gets the day of the month from
/// .
///
/// The
/// that specifies a
/// date.
///
/// An integer giving the day of months, starting with 1.
///
public override int GetDayOfMonth(DateTime time) {
return CCGregorianCalendar.GetDayOfMonth(time);
}
///
/// Overridden. Gets the day of the week from the specified date.
///
/// The
/// that specifies a
/// date.
///
/// An integer giving the day of months, starting with 1.
///
public override DayOfWeek GetDayOfWeek(DateTime time) {
int rd = CCFixed.FromDateTime(time);
return (DayOfWeek)CCFixed.day_of_week(rd);
}
///
/// Overridden. Gives the number of the day in the year.
///
/// The
/// that specifies a
/// date.
///
/// An integer representing the day of the year,
/// starting with 1.
public override int GetDayOfYear(DateTime time) {
return CCGregorianCalendar.GetDayOfYear(time);
}
///
/// Overridden. Gives the number of days in the specified month
/// of the given year and era.
///
/// An integer that gives the year.
///
/// An integer that gives the month, starting
/// with 1.
/// An intger that gives the era of the specified
/// year.
/// An integer that gives the number of days of the
/// specified month.
///
/// The exception is thrown, if ,
/// ,or is outside
/// the allowed range.
///
public override int GetDaysInMonth(int year, int month, int era) {
// mscorlib doesn't check year, probably a bug; we do
M_CheckYME(year, month, ref era);
return CCGregorianCalendar.GetDaysInMonth(year, month);
}
///
/// Overridden. Gives the number of days of the specified
/// year of the given era.
///
/// An integer that specifies the year.
///
/// An ineger that specifies the era.
///
/// An integer that gives the number of days of the
/// specified year.
///
/// The exception is thrown, if
/// is outside the allowed range.
///
public override int GetDaysInYear(int year, int era) {
M_CheckYE(year, ref era);
return CCGregorianCalendar.GetDaysInYear(year);
}
///
/// Overridden. Gives the era of the specified date.
///
/// The
/// that specifies a
/// date.
///
/// An integer representing the era of the calendar.
///
public override int GetEra(DateTime time) {
return ADEra;
}
#if NET_2_0
[ComVisible (false)]
public override int GetLeapMonth (int year, int era)
{
return 0;
}
#endif
///
/// Overridden. Gives the number of the month of the specified
/// date.
///
/// The
/// that specifies a
/// date.
///
/// An integer representing the month,
/// starting with 1.
public override int GetMonth(DateTime time) {
return CCGregorianCalendar.GetMonth(time);
}
///
/// Overridden. Gives the number of months in the specified year
/// and era.
///
/// An integer that specifies the year.
///
/// An integer that specifies the era.
///
/// An integer that gives the number of the months in the
/// specified year.
///
/// The exception is thrown, if the year or the era are not valid.
///
public override int GetMonthsInYear(int year, int era) {
M_CheckYE(year, ref era);
return 12;
}
#if NET_2_0
[ComVisible (false)]
public override int GetWeekOfYear (DateTime date, CalendarWeekRule rule, DayOfWeek firstDayOfWeek)
{
return base.GetWeekOfYear (date, rule, firstDayOfWeek);
}
#endif
///
/// Overridden. Gives the number of the year of the specified
/// date.
///
/// The
/// that specifies a
/// date.
///
/// An integer representing the year,
/// starting with 1.
public override int GetYear(DateTime time) {
return CCGregorianCalendar.GetYear(time);
}
///
/// Overridden. Tells whether the given day
/// is a leap day.
///
/// An integer that specifies the year in the
/// given era.
///
/// An integer that specifies the month.
///
/// An integer that specifies the day.
///
/// An integer that specifies the era.
///
/// A boolean that tells whether the given day is a leap
/// day.
///
///
/// The exception is thrown, if the year, month, day, or era is not
/// valid.
///
public override bool IsLeapDay(int year, int month, int day, int era)
{
M_CheckYMDE(year, month, day, ref era);
return CCGregorianCalendar.IsLeapDay(year, month, day);
}
///
/// Overridden. Tells whether the given month
/// is a leap month.
///
/// An integer that specifies the year in the
/// given era.
///
/// An integer that specifies the month.
///
/// An integer that specifies the era.
///
/// A boolean that tells whether the given month is a leap
/// month.
///
///
/// The exception is thrown, if the year, month, or era is not
/// valid.
///
public override bool IsLeapMonth(int year, int month, int era) {
M_CheckYME(year, month, ref era);
return false;
}
///
/// Overridden. Tells whether the given year
/// is a leap year.
///
/// An integer that specifies the year in the
/// given era.
///
/// An integer that specifies the era.
///
/// A boolean that tells whether the given year is a leap
/// year.
///
///
/// The exception is thrown, if the year or era is not
/// valid.
///
public override bool IsLeapYear(int year, int era) {
M_CheckYE(year, ref era);
return CCGregorianCalendar.is_leap_year(year);
}
///
/// Overridden. Creates the
/// from the parameters.
///
/// An integer that gives the year in the
/// .
///
/// An integer that specifies the month.
///
/// An integer that specifies the day.
///
/// An integer that specifies the hour.
///
/// An integer that specifies the minute.
///
/// An integer that gives the second.
///
/// An integer that gives the
/// milliseconds.
///
/// An integer that specifies the era.
///
///
/// representig the date and time.
///
///
/// The exception is thrown, if at least one of the parameters
/// is out of range.
///
public override DateTime ToDateTime(int year, int month, int day,
int hour, int minute, int second, int milliseconds,
int era)
{
M_CheckYMDE(year, month, day, ref era);
M_CheckHMSM(hour, minute, second, milliseconds);
return CCGregorianCalendar.ToDateTime(
year, month, day,
hour, minute, second, milliseconds);
}
public override int ToFourDigitYear(int year)
{
return base.ToFourDigitYear (year);
}
///
/// Constructor that sets the
/// Gregorian calendar type (
/// ).
///
/// The parameter specifies the Gregorian
/// calendar type.
///
public GregorianCalendar(GregorianCalendarTypes type) {
CalendarType = type;
M_AbbrEraNames = new string[] {"AD"};
M_EraNames = new string[] {"A.D."};
if (twoDigitYearMax == 99)
twoDigitYearMax = 2029;
}
#if NET_2_0
[ComVisible (false)]
public override CalendarAlgorithmType AlgorithmType {
get {
return CalendarAlgorithmType.SolarCalendar;
}
}
static DateTime Min = new DateTime (1, 1, 1, 0, 0, 0);
static DateTime Max = new DateTime (9999, 12, 31, 11, 59, 59);
[ComVisible (false)]
public override DateTime MinSupportedDateTime {
get {
return Min;
}
}
[ComVisible (false)]
public override DateTime MaxSupportedDateTime {
get {
return Max;
}
}
#endif
///
/// Default constructor. Sets the Gregorian calendar type to
/// .
///
public GregorianCalendar() : this(GregorianCalendarTypes.Localized) {}
} // class GregorianCalendar
} // namespace System.Globalization