KoreanCalendar.AddMonths メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

KoreanCalendar.AddMonths メソッド

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

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

Visual Basic (宣言)

Public Overrides Function
 AddMonths ( _
    time As DateTime, _
    months As Integer _
) As DateTime

Visual Basic (使用法)

Dim instance As KoreanCalendar
Dim time As DateTime
Dim months As Integer
Dim returnValue As DateTime

returnValue = instance.AddMonths(time, months)

public override DateTime AddMonths (
    DateTime time,
    int months
)

C++

public:
virtual DateTime AddMonths (
    DateTime time, 
    int months
) override

public DateTime AddMonths (
    DateTime time, 
    int months
)

JScript

public override function AddMonths (
    time : DateTime, 
    months : int
) : DateTime

パラメータ

time: 月数を加算する対象の DateTime。

months: 加算する月の数。

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

例外

例外の種類	条件
ArgumentException	結果として得られる DateTime がサポートされている範囲外の値です。
ArgumentOutOfRangeException	months が -120000 未満です。または months が 120000 より大きい値です。

例外の種類

条件

ArgumentException

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

ArgumentOutOfRangeException

months が -120000 未満です。

または

months が 120000 より大きい値です。

解説

結果として得られる日が結果の年の結果の月に対して有効な日でない場合は、結果として得られる DateTime の日付部分が影響を受けます。この日付は、結果の年の結果の月にとって有効な最後の日付に変更されます。結果として得られる月が、指定した DateTime の年の範囲外の場合、結果として得られる DateTime の年の部分に影響します。この実装では現在の時代 (年号) だけをサポートしています。したがって、結果として得られた年が、指定された DateTime の時代 (年号) の範囲外の場合、ArgumentException がスローされます。結果として得られる DateTime の時刻の部分は、指定した DateTime の値と同じままです。

たとえば、指定した月が 31 日まである 10 月で、指定した日がその月の 31 番目の日であり、months パラメータの値が 6 の場合、結果として得られる年は指定した年より 1 大きい年、月は 4 月、日は 4 月の最終日である 30 日になります。

months パラメータの値が負の場合、結果の DateTime は、指定した DateTime よりも前の値になります。

使用例

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

Visual Basic

Imports System
Imports System.Globalization


Public Class SamplesKoreanCalendar   

   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 KoreanCalendar.
      Dim myCal As New KoreanCalendar()

      ' Displays the values of the DateTime.
      Console.WriteLine("April 3, 2002 of the Gregorian calendar
 equals the following in the Korean 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 'SamplesKoreanCalendar
 


'This code produces the following output.

'

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

'   Era:        1

'   Year:       4335

'   Month:      4

'   DayOfYear:  93

'   DayOfMonth: 3

'   DayOfWeek:  Wednesday

'

'After adding two years and ten months:

'   Era:        1

'   Year:       4338

'   Month:      2

'   DayOfYear:  34

'   DayOfMonth: 3

'   DayOfWeek:  Thursday

using System;
using System.Globalization;


public class SamplesKoreanCalendar  {

   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 KoreanCalendar.
      KoreanCalendar myCal = new KoreanCalendar();

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar equals the
 following in the Korean 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 Korean calendar:
   Era:        1
   Year:       4335
   Month:      4
   DayOfYear:  93
   DayOfMonth: 3
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       4338
   Month:      2
   DayOfYear:  34
   DayOfMonth: 3
   DayOfWeek:  Thursday

*/

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 KoreanCalendar.
   KoreanCalendar^ myCal = gcnew KoreanCalendar;
   
   // Displays the values of the DateTime.
   Console::WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in
 the Korean 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 Korean calendar:
   Era:        1
   Year:       4335
   Month:      4
   DayOfYear:  93
   DayOfMonth: 3
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       4338
   Month:      2
   DayOfYear:  34
   DayOfMonth: 3
   DayOfWeek:  Thursday

*/

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

public class SamplesKoreanCalendar
{   
    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 KoreanCalendar.
        KoreanCalendar myCal =  new KoreanCalendar();

        // Displays the values of the DateTime.
        Console.WriteLine("April 3, 2002 of the Gregorian calendar equals"
            + " the following in the Korean 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
} //SamplesKoreanCalendar

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in
 the
 Korean calendar:
   Era:        1
   Year:       4335
   Month:      4
   DayOfYear:  93
   DayOfMonth: 3
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       4338
   Month:      2
   DayOfYear:  34
   DayOfMonth: 3
   DayOfWeek:  Thursday

*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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

>> 「KoreanCalendar.AddMonths メソッド」を含む用語の索引
KoreanCalendar.AddMonths メソッドのページへのリンク


	© 2025 Microsoft.All rights reserved.

KoreanCalendar.AddMonths メソッドとは？ わかりやすく解説

KoreanCalendar.AddMonths メソッド

急上昇のことば

KoreanCalendar.AddMonths メソッドとは？わかりやすく解説