TaiwanCalendar.AddYears-Methode
Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Jahren entspricht.
Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Overrides Function AddYears ( _
time As DateTime, _
years As Integer _
) As DateTime
'Usage
Dim instance As TaiwanCalendar
Dim time As DateTime
Dim years As Integer
Dim returnValue As DateTime
returnValue = instance.AddYears(time, years)
public override DateTime AddYears (
DateTime time,
int years
)
public:
virtual DateTime AddYears (
DateTime time,
int years
) override
public DateTime AddYears (
DateTime time,
int years
)
public override function AddYears (
time : DateTime,
years : int
) : DateTime
Parameter
- time
Die DateTime, der Jahre hinzugefügt werden sollen.
- years
Die Anzahl der hinzuzufügenden Jahre.
Rückgabewert
Die DateTime, die sich ergibt, wenn der angegebenen DateTime die angegebene Anzahl von Jahren hinzugefügt wird.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die resultierende DateTime liegt außerhalb des unterstützten Bereichs. |
Hinweise
Wenn der resultierende Tag kein gültiger Tag im resultierenden Monat des resultierenden Jahres ist, ist auch der Tag der resultierenden DateTime betroffen. Er wird in den letzten gültigen Tag im resultierenden Monat des resultierenden Jahres geändert. Der Monat der resultierenden DateTime entspricht dem der angegebenen DateTime. Diese Implementierung unterstützt ausschließlich den aktuellen Zeitraum. Deshalb wird eine ArgumentException ausgelöst, wenn das resultierende Jahr außerhalb des Zeitraums der angegebenen DateTime liegt. Die Tageszeit der resultierenden DateTime entspricht der der angegebenen DateTime.
Der Februar hat beispielsweise 28 Tage, nur in einem Schaltjahr hat er 29 Tage. Wenn das angegebene Datum der 29. Tag im Februar eines Schaltjahres und der Wert von years 1 ist, ist das resultierende Datum der 28. Februar des folgenden Jahres.
Wenn years negativ ist, liegt die resultierende DateTime zeitlich vor der angegebenen DateTime.
Beispiel
Im folgenden Codebeispiel werden die Werte mehrerer Komponenten von DateTime nach dem taiwanesischen Kalender angezeigt.
Imports System
Imports System.Globalization
Public Class SamplesTaiwanCalendar
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 TaiwanCalendar.
Dim myCal As New TaiwanCalendar()
' Displays the values of the DateTime.
Console.WriteLine("April 3, 2002 of the Gregorian calendar equals the following in the Taiwan 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 'SamplesTaiwanCalendar
'This code produces the following output.
'
'April 3, 2002 of the Gregorian calendar equals the following in the Taiwan calendar:
' Era: 1
' Year: 91
' Month: 4
' DayOfYear: 93
' DayOfMonth: 3
' DayOfWeek: Wednesday
'
'After adding two years and ten months:
' Era: 1
' Year: 94
' Month: 2
' DayOfYear: 34
' DayOfMonth: 3
' DayOfWeek: Thursday
using System;
using System.Globalization;
public class SamplesTaiwanCalendar {
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 TaiwanCalendar.
TaiwanCalendar myCal = new TaiwanCalendar();
// Displays the values of the DateTime.
Console.WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in the Taiwan 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 Taiwan calendar:
Era: 1
Year: 91
Month: 4
DayOfYear: 93
DayOfMonth: 3
DayOfWeek: Wednesday
After adding two years and ten months:
Era: 1
Year: 94
Month: 2
DayOfYear: 34
DayOfMonth: 3
DayOfWeek: Thursday
*/
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 TaiwanCalendar.
TaiwanCalendar^ myCal = gcnew TaiwanCalendar;
// Displays the values of the DateTime.
Console::WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in the Taiwan 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 Taiwan calendar:
Era: 1
Year: 91
Month: 4
DayOfYear: 93
DayOfMonth: 3
DayOfWeek: Wednesday
After adding two years and ten months:
Era: 1
Year: 94
Month: 2
DayOfYear: 34
DayOfMonth: 3
DayOfWeek: Thursday
*/
import System.*;
import System.Globalization.*;
public class SamplesTaiwanCalendar
{
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 TaiwanCalendar.
TaiwanCalendar myCal = new TaiwanCalendar();
// Displays the values of the DateTime.
Console.WriteLine("April 3, 2002 of the Gregorian calendar equals "
+ "the following in the Taiwan 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}",
myCal.GetDayOfWeek(myDT));
Console.WriteLine();
} //DisplayValues
} //SamplesTaiwanCalendar
/*
This code produces the following output.
April 3,2002 of the Gregorian calendar equals the following in the Taiwan calen
dar:
Era: 1
Year: 91
Month: 4
DayOfYear: 93
DayOfMonth: 3
DayOfWeek: Wednesday
After adding two years and ten months:
Era: 1
Year: 94
Month: 2
DayOfYear: 34
DayOfMonth: 3
DayOfWeek: Thursday
*/
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
TaiwanCalendar-Klasse
TaiwanCalendar-Member
System.Globalization-Namespace
System.DateTime
AddMonths
Calendar.AddWeeks
Calendar.AddDays
Calendar.AddHours
Calendar.AddMinutes
Calendar.AddSeconds
Calendar.AddMilliseconds