HebrewCalendar.AddYears メソッド

.NET Framework クラス ライブラリ リファレンス

HebrewCalendar.AddYears メソッド

指定した DateTime から指定した年数が経過した後の DateTime を返します。

名前空間: System.Globalization
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 AddYears ( _
    time As DateTime, _
    years As Integer _
) As DateTime

Visual Basic (使用法)

Dim instance As HebrewCalendar
Dim time As DateTime
Dim years As Integer
Dim returnValue As DateTime

returnValue = instance.AddYears(time, years)

C#

public override DateTime AddYears (
    DateTime time,
    int years
)

C++

public:
virtual DateTime AddYears (
    DateTime time, 
    int years
) override

J#

public DateTime AddYears (
    DateTime time, 
    int years
)

JScript

public override function AddYears (
    time : DateTime, 
    years : int
) : DateTime

パラメータ

time

years を加算する対象の DateTime。

years

追加する年数。

戻り値
指定した DateTime に指定した年数を加算した結果の DateTime。

例外

例外の種類	条件
ArgumentException	結果として得られる DateTime がサポートされている範囲外の値です。

解説

HebrewCalendar クラスのこの実装は、ヘブライ暦の 5343 年 ～ 5999 年 (グレゴリオ暦の 1583 年 ～ 2239 年) だけを認識します。

結果として得られる日が結果の年の結果の月に対して有効な日でない場合は、結果として得られる DateTime の日付部分が影響を受けます。この日付は、結果の年の結果の月にとって有効な最後の日付に変更されます。たとえば、Cheshvan の日数は、ユダヤ教の祝日に応じて 29 日または 30 日になります。Cheshvan の日数が現在の年に 30 日、翌年に 29 日あるとします。指定した日付が現在の年の Cheshvan の 30 日目であり、years の値が 1 である場合、結果として得られる日付は翌年の Cheshvan の 29 日目となります。

結果として得られる DateTime の月の部分は、結果の月が結果の年において有効でない場合は、その年で有効な最後の月に変更されます。たとえば、time パラメータの月が閏年の 13 番目の月で、years の値が 1 の場合、結果として得られる DateTime の月は、閏年ではない翌年の 12 番目の月です。月の部分が変更されない場合でも、その部分が示す実際の月は異なる可能性はあります。たとえば、Adar Beit は閏年の 7 番目の月ですが、Nissan は平年の 7 番目の月です。

この実装では現在の時代 (年号) だけをサポートしています。したがって、結果として得られた年が、指定された DateTime の時代 (年号) の範囲外の場合、ArgumentException がスローされます。

結果として得られる DateTime の時刻の部分は、指定した DateTime の値と同じままです。

years が負の場合、結果の DateTime は、指定した DateTime よりも前の値になります。

使用例

DateTime のいくつかのコンポーネントの値をヘブライ暦で表示する例を次に示します。

Visual Basic

Imports System
Imports System.Globalization


Public Class SamplesHebrewCalendar   

   Public Shared Sub Main()

      ' Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      Dim myDT As New DateTime(2002,
 4, 3, New GregorianCalendar())

      ' Creates an instance of the HebrewCalendar.
      Dim myCal As New HebrewCalendar()

      ' Displays the values of the DateTime.
      Console.WriteLine("April 3, 2002 of the Gregorian calendar
 equals the following in the Hebrew calendar:")
      DisplayValues(myCal, myDT)

      ' Adds two years and ten months.
      myDT = myCal.AddYears(myDT, 2)
      myDT = myCal.AddMonths(myDT, 10)

      ' Displays the values of the DateTime.
      Console.WriteLine("After adding two years and ten months:")
      DisplayValues(myCal, myDT)

   End Sub 'Main

   Public Shared Sub DisplayValues(myCal
 As Calendar, myDT As DateTime)
      Console.WriteLine("   Era:        {0}", myCal.GetEra(myDT))
      Console.WriteLine("   Year:       {0}", myCal.GetYear(myDT))
      Console.WriteLine("   Month:      {0}", myCal.GetMonth(myDT))
      Console.WriteLine("   DayOfYear:  {0}", myCal.GetDayOfYear(myDT))
      Console.WriteLine("   DayOfMonth: {0}", myCal.GetDayOfMonth(myDT))
      Console.WriteLine("   DayOfWeek:  {0}", myCal.GetDayOfWeek(myDT))
      Console.WriteLine()
   End Sub 'DisplayValues

End Class 'SamplesHebrewCalendar
 



'This code produces the following output.

'

'April 3, 2002 of the Gregorian calendar equals the following in the
 Hebrew calendar:

'   Era:        1

'   Year:       5762

'   Month:      7

'   DayOfYear:  198

'   DayOfMonth: 21

'   DayOfWeek:  Wednesday

'

'After adding two years and ten months:

'   Era:        1

'   Year:       5765

'   Month:      5

'   DayOfYear:  138

'   DayOfMonth: 21

'   DayOfWeek:  Monday

C#

using System;
using System.Globalization;


public class SamplesHebrewCalendar  {

   public static void Main()
  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new
 GregorianCalendar() );

      // Creates an instance of the HebrewCalendar.
      HebrewCalendar myCal = new HebrewCalendar();

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar equals the
 following in the Hebrew calendar:" );
      DisplayValues( myCal, myDT );

      // Adds two years and ten months.
      myDT = myCal.AddYears( myDT, 2 );
      myDT = myCal.AddMonths( myDT, 10 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding two years and ten months:" );
      DisplayValues( myCal, myDT );

   }

   public static void DisplayValues(
 Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:        {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:       {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:      {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:  {0}", myCal.GetDayOfYear( myDT
 ) );
      Console.WriteLine( "   DayOfMonth: {0}", myCal.GetDayOfMonth( myDT
 ) );
      Console.WriteLine( "   DayOfWeek:  {0}", myCal.GetDayOfWeek( myDT
 ) );
      Console.WriteLine();
   }

}

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in
 the Hebrew calendar:
   Era:        1
   Year:       5762
   Month:      7
   DayOfYear:  198
   DayOfMonth: 21
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       5765
   Month:      5
   DayOfYear:  138
   DayOfMonth: 21
   DayOfWeek:  Monday

*/

C++

using namespace System;
using namespace System::Globalization;
void DisplayValues( Calendar^ myCal, DateTime myDT )
{
   Console::WriteLine( "   Era:        {0}", myCal->GetEra( myDT ) );
   Console::WriteLine( "   Year:       {0}", myCal->GetYear( myDT )
 );
   Console::WriteLine( "   Month:      {0}", myCal->GetMonth( myDT )
 );
   Console::WriteLine( "   DayOfYear:  {0}", myCal->GetDayOfYear( myDT
 ) );
   Console::WriteLine( "   DayOfMonth: {0}", myCal->GetDayOfMonth( myDT
 ) );
   Console::WriteLine( "   DayOfWeek:  {0}", myCal->GetDayOfWeek( myDT
 ) );
   Console::WriteLine();
}

int main()
{
   
   // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
   DateTime myDT = DateTime(2002,4,3,gcnew GregorianCalendar);
   
   // Creates an instance of the HebrewCalendar.
   HebrewCalendar^ myCal = gcnew HebrewCalendar;
   
   // Displays the values of the DateTime.
   Console::WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in
 the Hebrew calendar:" );
   DisplayValues( myCal, myDT );
   
   // Adds two years and ten months.
   myDT = myCal->AddYears( myDT, 2 );
   myDT = myCal->AddMonths( myDT, 10 );
   
   // Displays the values of the DateTime.
   Console::WriteLine( "After adding two years and ten months:" );
   DisplayValues( myCal, myDT );
}

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in
 the Hebrew calendar:
   Era:        1
   Year:       5762
   Month:      7
   DayOfYear:  198
   DayOfMonth: 21
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       5765
   Month:      5
   DayOfYear:  138
   DayOfMonth: 21
   DayOfWeek:  Monday

*/

J#

import System.* ;
import System.Globalization.* ;

public class SamplesHebrewCalendar
{
    public static void main(String[]
 args)
    {
        // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
        DateTime myDT =  new DateTime(2002, 4, 3, new
 GregorianCalendar());

        // Creates an instance of the HebrewCalendar.
        HebrewCalendar myCal =  new HebrewCalendar();

        // Displays the values of the DateTime.
        Console.WriteLine("April 3, 2002 of the Gregorian calendar equals "
 
            + "the following in the Hebrew calendar:");
        DisplayValues(myCal, myDT);

        // Adds two years and ten months.
        myDT = myCal.AddYears(myDT, 2);
        myDT = myCal.AddMonths(myDT, 10);

        // Displays the values of the DateTime.
        Console.WriteLine("After adding two years and ten months:");
        DisplayValues(myCal, myDT);
    } //main
    
    public static void DisplayValues(Calendar
 myCal, DateTime myDT)
    {
        Console.WriteLine("   Era:        {0}", 
            System.Convert.ToString(myCal.GetEra(myDT)));
        Console.WriteLine("   Year:       {0}", 
            System.Convert.ToString(myCal.GetYear(myDT)));
        Console.WriteLine("   Month:      {0}", 
            System.Convert.ToString(myCal.GetMonth(myDT)));
        Console.WriteLine("   DayOfYear:  {0}", 
            System.Convert.ToString(myCal.GetDayOfYear(myDT)));
        Console.WriteLine("   DayOfMonth: {0}", 
            System.Convert.ToString(myCal.GetDayOfMonth(myDT)));
        Console.WriteLine("   DayOfWeek:  {0}", 
            System.Convert.ToString(myCal.GetDayOfWeek(myDT)));
        Console.WriteLine();
    } //DisplayValues
} //SamplesHebrewCalendar
 
/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in
 the 
    Hebrew calendar:
   Era:        1
   Year:       5762
   Month:      7
   DayOfYear:  198
   DayOfMonth: 21
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       5765
   Month:      5
   DayOfYear:  138
   DayOfMonth: 21
   DayOfWeek:  Monday
*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
HebrewCalendar クラス
HebrewCalendar メンバ
System.Globalization 名前空間
System.DateTime
AddMonths
Calendar.AddWeeks
Calendar.AddDays
Calendar.AddHours
Calendar.AddMinutes
Calendar.AddSeconds
Calendar.AddMilliseconds