Altova XMLSpy 2025 Enterprise Edition

Navigation: Code Generator > Generierte Klassen (C#)

Altova.Types.Duration

Die Klasse Altova.Types.Duration stellt die folgenden öffentlichen Mitglieder bereit.

Konstruktoren

	Name	Beschreibung
	Duration(Duration obj)	Initialisiert eine neue Instanz der Duration-Klasse auf das als Argument bereitgestellte Duration-Objekt.
	Duration(System.TimeSpan newvalue)	Initialisiert eine neue Instanz der Duration-Klasse auf das als Argument bereitgestellte System.TimeSpan-Objekt.
	Duration(long ticks)	Initialisiert eine neue Instanz der Duration-Klasse auf die Anzahl der als Argument bereitgestellten Zeiteinheiten.
	Duration(int newyears, int newmonths, int days, int hours, int minutes, int seconds, double partseconds, bool bnegative)	Initialisiert eine neue Instanz der Duration-Klasse auf eine Zeitdauer, die anhand von als Argumente bereitgestellten Bestandteilen erstellt wird.

Eigenschaften

	Name	Beschreibung
	int Months	Ruft die Anzahl der Monate der aktuellen Instanz von Duration ab oder definiert diese.
	System.TimeSpan Value	Ruft den Wert (als System.TimeSpan) der aktuellen Instanz von Duration ab oder definiert diesen.
	int Years	Ruft die Anzahl der Jahre der aktuellen Instanz von Duration ab oder definiert diese.

Methoden

Name

Beschreibung

override bool Equals(object other)

Gibt true zurück, wenn das angegebene Objekt gleich dem aktuellen Objekt ist; gibt andernfalls false zurück.

override int GetHashCode()

Gibt den Hash-Code der aktuellen Instanz zurück.

bool IsNegative()

Gibt true zurück, wenn die aktuelle Instanz von Duration eine negative Zeitdauer darstellt.

static Duration Parse( string s, ParseType pt )

Gibt anhand des als Argument bereitgestellten String ein Altova.Types.Duration-Objekt zurück, wobei der als Argument bereitgestellte Parse-Typ verwendet wird. Gültige Parse-Typwerte sind:

DURATION	Parse-Zeitdauer, wenn als Bestandteile der Zeitdauer Jahr, Monate, Tag sowie Uhrzeit vorhanden sind.
YEARMONTH	Parse-Zeitdauer, wenn nur die Teile Jahr und Monat vorhanden sind.
DAYTIME	Parse-Zeitdauer, wenn nur die Teile Tag und Uhrzeit vorhanden sind.

Beachten Sie, dass es sich hierbei um eine statische Methode handelt, die nur in der Klasse selbst und nicht in einer Instanz der Klasse aufgerufen werden kann.

override string ToString()

Konvertiert die aktuelle Duration-Instanz in einen String. So würde eine Zeitspanne von 3 Stunden, 4 Minuten und 5 Sekunden z.B. in "PT3H4M5S" konvertiert

string ToYearMonthString()

Konvertiert die aktuelle Duration-Instanz anhand des Parse-Typs "Jahr und Monat" in einen String.

Operatoren

Name	Beschreibung
!=	Ermittelt, ob Duration a ungleich Duration b ist.
==	Ermittelt, ob Duration a gleich Duration b ist.

Beispiele

Stellen Sie sicher, dass die Altova-Typen importiert wurden, bevor Sie die folgenden Codefragmente in Ihrem Programm verwenden:

using Altova.Types;

In den folgenden Codefragmenten werden verschiedene Möglichkeiten zur Erstellung von Duration-Objekten gezeigt:

protected static void DurationExample1()
{
// Create a new time span of 3 hours, 4 minutes, and 5 seconds
System.TimeSpan ts = new TimeSpan(3, 4, 5);
// Create a Duration from the time span
Duration dr = new Duration(ts);
// The output is: PT3H4M5S
Console.WriteLine("Duration created from TimeSpan: " + dr.ToString());

// Create a negative Altova.Types.Duration from 6 years, 5 months, 4 days, 3 hours,
// 2 minutes, 1 second, and .33 of a second
Duration dr1 = new Duration(6, 5, 4, 3, 2, 1, .33, true);
// The output is: -P6Y5M4DT3H2M1.33S
Console.WriteLine("Duration created from parts: " + dr1.ToString());

// Create a Duration from a string using the DAYTIME parse type
Duration dr2 = Altova.Types.Duration.Parse("-P4DT3H2M1S", Duration.ParseType.DAYTIME);
// The output is -P4DT3H2M1S
Console.WriteLine("Duration created from string: " + dr2.ToString());

// Create a duration from ticks
Duration dr3 = new Duration(System.DateTime.UtcNow.Ticks);
// Output the result
Console.WriteLine("Duration created from ticks: " + dr3.ToString());
}

In den folgenden Codefragmenten wird gezeigt, wie Werte aus Duration-Objekten ermittelt werden können:

protected static void DurationExample2()
{
// Create a negative Altova.Types.Duration from 6 years, 5 months, 4 days, 3 hours,
// 2 minutes, 1 second, and .33 of a second
Duration dr = new Duration(6, 5, 4, 3, 2, 1, .33, true);
// The output is: -P6Y5M4DT3H2M1.33S
Console.WriteLine("The complete duration is: " + dr.ToString());

// Get only the year and month part as string
string dr1 = dr.ToYearMonthString();
Console.WriteLine("The YEARMONTH part is: " + dr1);

// Get the number of years in duration
Console.WriteLine("Years: " + dr.Years);

// Get the number of months in duration
Console.WriteLine("Months: " + dr.Months);
}