Altova XMLSpy 2024 Enterprise Edition

Navigation: Générateur de code > Référence aux classes générées (C#)

Altova.Types.Duration

Cette classe vous permet de traiter des attributs XML ou des éléments de type xs: duration .

Constructeurs

	Nom	Description
	Duration(Duration obj)	Initialise une nouvelle instance de la classe Duration dans l’objet Duration fournie en tant qu’argument.
	Duration(Duration newvalue)	Initialise une nouvelle instance de la classe Duration dans l’objet System.TimeSpan fournie en tant qu’argument.
	Duration(long ticks)	Initialise une nouvelle instance de la classe Duration dans la le nombre de tics fournie en tant qu’argument.
	Duration(int newyears, int newmonths, int days, int hours, int minutes, int seconds, double partseconds, bool bnegative)	Initialise une nouvelle instance de la classe Duration dans une durée construite depuis des parties fournies en tant qu’argument.

Propriétés

	Nom	Description
	int Months	Obtient ou définit le nombre des mois dans l’instance actuelle de Duration.
	System.TimeSpan Value	Obtient ou définit la valeur (en tant que System.TimeSpan) de l’instance actuelle de Duration.
	int Years	Retourne le nombre des années dans l’instance actuelle de Duration.

Méthodes

Nom

Description

ic_method

override bool Equals(object other)

Retourne true si l’objet spécifié est égal à l’objet actuel ; false sinon.

ic_method

override int GetHashCode()

Retourne le code hash de l’instance actuelle.

ic_method

bool IsNegative()

Retourne true si l’instance actuelle de Duration représente une durée négative.

ic_method

static Duration Parse( string s, ParseType pt )

Retourne un objet Altova.Types.Duration parsé depuis le string fourni en tant qu’argument, en utilisant le type de parsage fourni en tant qu’argument. Valeurs de type de parsage valides :

DURATION	Parse la durée en partant du principe que la partie de l’année, du mois, du jour et de la durée de temps existe.
YEARMONTH	Parse la durée en partant du principe que seules les parties d’année et de mois existent.
DAYTIME	Parse la durée en partant du principe que la partie du jour et d’heure existent.

Veuillez noter que cette méthode est statique et peut uniquement être appelée dans la classe elle-même, pas dans une instance de la classe.

ic_method

override string ToString()

Convertit l’instance actuelle Duration en un string. Par exemple, une durée de 3 heures, 4 minutes et 5 secondes peut être convertie en "PT3H4M5S".

ic_method

string ToYearMonthString()

Convertit l’instance actuelle Duration en un string, en utilisant le type de parsage "Year and Month".

Opérateurs

Nom	Description
!=	Détermine si Duration a n’est pas égal à Duration b.
==	Détermine si Duration a est égal à Duration b.

Exemples

Avant d’utiliser les extraits de code suivants dans votre programme, s’assurer que les types Altova sont importés :

using Altova.Types;

L’extrait de code suivant illustre plusieurs moyens de créer des objets Duration :

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());
}

L’extrait de code suivant illustre comment obtenir des valeurs depuis des objets Duration :

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);
}